home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / readme < prev    next >
Text File  |  1995-01-31  |  6KB  |  156 lines
  1.  
  2.            IMPORTANT INFORMATION FOR THIS CD-ROM
  3.  
  4.                  (Updated 1/31/95)
  5.  
  6. ========
  7. OVERVIEW
  8. ========
  9.  
  10. This is volume 8 in the "FreshFish" (TM) CD-ROM series.  This file contains
  11. important information that applies to this particular CD-ROM, and points out
  12. other important files that you should read.
  13.  
  14. After completing volume 7, we realized that we were rapidly running out of
  15. room on a single CD.  Since we have plans to greatly expand the amount of
  16. material in the "GNU" and "Useful" portions of the FreshFish CD, as well as
  17. continue to add more material to the "New" section, we decided to expand the
  18. FreshFish CD's to a two-CD set.  Although these two CD's contain over 1 Gb
  19. total of material, with room to expand by several hundred megabytes, there
  20. is also about 150 Mb of material in the BBS section from previous FreshFish
  21. CD's, that can be eliminated if necessary from future CD's.  This should
  22. give us room to grow for at least another year or so.
  23.  
  24. For general information about the Amiga Library CD-ROM's, detailed informa-
  25. tion about the contents of this particular CD-ROM, and other important in-
  26. formation, read the various files in the "Information" directory.  The
  27. "Changes" file may be of particular interest.  Also be sure to read the
  28. LEGAL-NOTICE, COPYRIGHT, WARRANTY, and SHAREWARE files if you have not done
  29. so before.  If you plan to use this CD-ROM in a BBS or anonymous FTP
  30. environment, the BBS/README file will be particularly useful to you.
  31.  
  32. =================
  33. CONTENTS OVERVIEW
  34. =================
  35.  
  36. This two-CD set contains a little over 1Gb of data, divided roughly into
  37. the following sections:
  38.  
  39. Size    Area    Description
  40. ------    ----    -----------
  41.  
  42. 460 Mb    BBS    BBS ready material selected from the other
  43.         sections of the CD, as well as from previous
  44.         CD's, on a space available basis.
  45.  
  46. 220 Mb    Useful    Misc useful tools, libraries, documentation,
  47.         source code examples, hardware/software reviews,
  48.         descriptions of previous CD's and floppies, etc.
  49.  
  50. 193 Mb    GNU    Full GNU source code, original FSF archives,
  51.         diff files, binaries, libraries, runtime files,
  52.         documentation, etc.
  53.  
  54. 115 Mb    New    Ready-to-run new submissions and other material
  55.         received since the previous FreshFish CD.
  56.  
  57. 23 Mb    Tools    CD-ROM administration tools, documentation,
  58.         search utils, etc.
  59.  
  60. For further information about the contents of this CD-ROM, see the
  61. "CONTENTS", "INDEX", and "LOCATE" files in the "BBS", "GNU", "New", and
  62. "Useful" directories.
  63.  
  64. =================
  65. LOCATING MATERIAL
  66. =================
  67.  
  68. Included on this CD-ROM are two different programs for finding specific
  69. material, or types of material, that you may be looking for.  The first
  70. program is "A-Kwic", which does keyword searches on a database that is built
  71. from the included product info files.  A-Kwic can be found in the
  72. "Tools/A-Kwic" directory.
  73.  
  74. The second program is a new version of "KingFisher", which is included in
  75. the "Tools/KingFisher" directory.  This program also uses a database which
  76. is built from the included product info files.
  77.  
  78. For general browsing of the CD, you can use DirWork (in Tools/DirWork)
  79. or the provided AmigaGuide files.
  80.  
  81. ============
  82. INSTALLATION
  83. ============
  84.  
  85. This CD-ROM contains lots of utilities that are ready to run directly off
  86. the CD-ROM.  This will be slower than running off a hard drive, but CD-ROM
  87. drives are improving constantly, so if you have one of the newer double,
  88. triple, or quad speed drives, this should not be too painful.  You may be
  89. able to save as much as 300 Mb of disk space by running directly off the
  90. CD-ROM.
  91.  
  92. For this CD-ROM all of the setup necessary to run most things directly off
  93. the CD-ROM is for you to run a couple of the startup scripts on the CD-ROM;
  94. one to setup the GNU environment and one to setup the "Useful" environment.
  95. The file Useful/Sys/S/User-Startup-Example is an example of one way to do
  96. this that will find the latest available FreshFish CD at boot time, and
  97. run the appropriate startup script(s).
  98.  
  99. Just copy the User-Startup-Example script to S:FFCD-Startup, and then add
  100. the indicated commands at the beginning of the User-Startup-Example file to
  101. your S:User-Startup file, and reboot.  You have to reboot because it needs
  102. to run before the LoadWB command is run, so that the Workbench will know
  103. about the directories added to the command search path.
  104.  
  105. If you want a more customized environment, you can look at what the
  106. GNU-Startup and Useful-Startup scripts are doing and use appropriate bits
  107. and pieces in your own S:User-Startup.  Future disks may have a more
  108. sophisticated method of customizing the environment to allow things to run
  109. off the CD-ROM.
  110.  
  111. =============
  112. GNU UTILITIES
  113. =============
  114.  
  115. This CD-ROM contains ports of various GNU utilities.  See GNU/README
  116. for further information about what is included.
  117.  
  118. We are very picky about adhering completely to the conditions of the GNU
  119. Public License, so all of the GNU code that goes on one of the CD-ROM's has
  120. to be built and tested the first time it is included and each time it is
  121. updated.  Expect this portion of the CD-ROM to continually grow with each
  122. CD-ROM release, as more ports of GNU code are added.
  123.  
  124.                *** IMPORTANT ***
  125.  
  126.     Some of the GNU utilities, gcc in particular, require a
  127.     very large stack.  You need to arrange that the CLI/Shell
  128.     or whatever you run these programs from has a large stack
  129.     set.  In a CLI you can set this with a command of the
  130.     form "stack 100000" (100000 is what we use).  You can also
  131.     put this command in your S:Shell-Startup file to get large
  132.     stacks for all CLI/Shell startups, without having to 
  133.     remember to manually set the stack each time.  Really huge
  134.     compiles, like recompiling the compiler itself, may require
  135.     even more stack space (like 300Kb or more).
  136.  
  137. ====================
  138. USER FEEDBACK NEEDED
  139. ====================
  140.  
  141. We are always interested in hearing about things that might make this CD-ROM
  142. more useful for users.  It is particularly important that we get feedback
  143. from users about problems that need fixing, or suggestions on how to make
  144. the CD-ROM more useful.
  145.  
  146. You can FAX your comments to us at (602) 491-0048, however please understand
  147. that we may not be able to respond to, or even acknowledge receipt of, every
  148. problem report and suggestion that arrives.
  149.  
  150. ===================================
  151. CHANGES SINCE LAST FRESHFISH CD-ROM
  152. ===================================
  153.  
  154. See the file Information/Changes for a summary of other changes since the
  155. last FreshFish CD-ROM.
  156.