home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / gnu / readme-first < prev    next >
Encoding:
Text File  |  1995-04-14  |  8.3 KB  |  284 lines
  1.  
  2.               G N U    D I S T R I B U T I O N
  3.  
  4.                  (Updated 4/15/95)
  5.  
  6. ========
  7. OVERVIEW
  8. ========
  9.  
  10. This directory contains various archives that taken together, comprise the
  11. complete GNU distribution tree that can be found on my FreshFish CD-ROM's,
  12. in ready to run format.  This includes both binaries and source code, per
  13. the terms of the GPL (see the files COPYING and COPYING.LIB).
  14.  
  15. ================
  16. GNU INSTALLATION
  17. ================
  18.  
  19. I suggest that you make a directory somewhere called "GNU", that will be the
  20. root directory of the entire GNU environment, and then simply unpack all the
  21. *-bin.lha archives in that directory.
  22.  
  23. If you expect to run the compiler, you will also need the contents of the
  24. archives "os-include-bin.lha" and "os-lib-bin.lha" from the BBS/CBM
  25. directory, where they are isolated because they contain, or are derived
  26. from, CBM proprietary files, and are distributed under license from
  27. Commodore.  See the files in that directory for details of the distribution
  28. restrictions.
  29.  
  30. Once you have unpacked all the archives, edit an appropriate system startup
  31. script (S:User-Startup for example), to have it assign GNU: to this GNU
  32. directory and have it run the startup script in GNU:Sys/S/GNU-Startup.  An
  33. example of the appropriate lines to add to your User-Startup file would be:
  34.  
  35.     assign GNU: WORK:GNU
  36.     execute GNU:Sys/S/GNU-Startup
  37.  
  38. That's all there is to it, except for not forgetting to set an adequate
  39. amount of stack space.  See the comments below.
  40.  
  41. ========
  42. ARCHIVES
  43. ========
  44.  
  45. For each supplied utility, you will find four archives, as follows:
  46.  
  47.     <name-version>-bin.lha    Amiga binaries and other "runtime" files.
  48.  
  49.     <name-version>-src.lha    Amiga source files that were used to
  50.                 generate the supplied binaries.
  51.  
  52.     <name-version>-diffs.lha    The diffs that apply to the baseline
  53.                 source to generate the Amiga source.
  54.  
  55.     <name-version>.tar.gz    The baseline sources from which the Amiga
  56.                 sources were generated, by applying the
  57.                 diffs for this utility.
  58.  
  59. If you only intend to use the binaries and do not need source, and do not
  60. redistribute the binary archives or otherwise make them available via BBS or
  61. ftp, you do not need to get the corresponding source archives.  If you do
  62. redistribute them you probably need the source archives as well.  Please be
  63. sure to read and understand the conditions in the COPYING and COPYING.LIB
  64. files with regards to redistribution if you are unsure about this detail.
  65.                     
  66. ==============
  67. IXEMUL.LIBRARY
  68. ==============
  69.  
  70. All of the binaries supplied here require the ixemul.library to run.  If you
  71. get any of the *-bin.lha archives, you should also get the archive
  72. "ixemul-XX.XX-bin.lha", which contains just the libraries and a couple of
  73. auxiliary control programs.  If you expect to use gcc for development and
  74. use the standard ixemul.library environment, you also need the archive
  75. "ixemul-XX.XX-env-bin.lha".
  76.  
  77. ===================
  78. DIRECTORY STRUCTURE
  79. ===================
  80.  
  81. As you extract the contents of the lha archives, the following directory
  82. structure will be created and populated with files from the various
  83. archives:
  84.  
  85.     amigados    Used by gcc.
  86.  
  87.     bin        Where the GNU executables go.
  88.             Like "/usr/local/bin" on UNIX.
  89.  
  90.     etc        Miscellaneous support files.
  91.             Like "/usr/local/etc" on UNIX.
  92.  
  93.     guide        AmigaGuide versions of info files.
  94.  
  95.     include        Include files used by gcc.
  96.             Like "/usr/include" or "/usr/local/include".
  97.  
  98.     info        Info files.
  99.             Like "/usr/local/info" on UNIX.
  100.  
  101.     lib        Libraries used by gcc and other tools.
  102.             Like "/usr/local/lib" on UNIX.
  103.  
  104.     libs        Runtime libs, add to "LIBS:" assign.
  105.             Somewhat like "/lib" on UNIX.
  106.  
  107.     man        Manual pages.
  108.             Like "/usr/local/man" on UNIX.
  109.  
  110.     os-include    System specific include files.  These are
  111.             Commodore proprietary and are distributed 
  112.             under license from Commodore.
  113.  
  114.     os-lib        System specific library files.  These are
  115.             derived from Commodore proprietary libraries
  116.             and are distributed under license from Commodore.
  117.  
  118.     src        All the source code, including the original 
  119.             source distributions, patches to the source
  120.             distributions, and the fully patched AmigaDOS
  121.             sources.
  122.  
  123. ===========
  124. PORT STATUS
  125. ===========
  126.  
  127.     Distribution    This    Latest
  128.     Name        CD-ROM    Base    Status
  129.     ------------    ------    ------    -----------------
  130.  
  131.     APlusPlus    1.01    1.01    --
  132.     autoconf    2.2    2.2    Updated
  133.     bash        1.13.4    1.14.2    Port incomplete
  134.     bc & dc        1.03    1.03    --
  135.     binutils    1.8.x    2.5.2    --
  136.     binutils    2.5.2    2.5.2    Partial port
  137.     bison        1.22    1.22    --
  138.     brik        2.0    2.0    --
  139.     calc        2.02c    2.02c    --
  140.     cpio        2.3    2.3    --
  141.     cvs        *    1.3    No port integrated yet
  142.     dbmalloc    1.14    1.14    --
  143.     dbug        2.3    2.3    --
  144.     dejagnu        *    1.1.1    No port integrated yet
  145.     diffutils    2.7    2.7    --
  146.     doschk        1.1    1.1    --
  147.     dumphunks    1.0    1.0    Added
  148.     ecc        1.2.1    1.2.1    Added
  149.     ed        0.1    0.2    --
  150.     eispack        1.0    1.0    Added
  151.     elvis        *    1.7    No port integrated yet
  152.     emacs        18.59    19.28    --
  153.     emacs        19.28    19.28    Partial port
  154.     f2c        930428    930428    --
  155.     fileutils    3.12    3.12    --
  156.     findutils    4.1    4.1    --
  157.     finger        *    1.37    No port integrated yet
  158.     flex        2.4.7    2.4.7    --
  159.     fontutils    0.6    0.6    Added
  160.     g77        0.5.13    0.5.13    Added
  161.     gawk        2.15.6    2.15.6    Updated
  162.     gcc        2.6.3    2.6.3    --
  163.     gdb        4.14    4.14    Updated; port incomplete
  164.     gdbm        1.7.3    1.7.3    --
  165.     ghostscript    2.6.1    2.6.1    --
  166.     ghostview    *    1.5    No port integrated yet
  167.     git        4.3.5    4.3.5    No port integrated yet
  168.     glibc        *    1.06    No port integrated yet
  169.     gmp        1.3.2    1.3.2    --
  170.     gnat        2.00    2.03    Updated
  171.     gnuchess    *    4.0.62    No port integrated yet
  172.     gnugo        *    1.1    No port integrated yet
  173.     grep        2.0    2.0    --
  174.     groff        1.09    1.09    --
  175.     gzip        1.2.4    1.2.4    --
  176.     indent        1.9.1    1.9.1    --
  177.     ispell        4.0    4.0    --
  178.     ixemul        40.4    40.4    --
  179.     ixpipe        1.0    1.0    --
  180.     jove        4.14.6    4.14.6    --
  181.     less        252    252    --
  182.     libcurses    8.3    8.3    --
  183.     libg++        2.6.2    2.6.2    --
  184.     libm        5.4    5.4    --
  185.     libnix        0.8    0.8    Updated
  186.     m4        1.4    1.4    --
  187.     make        3.71    3.72.1    --
  188.     mm        *    1.07    No port integrated yet
  189.     mtools        *    2.0.7    No port integrated yet
  190.     nethack        *    3.1.3    No port integrated yet
  191.     octave        1.1.1    1.1.1    Added
  192.     oleo        *    1.3.1b    No port integrated yet
  193.     patch        2.1    2.1    --
  194.     pdksh        4.9    5.1.3    --
  195.     perl        4.036    5.000    --
  196.     rcs        5.6.0.1    5.6.0.1    --
  197.     readline    *    1.1    No port integrated yet
  198.     recode        *    3.2.4    No port integrated yet
  199.     regex        *    0.12    No port integrated yet
  200.     sed        2.05    2.05    --
  201.     sh-utils    1.12    1.12    --
  202.     sharutils    4.1    4.1    --
  203.     tar        1.11.2    1.11.2    --
  204.     termcap        1.2    1.2    --
  205.     texinfo        3.1    3.1    --
  206.     textutils    1.11    1.11    --
  207.     time        *    1.6    No port integrated yet
  208.     tput        *    1.0    No port integrated yet
  209.     unixtex        6.1    6.1    Added
  210.     uucp        *    1.04    No port integrated yet
  211.     wdiff        0.5    0.5    Added
  212.  
  213.  
  214. ===
  215. GCC
  216. ===
  217.  
  218. To use gcc, you need the following archives, depending upon which version(s)
  219. you want to use:
  220.  
  221.     gcc-2.3.3-bin.lha
  222.     gcc-2.6.3-bin.lha
  223.     ixemul-40.4-bin.lha        (always needed, for now)
  224.     ixemul-40.4-env-bin.lha        (always needed, for now)
  225.  
  226. If you intend to do AmigaDOS specific programs (calls to AmigaDOS specific
  227. functions), you need the following from the BBS/CBM directory:
  228.  
  229.     os-include-bin.lha
  230.     os-lib-bin.lha
  231.  
  232. Depending upon what you intend to compile, you may need one or more of the
  233. following archives, for the indicated link libraries:
  234.     
  235.     f2c-930428-bin.lha    lib/libF77.a    
  236.                 lib/libI77.a
  237.  
  238.     flex-X.X.X-bin.lha    lib/libfl.a
  239.                 lib/libb/libfl.a
  240.  
  241.     gdbm-X.X.X-bin.lha    lib/libgdbm.a
  242.                 lib/libb/libgdbm.a
  243.  
  244.     gmp-X.X.X-bin.lha    lib/libgmp.a
  245.                 lib/libmp.a
  246.                 lib/libb/libgmp.a
  247.                 lib/libb/libmp.a
  248.  
  249.     libg++-X.X.X-bin.lha    lib/libg++.a
  250.                 lib/libiberty.a
  251.                 lib/libiostream.a
  252.                 lib/libb/libg++.a
  253.                 lib/libb/libiberty.a
  254.                 lib/libb/libiostream.a
  255.  
  256.     libm-X.X-bin.lha    lib/libm.a
  257.  
  258.     termcap-X.X-bin.lha    lib/libb/libtermcap.a
  259.                 lib/libtermcap.a
  260.     
  261.     
  262. =======================
  263. STACK SIZE - IMPORTANT!
  264. =======================
  265.  
  266. Some of the GNU utilities, gcc in particular, require a very large stack.
  267. You need to arrange that the CLI/Shell or whatever you run these programs
  268. from has a large stack set.  In a CLI you can set this with a command of the
  269. form "stack 100000" (300000 is what I use).  You can also put this command
  270. in your S:Shell-Startup file to get large stacks for all CLI/Shell startups,
  271. without having to remember to manually set the stack each time.  Really huge
  272. compiles, like recompiling the compiler itself, may require even more stack
  273. space (like 300Kb or more).
  274.  
  275. =====
  276. PDKSH
  277. =====
  278.  
  279. It's strongly recommended that if you intend to do much work with the GNU
  280. tools, that you get the pdksh archive (pdksh-4.9-bin.lha).  It is certainly
  281. required if you expect to configure or build any of the tools from source.
  282. It is not GNU code, but because of it's importance in the overall GNU
  283. environment on the Amiga, it is included here for convenience.
  284.