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