home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 3 / freshfish3_9403.bin / gnu / readme < prev    next >
Text File  |  1994-02-27  |  6KB  |  164 lines
  1. This is the root directory of the GNU utilities included on this CD-ROM.
  2. Important subdirectories are:
  3.  
  4.     amigados    ?
  5.  
  6.     bin        Where the GNU executables go.
  7.  
  8.     etc        Equivalent to /etc on UNIX.
  9.  
  10.     include        Include files used by gcc.
  11.  
  12.     info        Info files.
  13.  
  14.     lib        Libraries used by gcc.
  15.  
  16.     man        Manual pages.
  17.  
  18.     os-include    System specific include files.  These are
  19.             Commodore proprietary and are distributed 
  20.             under license from Commodore.
  21.  
  22.     os-lib        System specific library files.  These are
  23.             derived from Commodore proprietary libraries
  24.             and are distributed under license from Commodore.
  25.  
  26.     src        All the source code, including the original 
  27.             FSF distributions, patches to the FSF distributions,
  28.             and the fully patched AmigaDOS sources.
  29.  
  30.  
  31. *** General Status
  32.  
  33.     GNU        Prev    This    Latest
  34.     Distribution    CD-ROM    CD-ROM    FSF    Status
  35.     ------------    ------    ------    ------    -----------------
  36.  
  37.     autoconf    *    *    1.7    No port integrated yet
  38.     bash        1.13.4    1.13.4    1.13.4    Port incomplete
  39.     bc        1.02    1.02    1.02    No change
  40.     binutils    1.8.x    1.8.x    2.3    No change
  41.     bison        1.22    1.22    1.22    No change
  42.     calc        *    *    2.02b    No port integrated yet
  43.     cpio        2.3    2.3    2.3    No change
  44.     cvs        *    *    1.3    No port integrated yet
  45.     dc        0.2    0.2    0.2    No change
  46.     dejagnu        *    *    1.1.1    No port integrated yet
  47.     diffutils    2.6    2.6    2.6    No change
  48.     doschk        1.1    1.1    1.1    No change
  49.     elvis        *    *    1.7    No port integrated yet
  50.     emacs        18.59    18.59    19.22    No change
  51.     f2c        *    930428    930428    Added
  52.     fileutils    3.9    3.9    3.9    No change
  53.     find        3.8    3.8    3.8    No change
  54.     finger        *    *    1.37    No port integrated yet
  55.     flex        2.4.5    2.4.6    2.4.6    Updated
  56.     fontutils    *    *    0.6    No port integrated yet
  57.     gas        1.38    1.38    2.2    No change
  58.     gawk        2.15.3    2.15.4    2.15.4    Updated
  59.     gcc        2.5.7    2.5.8    2.5.8    Updated
  60.     gdb        *    4.12    4.12    Added - Port incomplete
  61.     gdbm        1.7.1    1.7.1    1.7.1    No change
  62.     ghostscript    *    2.6.1    2.6.1    Added
  63.     ghostview    *    *    1.5    No port integrated yet
  64.     glibc        *    *    1.06    No port integrated yet
  65.     gmp        1.3.2    1.3.2    1.3.2    No change
  66.     gnuchess    *    *    4.0.62    No port integrated yet
  67.     gnugo        *    *    1.1    No port integrated yet
  68.     grep        2.0    2.0    2.0    No change
  69.     groff        1.08    1.09    1.09    Updated
  70.     gzip        1.2.4    1.2.4    1.2.4    No change
  71.     indent        1.8    1.9.1    1.9.1    Updated
  72.     ispell        4.0    4.0    4.0    No change
  73.     less        *    *    177    No port integrated yet
  74.     libg++        2.5.2    2.5.3    2.5.3    Updated
  75.     m4        1.1    1.1    1.1    No change
  76.     make        3.69    3.70    3.70    Updated
  77.     mm        *    *    1.07    No port integrated yet
  78.     mtools        *    *    2.0.7    No port integrated yet
  79.     nethack        *    *    3.1.3    No port integrated yet
  80.     oleo        *    *    1.3.1b    No port integrated yet
  81.     patch        2.1    2.1    2.1    No change
  82.     perl        4.036    4.036    4.036    No change (not working)
  83.     rcs        5.6.0.1    5.6.0.1    5.6.0.1    No change
  84.     readline    *    *    1.1    No port integrated yet
  85.     recode        *    *    3.2.4    No port integrated yet
  86.     regex        *    *    0.12    No port integrated yet
  87.     sed        2.03    2.03    2.03    No change
  88.     shellutils    1.9.2    1.9.4    1.9.4    Updated
  89.     tar        1.11.2    1.11.2    1.11.2    No change
  90.     termcap        1.2    1.2    1.2    No change
  91.     texinfo        3.1    3.1    3.1    No change
  92.     textutils    1.9    1.9    1.9    No change
  93.     time        *    *    1.6    No port integrated yet
  94.     tput        *    *    1.0    No port integrated yet
  95.     uucp        *    *    1.04    No port integrated yet
  96.     uuencode    1.0    1.0    1.0    No change
  97.     wdiff        *    *    0.04    No port integrated yet
  98.  
  99. *** gcc
  100.  
  101.     All the versions of gcc look for local header files in LOCAL:include
  102.     and LOCAL:os-include, and look for local library files in LOCAL:lib
  103.     and LOCAL:os-lib.  This allows you to add local packages that will
  104.     be found automatically by gcc, in a location that is writable by
  105.     you.  Simply reassign LOCAL: to point to the correct location.
  106.  
  107.     Gcc now automatically includes -lamiga in the command line to the
  108.     linker, so you can use AmigaDOS specific calls in your code without
  109.     having to remember to link with libamiga.a.
  110.  
  111.     As of this date, all releases of gcc since 2.3.3 have had broken
  112.     support for the -resident option.  This is one reason why gcc 2.3.3
  113.     is still included on the CD-ROM.  To demonstrate the problem, try
  114.     to bootstrap using "make bootstrap RESIDENT=-resident".
  115.  
  116. *** ld
  117.  
  118.     A new option "-f" or "-flavor" is used to inform the linker to look
  119.     in additional subdirectories for particular "flavors" of libraries,
  120.     like libraries compiled with -fresident, libraries compiled with
  121.     -g, libraries compiled with -p, etc.  All the flavor args are
  122.     collected in a list, sorted, and then used to create additional
  123.     sudirectories at the end of the standard library search paths.
  124.  
  125.     For example, given the args
  126.  
  127.         "-L mystuff:lib -flavor libx -flavor libb -lmylib"
  128.  
  129.     the linker will search for libmylib.a in "mystuff:lib/libb/libx/".
  130.  
  131.     In particular, this is the mechanism that is now used to locate
  132.     the base relative libraries, which have moved from gcc:blib to
  133.     gcc:lib/libb.  Eventually there will be other standard flavors
  134.     of libraries, like -p compiled and -g compiled libraries, in
  135.     a subtree like:
  136.  
  137.         gcc:lib/libb/libc.a        -resident
  138.         gcc:lib/libb/libg/libc.a    -resident -g
  139.         gcc:lib/libb/libg/libp/libc.a    -resident -g -p
  140.         gcc:lib/libp/libc.a        -p
  141.         gcc:lib/libg/libp/libc.a    -g -p
  142.  
  143.         etc.
  144.  
  145. *** gdb
  146.  
  147.     GDB 4.12 has been ported to the extent that you can build
  148.     an AmigaDOS executable that knows how to load and examine
  149.     executables from non-AmigaDOS systems.  Much work remains.
  150.     See the gnu:src/diffs/gdb-4.12-README file.
  151.  
  152. *** IMPORTANT ***
  153.  
  154.     Some of the GNU utilities, gcc in particular, require a
  155.     very large stack.  You need to arrange that the CLI/Shell
  156.     or whatever you run these programs from has a large stack
  157.     set.  In a CLI you can set this with a command of the
  158.     form "stack 100000" (100000 is what I use).  You can also
  159.     put this command in your S:Shell-Startup file to get large
  160.     stacks for all CLI/Shell startups, without having to 
  161.     remember to manually set the stack each time.  Really huge
  162.     compiles, like recompiling the compiler itself, may require
  163.     even more stack space (like 300Kb or more).
  164.