home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 1 / FFMCD01.bin / readme-first < prev    next >
Text File  |  1993-11-12  |  6KB  |  145 lines
  1.  
  2.          IMPORTANT INFORMATION FOR THIS MONTHLY CD-ROM
  3.               (Updated 11-12-93)
  4.  
  5.  
  6. This file contains important information that applies to this particular
  7. CD-ROM.  For general information about the Amiga Library CD-ROM's, infor-
  8. mation about the contents of this particular CD-ROM, and other important
  9. information, read the various files in the "Information" directory.  Also
  10. be sure to read the LEGAL-NOTICE, COPYRIGHT, WARRANTY, and SHAREWARE files.
  11.  
  12. This is the second production run of the first CD-ROM in my "monthly"
  13. series.  It represents the efforts of two people working almost full time
  14. for about six weeks, as well as a couple other people working part time for
  15. a couple weeks, or about 500 person-hours effort total.  I hope the effort
  16. that went into gathering, testing, and organizing all this material shows.
  17. The first production run inadvertently included a virus on disk 919, which
  18. has been removed in this production run.  There have been a few other minor
  19. cosmetic type changes as well.
  20.  
  21. Much of the work that went into producing this CD-ROM will not need to be
  22. duplicated for the second CD-ROM, but there are still lots of things to do
  23. for the second CD-ROM that we just did not have time for on this first one,
  24. like finding and installing easy to use browsing tools to make finding
  25. things easier, CD32 support, creating more individualized icons and in
  26. general polishing up the "look and feel" of the CD-ROM, improving support
  27. for the BBS/On-line sections, etc, etc.  So it may take about another six
  28. weeks before the second CD-ROM is ready.  After that, I'm hoping that we
  29. truly can get on a monthly schedule for this CD-ROM, by building on the
  30. efforts that went into previous CD-ROM's.
  31.  
  32. This CD-ROM contains approximately 84Mb of new material, 150Mb of useful
  33. tools including gcc 2.4.5, emacs 18.59, PasTeX, etc, and 404Mb of material
  34. from old floppy distributions.  All of the source to the supplied GNU
  35. binaries is provided and I have personally built all the supplied binaries
  36. from the supplied source (except GNU emacs) using the GNU C compiler on
  37. this CD-ROM, both to verify that the compiler is solid and to verify that
  38. the binaries are in fact recreatable from the supplied source code.  For
  39. more information about the contents of the CD-ROM see the files in the
  40. "Information" directory.
  41.  
  42.  
  43. INSTALLATION
  44.  
  45. This CD-ROM contains lots of utilities that are ready to run directly
  46. off the CD-ROM.  This will be slower than running off of disk, but CD-ROM
  47. drives are improving constantly, so if you have one of the newer double
  48. or quad speed drives, this should not be too painful.  You may be able
  49. to save as much as a 100Mb of disk space by running directly off the
  50. CD-ROM.
  51.  
  52. For this first disk all of the setup necessary to run most things off the
  53. CD-ROM is for you to run the script FFMCD01:Useful/s/FFCD-Startup from
  54. your S:User-Startup file, like this:
  55.  
  56.     if exists FFMCD01:Useful/s/FFCD-Startup
  57.         echo "Running FFMCD01:Useful/s/FFCD-Startup..."
  58.         execute FFMCD01:Useful/s/FFCD-Startup
  59.     endif
  60.  
  61. If you want a more customized environment, you can look at what the
  62. FFCD-Startup script is doing and use appropriate bits and pieces in
  63. your own S:User-Startup or S:FFCD-Startup.  Future disks may have a
  64. more sophisticated method of customizing the environment to allow
  65. things to run off the CD-ROM.
  66.  
  67.                *** IMPORTANT ***
  68.  
  69.     Some of the GNU utilities, gcc in particular, require a
  70.     very large stack.  You need to arrange that the CLI/Shell
  71.     or whatever you run these programs from has a large stack
  72.     set.  In a CLI you can set this with a command of the
  73.     form "stack 100000" (100000 is what I use).  You can also
  74.     put this command in your S:Shell-Startup file to get large
  75.     stacks for all CLI/Shell startups, without having to 
  76.     remember to manually set the stack each time.  Really huge
  77.     compiles, like recompiling the compiler itself, may require
  78.     even more stack space (like 300Kb or more).
  79.  
  80.             
  81.  
  82. GNU UTILITIES
  83.  
  84.     *    This CD-ROM contains ports of various GNU utilities that are in
  85.     various stages of stability.  See Useful/dist/gnu/README for
  86.     further information.
  87.  
  88.     *    Because of various time pressures, I was unable to get as much
  89.     on this first CD-ROM as I had hoped.  In particular, because I
  90.     am very picky about adhering completely to the conditions of
  91.     the GNU Public License, I wasn't able to get as much GNU code
  92.     included as I intend to ultimately include, since tracking down
  93.     the source for the Amiga ports, rebuilding them from that source,
  94.     and testing the resulting executables, was much more time
  95.     consuming than anticipated.  Expect this portion of the CD-ROM to
  96.     continually grow each month as more GNU ports are added.
  97.  
  98.     *    I was able to include the CBM 3.0 include files and libraries
  99.     at the last minute, but because it was last minute, I wasn't
  100.     able to arrange for the libraries to be found automatically by
  101.     gcc when needed.  This will be fixed in the next release.  For
  102.     this release you have to add the following arguments to your
  103.     link command line if your program uses any Amiga library entry
  104.     points:
  105.  
  106.         -L/gcc/os-lib -lc -lamiga
  107.  
  108.     I was able to successfully compile and run a number of the
  109.     CManual examples using commands of the form:
  110.  
  111.         gcc -o example1 example1.c -L/gcc/os-lib -lc -lamiga
  112.  
  113.     The "-lc" is required so that the linker will search the 
  114.     standard C library first and then only resolve the necessary
  115.     Amiga library entry points from /gcc/os-lib/libamiga.a.
  116.     
  117.  
  118. SAS C INCOMPATIBILITY
  119.  
  120.     *    The assign of lib: used by this CD-ROM conflicts with Lattice/SAS
  121.     C, which wants to use the same assign.  I don't have a recommended
  122.     way of dealing with this conflict yet.  I have some ideas though,
  123.     and hopefully this won't be an issue for the next CD-ROM.
  124.  
  125.     *    The simplest solution for now may be to patch your SAS C
  126.     executables to look for SLB: instead of LIB:.  However this
  127.     will cause problems with Makefiles and other such files that
  128.     reference LIB:.
  129.  
  130.  
  131. USER FEEDBACK NEEDED
  132.  
  133.     *    I am always interested in hearing about things that might make
  134.     this CD-ROM more useful for users.  It is particularly important
  135.     at this stage that I get feedback from users about problems that
  136.     need fixing, or suggestions on how to make the CD-ROM more useful.
  137.  
  138.     *    You can FAX your comments to me at (602) 917-0917, however
  139.     please understand that I may not be able to respond to, or even
  140.     acknowledge receipt of, every problem report and suggestion that
  141.     arrives.
  142.  
  143.  
  144. -Fred Fish  ><>
  145.