home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd2.bin / bbs / gnu / readme-first < prev    next >
Text File  |  1994-11-28  |  9KB  |  282 lines
  1.  
  2.               G N U    D I S T R I B U T I O N
  3.  
  4.                  (updated 11/28/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-40.4-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-40.4-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    This    Latest
  136.     Name        CD-ROM    Base    Status
  137.     ------------    ------    ------    -----------------
  138.  
  139.     APlusPlus    1.01    1.01    n/a    --
  140.     autoconf    2.1    2.1    Updated
  141.     bash        1.13.4    1.13.4    Port incomplete
  142.     bc        1.02    1.02    --
  143.     binutils    1.8.x    2.5.2    --
  144.     bison        1.22    1.22    --
  145.     calc        *    2.02b    No port integrated yet
  146.     cpio        2.3    2.3    --
  147.     cvs        *    1.3    No port integrated yet
  148.     dc        0.2    0.2    --
  149.     dejagnu        *    1.1.1    No port integrated yet
  150.     diffutils    2.7    2.7    Updated
  151.     doschk        1.1    1.1    --
  152.     ed        0.1    0.1    --
  153.     elvis        *    1.7    No port integrated yet
  154.     emacs        18.59    19.22    --
  155.     f2c        930428    930428    --
  156.     fileutils    3.12    3.12    Updated
  157.     findutils    4.1    4.1    Updated
  158.     finger        *    1.37    No port integrated yet
  159.     flex        2.4.7    2.4.7    Updated
  160.     fontutils    *    0.6    No port integrated yet
  161.     gas        2.5.2    2.5.2    Updated
  162.     gawk        2.15.5    2.15.5    --
  163.     gcc        2.6.2    2.6.2    Updated
  164.     gdb        4.12    4.13    Port incomplete
  165.     gdbm        1.7.3    1.7.3    --
  166.     ghostscript    2.6.1    2.6.1    --
  167.     ghostview    *    1.5    No port integrated yet
  168.     glibc        *    1.06    No port integrated yet
  169.     gmp        1.3.2    1.3.2    --
  170.     gnat        1.80    1.84    --
  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.     less        *    177    No port integrated yet
  179.     libg++        2.6.1    2.6.1    Updated
  180.     libnix        ?    ?    --
  181.     m4        1.4    1.4    Updated
  182.     make        3.72.1    3.72.1    Updated
  183.     mm        *    1.07    No port integrated yet
  184.     mtools        *    2.0.7    No port integrated yet
  185.     nethack        *    3.1.3    No port integrated yet
  186.     oleo        *    1.3.1b    No port integrated yet
  187.     patch        2.1    2.1    --
  188.     pdksh        4.9    n/a    --
  189.     perl        4.036    5.000    --
  190.     rcs        5.6.0.1    5.6.0.1    --
  191.     readline    *    1.1    No port integrated yet
  192.     recode        *    3.2.4    No port integrated yet
  193.     regex        *    0.12    No port integrated yet
  194.     sed        2.05    2.05    --
  195.     sh-utils    1.12    1.12    Updated
  196.     tar        1.11.2    1.11.2    --
  197.     termcap        1.2    1.2    --
  198.     texinfo        3.1    3.1    --
  199.     textutils    1.11    1.11    Updated
  200.     time        *    1.6    No port integrated yet
  201.     tput        *    1.0    No port integrated yet
  202.     uucp        *    1.04    No port integrated yet
  203.     uuencode    1.0    1.0    --
  204.     wdiff        *    0.04    No port integrated yet
  205.  
  206. ---
  207. GCC
  208. ---
  209.  
  210. To use gcc, you need the following archives, depending upon which version(s)
  211. you want to use:
  212.  
  213.     gcc-2.3.3-bin.lha
  214.     gcc-2.6.2-bin.lha
  215.     ixemul-40.4-bin.lha        (always needed, for now)
  216.     ixemul-40.4-env-bin.lha        (always needed, for now)
  217.  
  218. If you intend to do AmigaDOS specific programs (calls to AmigaDOS specific
  219. functions), you need the following from the BBS/CBM directory:
  220.  
  221.     os-include-bin.lha
  222.     os-lib-bin.lha
  223.  
  224. Depending upon what you intend to compile, you may need one or more of the
  225. following archives, for the indicated link libraries:
  226.     
  227.     f2c-1993.04.28-bin.lha    lib/libF77.a    
  228.                 lib/libI77.a
  229.  
  230.     flex-2.4.7-bin.lha    lib/libfl.a
  231.                 lib/libb/libfl.a
  232.  
  233.     gdbm-1.7.3-bin.lha    lib/libgdbm.a
  234.                 lib/libb/libgdbm.a
  235.  
  236.     gmp-1.3.2-bin.lha    lib/libgmp.a
  237.                 lib/libmp.a
  238.                 lib/libb/libgmp.a
  239.                 lib/libb/libmp.a
  240.  
  241.     libg++-2.6.1-bin.lha    lib/libg++.a
  242.                 lib/libiberty.a
  243.                 lib/libiostream.a
  244.                 lib/libb/libg++.a
  245.                 lib/libb/libiberty.a
  246.                 lib/libb/libiostream.a
  247.  
  248.     libm-5.4-bin.lha    lib/libm.a
  249.  
  250.     os-lib.lha        os-lib/libamiga.a
  251.                 os-lib/libb/libamiga.a
  252.                 os-lib/libddebug.a
  253.                 os-lib/libdebug.a
  254.                 os-lib/libsmall.a
  255.  
  256.     termcap-1.2-bin.lha    lib/libb/libtermcap.a
  257.                 lib/libtermcap.a
  258.     
  259.     
  260. -----------------------
  261. STACK SIZE - IMPORTANT!
  262. -----------------------
  263.  
  264. Some of the GNU utilities, gcc in particular, require a very large stack.
  265. You need to arrange that the CLI/Shell or whatever you run these programs
  266. from has a large stack set.  In a CLI you can set this with a command of the
  267. form "stack 100000" (300000 is what I use).  You can also put this command
  268. in your S:Shell-Startup file to get large stacks for all CLI/Shell startups,
  269. without having to remember to manually set the stack each time.  Really huge
  270. compiles, like recompiling the compiler itself, may require even more stack
  271. space (like 300Kb or more).
  272.  
  273. -----
  274. PDKSH
  275. -----
  276.  
  277. It's strongly recommended that if you intend to do much work with the GNU
  278. tools, that you get the pdksh archive (pdksh-4.9-bin.lha).  It is certainly
  279. required if you expect to configure or build any of the tools from source.
  280. It is not GNU code, but because of it's importance in the overall GNU
  281. environment on the Amiga, it is included here for convenience.
  282.