home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / readme-first < prev    next >
Text File  |  1994-03-29  |  9KB  |  274 lines
  1.  
  2.              G N U    D I S T R I B U T I O N
  3.  
  4.                  (updated 3/29/94)
  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. If you make a directory somewhere called GNU, cd into that directory, and
  16. then extract the contents of all of the lha archives relative to that
  17. directory, you will end up with a file tree that except for a few icons on
  18. some directories and some other insignificant differences, is identical to
  19. that on my Mar/Apr FreshFish CD-ROM.
  20.  
  21. ----------------
  22. GNU INSTALLATION
  23. ----------------
  24.  
  25. I suggest that you make a directory somewhere called "GNU", that will be
  26. the root directory of the entire GNU environment, and then simply unpack
  27. all the lha archives in that directory.  If you only want a binary
  28. installation, just unpack the *-bin.lha archives and the GNU-Startup.lha
  29. archive.
  30.  
  31. If you expect to run the compiler, you will also need the contents of the
  32. archives "os-include.lha" and "os-lib.lha" from the BBS/CBM directory,
  33. where they are isolated because they contain, or are derived from, CBM
  34. proprietary files, and are distributed under license from Commodore.  See
  35. the files in that directory for details of the distribution restrictions.
  36.  
  37. Once you have unpacked all the archives, edit the startup script in
  38. Sys/S/GNU-Startup to set the correct root directory to which GNU: is to be
  39. assigned.  The add a line in your S:User-Startup file to execute this
  40. script, like:
  41.  
  42.     execute Work:GNU/S/GNU-Startup
  43.  
  44. That's all there is to it, except for not forgetting to set an adequate
  45. amount of stack space.  See the comments below.
  46.  
  47. --------
  48. ARCHIVES
  49. --------
  50.  
  51. For each supplied GNU utility, you will find three archives, as follows:
  52.  
  53.     <name-version>-bin.lha    The binary and other "runtime" files.
  54.  
  55.     <name-version>-src.lha    The source files that were used to generate
  56.                 the supplied binaries, and the diffs that
  57.                 apply to the generic FSF source to generate
  58.                 this source.
  59.  
  60.     <name-version>.tar.gz    The original FSF archives in gzip'd tar
  61.                 format.  These belong in the "src/fsf"
  62.                 directory.
  63.  
  64. If you only intend to use the binaries and do not need source, and do not
  65. redistribute the binary archives or otherwise make them available via BBS
  66. or ftp, you do not need to get the corresponding source archives.  If you
  67. do redistribute them you probably need the source archives as well.  Please
  68. be sure to read and understand the conditions in the COPYING and
  69. COPYING.LIB files with regards to redistribution if you are unsure about
  70. this detail.
  71.                     
  72. --------------
  73. IXEMUL.LIBRARY
  74. --------------
  75.  
  76. All of the binaries supplied here require the ixemul.library to run.  If
  77. you get any of the *-bin.lha archives, you should also get the archive
  78. "ixemul-39.47-bin.lha", which contains just the libraries and a couple of
  79. auxiliary control programs.  If you expect to use gcc for development and
  80. use the standard ixemul.library environment, you also need the archive
  81. "ixemul-39.47-env-bin.lha".
  82.  
  83. -------------------
  84. DIRECTORY STRUCTURE
  85. -------------------
  86.  
  87. As you extract the contents of the lha archives, the following directory
  88. structure will be created and populated with files from the various
  89. archives:
  90.  
  91.     amigados    Used by gcc.
  92.  
  93.     bin        Where the GNU executables go.
  94.             Like "/usr/local/bin" on UNIX.
  95.  
  96.     etc        Miscellaneous support files.
  97.             Like "/usr/local/etc" on UNIX.
  98.  
  99.     guide        AmigaGuide versions of info files.
  100.  
  101.     include        Include files used by gcc.
  102.             Like "/usr/include" or "/usr/local/include".
  103.  
  104.     info        Info files.
  105.             Like "/usr/local/info" on UNIX.
  106.  
  107.     lib        Libraries used by gcc and other tools.
  108.             Like "/usr/local/lib" on UNIX.
  109.  
  110.     libs        Runtime libs, add to "LIBS:" assign.
  111.             Somewhat like "/lib" on UNIX.
  112.  
  113.     man        Manual pages.
  114.             Like "/usr/local/man" on UNIX.
  115.  
  116.     os-include    System specific include files.  These are
  117.             Commodore proprietary and are distributed 
  118.             under license from Commodore.
  119.  
  120.     os-lib        System specific library files.  These are
  121.             derived from Commodore proprietary libraries
  122.             and are distributed under license from Commodore.
  123.  
  124.     src        All the source code, including the original 
  125.             FSF distributions, patches to the FSF distributions,
  126.             and the fully patched AmigaDOS sources.
  127.  
  128. -----------
  129. PORT STATUS
  130. -----------
  131.  
  132.     GNU        Prev    This    Latest
  133.     Distribution    CD-ROM    CD-ROM    FSF    Status
  134.     ------------    ------    ------    ------    -----------------
  135.  
  136.     autoconf    *    *    1.7    No port integrated yet
  137.     bash        1.13.4    1.13.4    1.13.4    Port incomplete
  138.     bc        1.02    1.02    1.02    No change
  139.     binutils    1.8.x    1.8.x    2.3    No change
  140.     bison        1.22    1.22    1.22    No change
  141.     calc        *    *    2.02b    No port integrated yet
  142.     cpio        2.3    2.3    2.3    No change
  143.     cvs        *    *    1.3    No port integrated yet
  144.     dc        0.2    0.2    0.2    No change
  145.     dejagnu        *    *    1.1.1    No port integrated yet
  146.     diffutils    2.6    2.6    2.6    No change
  147.     doschk        1.1    1.1    1.1    No change
  148.     elvis        *    *    1.7    No port integrated yet
  149.     emacs        18.59    18.59    19.22    No change
  150.     f2c        *    930428    930428    Added
  151.     fileutils    3.9    3.9    3.9    No change
  152.     find        3.8    3.8    3.8    No change
  153.     finger        *    *    1.37    No port integrated yet
  154.     flex        2.4.5    2.4.6    2.4.6    Updated
  155.     fontutils    *    *    0.6    No port integrated yet
  156.     gas        1.38    1.38    2.2    No change
  157.     gawk        2.15.3    2.15.4    2.15.4    Updated
  158.     gcc        2.5.7    2.5.8    2.5.8    Updated
  159.     gdb        *    4.12    4.12    Added - Port incomplete
  160.     gdbm        1.7.1    1.7.1    1.7.1    No change
  161.     ghostscript    *    2.6.1    2.6.1    Added
  162.     ghostview    *    *    1.5    No port integrated yet
  163.     glibc        *    *    1.06    No port integrated yet
  164.     gmp        1.3.2    1.3.2    1.3.2    No change
  165.     gnuchess    *    *    4.0.62    No port integrated yet
  166.     gnugo        *    *    1.1    No port integrated yet
  167.     grep        2.0    2.0    2.0    No change
  168.     groff        1.08    1.09    1.09    Updated
  169.     gzip        1.2.4    1.2.4    1.2.4    No change
  170.     indent        1.8    1.9.1    1.9.1    Updated
  171.     ispell        4.0    4.0    4.0    No change
  172.     less        *    *    177    No port integrated yet
  173.     libg++        2.5.2    2.5.3    2.5.3    Updated
  174.     m4        1.1    1.1    1.1    No change
  175.     make        3.69    3.70    3.70    Updated
  176.     mm        *    *    1.07    No port integrated yet
  177.     mtools        *    *    2.0.7    No port integrated yet
  178.     nethack        *    *    3.1.3    No port integrated yet
  179.     oleo        *    *    1.3.1b    No port integrated yet
  180.     patch        2.1    2.1    2.1    No change
  181.     perl        4.036    4.036    4.036    No change (not working)
  182.     rcs        5.6.0.1    5.6.0.1    5.6.0.1    No change
  183.     readline    *    *    1.1    No port integrated yet
  184.     recode        *    *    3.2.4    No port integrated yet
  185.     regex        *    *    0.12    No port integrated yet
  186.     sed        2.03    2.03    2.03    No change
  187.     shellutils    1.9.2    1.9.4    1.9.4    Updated
  188.     tar        1.11.2    1.11.2    1.11.2    No change
  189.     termcap        1.2    1.2    1.2    No change
  190.     texinfo        3.1    3.1    3.1    No change
  191.     textutils    1.9    1.9    1.9    No change
  192.     time        *    *    1.6    No port integrated yet
  193.     tput        *    *    1.0    No port integrated yet
  194.     uucp        *    *    1.04    No port integrated yet
  195.     uuencode    1.0    1.0    1.0    No change
  196.     wdiff        *    *    0.04    No port integrated yet
  197.  
  198. ---
  199. GCC
  200. ---
  201.  
  202. To use gcc, you need the following archives, depending upon which version(s)
  203. you want to use:
  204.  
  205.     gcc-2.3.3-bin.lha
  206.     gcc-2.5.8-bin.lha
  207.     ixemul-39.47-bin.lha        (always needed, for now)
  208.     ixemul-39.47-env-bin.lha    (always needed, for now)
  209.  
  210. If you intend to do AmigaDOS specific programs (calls to AmigaDOS specific
  211. functions), you need the following from the BBS/CBM directory:
  212.  
  213.     os-include.lha
  214.     os-lib.lha
  215.  
  216. Depending upon what you intend to compile, you may need one or more of the
  217. following archives, for the indicated link libraries:
  218.     
  219.     f2c-930428-bin.lha    lib/libF77.a    
  220.                 lib/libI77.a
  221.  
  222.     flex-2.4.6-bin.lha    lib/libfl.a
  223.                 lib/libb/libfl.a
  224.  
  225.     gdbm-1.7.1-bin.lha    lib/libgdbm.a
  226.                 lib/libb/libgdbm.a
  227.  
  228.     gmp-1.3.2-bin.lha    lib/libgmp.a
  229.                 lib/libmp.a
  230.                 lib/libb/libgmp.a
  231.                 lib/libb/libmp.a
  232.  
  233.     libg++-2.5.3-bin.lha    lib/libg++.a
  234.                 lib/libiberty.a
  235.                 lib/libiostream.a
  236.                 lib/libb/libg++.a
  237.                 lib/libb/libiberty.a
  238.                 lib/libb/libiostream.a
  239.  
  240.     libm-bin.lha        lib/libm.a
  241.  
  242.     os-lib.lha        os-lib/libamiga.a
  243.                 os-lib/libb/libamiga.a
  244.                 os-lib/libddebug.a
  245.                 os-lib/libdebug.a
  246.                 os-lib/libsmall.a
  247.  
  248.     termcap-1.2-bin.lha    lib/libb/libtermcap.a
  249.                 lib/libtermcap.a
  250.     
  251.     
  252. -----------------------
  253. STACK SIZE - IMPORTANT!
  254. -----------------------
  255.  
  256. Some of the GNU utilities, gcc in particular, require a very large stack.
  257. You need to arrange that the CLI/Shell or whatever you run these programs
  258. from has a large stack set.  In a CLI you can set this with a command of
  259. the form "stack 100000" (300000 is what I use).  You can also put this
  260. command in your S:Shell-Startup file to get large stacks for all CLI/Shell
  261. startups, without having to remember to manually set the stack each time.
  262. Really huge compiles, like recompiling the compiler itself, may require
  263. even more stack space (like 300Kb or more).
  264.  
  265. -----
  266. PDKSH
  267. -----
  268.  
  269. It's strongly recommended that if you intend to do much work with the GNU
  270. tools, that you get the pdksh archive (pdksh-bin.lha).  It is certainly
  271. required if you expect to configure or build any of the tools from source.
  272. It is not GNU code, but because of it's importance in the overall GNU
  273. environment on the Amiga, it is included here for convenience.
  274.