home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 3 / freshfish3_9403.bin / readme-first < prev    next >
Text File  |  1994-02-27  |  6KB  |  148 lines
  1.  
  2.            IMPORTANT INFORMATION FOR THIS CD-ROM
  3.                 (Updated 2-25-94)
  4.  
  5. This is the third CD-ROM in my "FreshFish" series.  This file contains
  6. important information that applies to this particular CD-ROM.  For general
  7. information about the Amiga Library CD-ROM's, information about the contents
  8. of this particular CD-ROM, and other important information, read the various
  9. files in the "Information" directory.  The files "Changes" and "Feedback"
  10. may be of particular interest.  Also be sure to read the LEGAL-NOTICE,
  11. COPYRIGHT, WARRANTY, and SHAREWARE files if you have not done so before.
  12.  
  13. Progress is being made on a system to make browsing the contents of the
  14. CD-ROM much easier, and for finding specific things on each CD-ROM and
  15. across a series of CD-ROM's.  This CD-ROM includes a partial database of the
  16. CD-ROM contents and a program to find material based on keyword searches.
  17. See the A-Kwic directory for more details.  A new version of KingFisher is
  18. also in the works.
  19.  
  20. This CD-ROM contains approximately 59 Mb of new material, 284 Mb of useful
  21. tools including gcc 2.5.8, emacs 18.59, PasTeX, etc, and 293 Mb of older
  22. material (such as floppy distributions).  All of the source to the supplied
  23. GNU binaries is provided and I have personally built all the supplied
  24. binaries from the supplied source (except GNU emacs) to verify that the
  25. binaries are in fact recreatable from the supplied source code.  For more
  26. information about the contents of the CD-ROM see the files in the
  27. "Information" directory.
  28.  
  29. ------------
  30. INSTALLATION
  31. ------------
  32.  
  33. This CD-ROM contains lots of utilities that are ready to run directly off
  34. the CD-ROM.  This will be slower than running off a hard drive, but CD-ROM
  35. drives are improving constantly, so if you have one of the newer double,
  36. triple, or quad speed drives, this should not be too painful.  You may be
  37. able to save as much as 300 Mb of disk space by running directly off the
  38. CD-ROM.
  39.  
  40. For this CD-ROM all of the setup necessary to run most things off the
  41. CD-ROM is for you to run the script FFCD-Startup, which can be found in
  42. FreshFish-Mar94:Useful/Sys/s/, from your S:User-Startup file, like this:
  43.  
  44.     ; These assigns search for the latest FreshFish CD-ROM available
  45.     ; online at boot time and run it's startup sequence.  They also
  46.     ; assign FFCD to that CD-ROM, both to make it easier to get to
  47.     ; from a CLI and as a flag that a CD-ROM has been found, so as
  48.     ; to avoid lots of nested if statements.  To support another
  49.     ; future CD-ROM, simply clone a block and change the device and
  50.     ; script names as appropriate.
  51.  
  52.     ; Look for December 1993 FreshFish CD-ROM
  53.     assign FFCD: exists >nil:
  54.     if warn
  55.         assign FreshFish-Dec93: exists >nil:
  56.         if not warn
  57.         echo "Running FreshFish-Dec93:Useful/s/FFCD-Startup..."
  58.         execute FreshFish-Dec93:Useful/s/FFCD-Startup
  59.         assign FFCD: FreshFish-Dec93:
  60.         endif
  61.     endif
  62.  
  63.     ; Look for October 1993 FreshFish CD-ROM
  64.     assign FFCD: exists >nil:
  65.     if warn
  66.         assign FFMCD01: exists >nil:
  67.         if not warn
  68.         echo "Running FFMCD01:Useful/s/FFCD-Startup..."
  69.         execute FFMCD01:Useful/s/FFCD-Startup
  70.         assign FFCD: FFMCD01:
  71.         endif
  72.     endif
  73.  
  74.     ; Look for March 1994 FreshFish CD-ROM.  Note that the location
  75.     ; of the startup script moved between Dec93 and Mar94.
  76.     assign FFCD: exists >nil:
  77.     if warn
  78.         assign FreshFish-Mar94: exists >nil:
  79.         if not warn
  80.         echo "Running FreshFish-Mar94:Useful/Sys/S/FFCD-Startup..."
  81.         execute FreshFish-Mar94:Useful/Sys/S/FFCD-Startup
  82.         assign FFCD: FreshFish-Mar94:
  83.         FFCD:Useful/sys/C/PowerSnap CX_POPUP=NO ANTS
  84.         endif
  85.     endif
  86.  
  87. This should be added to your S:User-Startup before the LoadWB command, so
  88. that the WorkBench will know about the directories added to the command
  89. search path.  Once you have added this to your S:User-Startup, you will need
  90. to reboot for it to take effect.
  91.  
  92. If you want a more customized environment, you can look at what the
  93. FFCD-Startup script is doing and use appropriate bits and pieces in your
  94. own S:User-Startup or S:FFCD-Startup.  Future disks may have a more
  95. sophisticated method of customizing the environment to allow things to
  96. run off the CD-ROM.
  97.  
  98.                *** IMPORTANT ***
  99.  
  100.     Some of the GNU utilities, gcc in particular, require a
  101.     very large stack.  You need to arrange that the CLI/Shell
  102.     or whatever you run these programs from has a large stack
  103.     set.  In a CLI you can set this with a command of the
  104.     form "stack 100000" (100000 is what I use).  You can also
  105.     put this command in your S:Shell-Startup file to get large
  106.     stacks for all CLI/Shell startups, without having to 
  107.     remember to manually set the stack each time.  Really huge
  108.     compiles, like recompiling the compiler itself, may require
  109.     even more stack space (like 300Kb or more).
  110.  
  111. -------------
  112. GNU UTILITIES
  113. -------------
  114.  
  115.     *    This CD-ROM contains ports of various GNU utilities that are in
  116.     various stages of stability.  See GNU/README for further
  117.     information.
  118.  
  119.     *    I am very picky about adhering completely to the conditions of the
  120.     GNU Public License, so all of the GNU code that goes on one of the
  121.     CD-ROM's has to be build and tested the first time it is included
  122.     and each time it is updated.  Expect this portion of the CD-ROM to
  123.     continually grow with each CD-ROM release, as more ports of GNU
  124.     code are added.
  125.  
  126. --------------------
  127. USER FEEDBACK NEEDED
  128. --------------------
  129.  
  130.     *    I am always interested in hearing about things that might make
  131.     this CD-ROM more useful for users.  It is particularly important
  132.     at this stage that I get feedback from users about problems that
  133.     need fixing, or suggestions on how to make the CD-ROM more useful.
  134.  
  135.     *    You can FAX your comments to me at (602) 917-0917, however
  136.     please understand that I may not be able to respond to, or even
  137.     acknowledge receipt of, every problem report and suggestion that
  138.     arrives.
  139.  
  140. ------------------------------------
  141. CHANGES SINCE LAST FRESHFISH CD-ROM
  142. ------------------------------------
  143.  
  144.     *    See the file Information/Changes for a summary of changes since
  145.     the last FreshFish CD-ROM.
  146.  
  147. -Fred Fish  ><>
  148.