home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / gnu / readme-first < prev    next >
Text File  |  1995-01-26  |  9KB  |  284 lines
  1.  
  2.               G N U    D I S T R I B U T I O N
  3.  
  4.                  (Updated 1/26/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.1    2.1    Updated
  133.     bash        1.13.4    1.14.2    Port incomplete
  134.     bc        1.03    1.03    Updated
  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    Added
  139.     calc        2.02c    2.02c    Added
  140.     cpio        2.3    2.3    --
  141.     cvs        *    1.3    No port integrated yet
  142.     dbmalloc    1.14    1.14    Added
  143.     dbug        2.3    2.3    Added
  144.     dc        0.2    0.2    --
  145.     dejagnu        *    1.1.1    No port integrated yet
  146.     diffutils    2.7    2.7    Updated
  147.     doschk        1.1    1.1    --
  148.     ed        0.1    0.2    --
  149.     elvis        *    1.7    No port integrated yet
  150.     emacs        18.59    19.28    --
  151.     emacs        19.28    19.28    Partial port
  152.     f2c        930428    930428    --
  153.     fileutils    3.12    3.12    Updated
  154.     findutils    4.1    4.1    Updated
  155.     finger        *    1.37    No port integrated yet
  156.     flex        2.4.7    2.4.7    Updated
  157.     fontutils    *    0.6    No port integrated yet
  158.     gas        2.5.2    2.5.2    Updated
  159.     gawk        2.15.5    2.15.5    --
  160.     gcc        2.6.3    2.6.3    Updated
  161.     gdb        4.12    4.13    Port incomplete
  162.     gdbm        1.7.3    1.7.3    --
  163.     ghostscript    2.6.1    2.6.1    --
  164.     ghostview    *    1.5    No port integrated yet
  165.     glibc        *    1.06    No port integrated yet
  166.     gmp        1.3.2    1.3.2    --
  167.     gnat        2.00    2.00    Updated
  168.     gnuchess    *    4.0.62    No port integrated yet
  169.     gnugo        *    1.1    No port integrated yet
  170.     grep        2.0    2.0    --
  171.     groff        1.09    1.09    --
  172.     gzip        1.2.4    1.2.4    --
  173.     indent        1.9.1    1.9.1    --
  174.     ispell        4.0    4.0    --
  175.     ixemul        40.4    40.4    Updated
  176.     ixpipe        1.0    1.0    --
  177.     jove        4.14.6    4.14.6    Added
  178.     less        252    252    Added
  179.     libcurses    8.3    8.3    Added
  180.     libg++        2.6.2    2.6.2    Updated
  181.     libm        5.4    5.4    --
  182.     libnix        0.7    0.7    Updated
  183.     m4        1.4    1.4    Updated
  184.     make        3.71    3.72.1    --
  185.     mm        *    1.07    No port integrated yet
  186.     mtools        *    2.0.7    No port integrated yet
  187.     nethack        *    3.1.3    No port integrated yet
  188.     oleo        *    1.3.1b    No port integrated yet
  189.     patch        2.1    2.1    --
  190.     pdksh        4.9    n/a    --
  191.     perl        4.036    5.000    --
  192.     rcs        5.6.0.1    5.6.0.1    --
  193.     readline    *    1.1    No port integrated yet
  194.     recode        *    3.2.4    No port integrated yet
  195.     regex        *    0.12    No port integrated yet
  196.     sed        2.05    2.05    --
  197.     sh-utils    1.12    1.12    Updated
  198.     sharutils    4.1    4.1    Added
  199.     tar        1.11.2    1.11.2    --
  200.     termcap        1.2    1.2    --
  201.     texinfo        3.1    3.1    --
  202.     textutils    1.11    1.11    Updated
  203.     time        *    1.6    No port integrated yet
  204.     tput        *    1.0    No port integrated yet
  205.     uucp        *    1.04    No port integrated yet
  206.     wdiff        *    0.04    No port integrated yet
  207.  
  208. ===
  209. GCC
  210. ===
  211.  
  212. To use gcc, you need the following archives, depending upon which version(s)
  213. you want to use:
  214.  
  215.     gcc-2.3.3-bin.lha
  216.     gcc-2.6.3-bin.lha
  217.     ixemul-40.4-bin.lha        (always needed, for now)
  218.     ixemul-40.4-env-bin.lha        (always needed, for now)
  219.  
  220. If you intend to do AmigaDOS specific programs (calls to AmigaDOS specific
  221. functions), you need the following from the BBS/CBM directory:
  222.  
  223.     os-include-bin.lha
  224.     os-lib-bin.lha
  225.  
  226. Depending upon what you intend to compile, you may need one or more of the
  227. following archives, for the indicated link libraries:
  228.     
  229.     f2c-930428-bin.lha    lib/libF77.a    
  230.                 lib/libI77.a
  231.  
  232.     flex-X.X.X-bin.lha    lib/libfl.a
  233.                 lib/libb/libfl.a
  234.  
  235.     gdbm-X.X.X-bin.lha    lib/libgdbm.a
  236.                 lib/libb/libgdbm.a
  237.  
  238.     gmp-X.X.X-bin.lha    lib/libgmp.a
  239.                 lib/libmp.a
  240.                 lib/libb/libgmp.a
  241.                 lib/libb/libmp.a
  242.  
  243.     libg++-X.X.X-bin.lha    lib/libg++.a
  244.                 lib/libiberty.a
  245.                 lib/libiostream.a
  246.                 lib/libb/libg++.a
  247.                 lib/libb/libiberty.a
  248.                 lib/libb/libiostream.a
  249.  
  250.     libm-X.X-bin.lha    lib/libm.a
  251.  
  252.     os-lib.lha        os-lib/libamiga.a
  253.                 os-lib/libb/libamiga.a
  254.                 os-lib/libddebug.a
  255.                 os-lib/libdebug.a
  256.                 os-lib/libsmall.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'