home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD1.bin / readme < prev    next >
Text File  |  1995-04-19  |  6KB  |  149 lines
  1.  
  2.            IMPORTANT INFORMATION FOR THIS CD-ROM
  3.  
  4.                  (Updated 4/19/95)
  5.  
  6. ========
  7. OVERVIEW
  8. ========
  9.  
  10. This is volume 9 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. Some interesting additions to note for this CD-ROM are ports of GNU Fortran,
  15. GNU octave, and UnixTeX.  Also note that there are finally some new releases
  16. in the floppy library, and disks 1001-1060 are included in the BBS/fish
  17. directory on the second CD.
  18.  
  19. For general information about the Amiga Library CD-ROM's, detailed informa-
  20. tion about the contents of this particular CD-ROM, and other important in-
  21. formation, read the various files in the "Information" directory.  The
  22. "Changes" file may be of particular interest.  Also be sure to read the
  23. LEGAL-NOTICE, COPYRIGHT, WARRANTY, and SHAREWARE files if you have not done
  24. so before.  If you plan to use this CD-ROM in a BBS or anonymous FTP
  25. environment, the BBS/README file will be particularly useful to you.
  26.  
  27. =================
  28. CONTENTS OVERVIEW
  29. =================
  30.  
  31. This two-CD set contains a little over 1.1 Gb of data, divided roughly into
  32. the following sections:
  33.  
  34. Size    Area    Description
  35. ------    ----    -----------
  36.  
  37. 626 Mb    BBS    BBS ready material selected from the other
  38.         sections of the CD, as well as from previous
  39.         CD's, on a space available basis.  Also includes
  40.         full GNU source code, original baseline source,
  41.         diff files, etc, all in archived form.
  42.  
  43. 227 Mb    Useful    Misc useful tools, libraries, documentation,
  44.         source code examples, hardware/software reviews,
  45.         descriptions of previous CD's and floppies, etc.
  46.  
  47. 94 Mb    GNU    Binaries, libraries, runtime files, and documentation
  48.         for utilities in the GNU tree.  Source is now located
  49.         in the BBS tree.
  50.  
  51. 142 Mb    New    Ready-to-run new submissions and other material
  52.         received since the previous FreshFish CD.
  53.  
  54. 49 Mb    Tools    CD-ROM administration tools, documentation,
  55.         search utils, etc.
  56.  
  57. For further information about the contents of this CD-ROM, see the
  58. "CONTENTS", "INDEX", and "LOCATE" files in the "BBS", "New", and
  59. "Useful" directories, and the "README" file in the GNU directory.
  60.  
  61. =================
  62. LOCATING MATERIAL
  63. =================
  64.  
  65. Included on this CD-ROM are two different programs for finding specific
  66. material, or types of material, that you may be looking for.  The first
  67. program is "A-Kwic", which does keyword searches on a database that is built
  68. from the included product info files.  A-Kwic can be found in the
  69. "Tools/A-Kwic" directory.
  70.  
  71. The second program is a new version of "KingFisher", which is included in
  72. the "Tools/KingFisher" directory.  This program also uses a database which
  73. is built from the included product info files.
  74.  
  75. For general browsing of the CD, you can use DirWork (in Tools/DirWork)
  76. or the provided AmigaGuide files.
  77.  
  78. ============
  79. INSTALLATION
  80. ============
  81.  
  82. This CD-ROM contains lots of utilities that are ready to run directly off
  83. the CD-ROM.  This will be slower than running off a hard drive, but CD-ROM
  84. drives are improving constantly, so if you have one of the newer double,
  85. triple, or quad speed drives, this should not be too painful.  You may be
  86. able to save as much as 300 Mb of disk space by running directly off the
  87. CD-ROM.
  88.  
  89. For this CD-ROM all of the setup necessary to run most things directly off
  90. the CD-ROM is for you to run a couple of the startup scripts on the CD-ROM;
  91. one to setup the GNU environment and one to setup the "Useful" environment.
  92. The file Useful/Sys/S/User-Startup-Example is an example of one way to do
  93. this that will find the latest available FreshFish CD at boot time, and
  94. run the appropriate startup script(s).
  95.  
  96. Just copy the User-Startup-Example script to S:FFCD-Startup, and then add
  97. the indicated commands at the beginning of the User-Startup-Example file to
  98. your S:User-Startup file, and reboot.  You have to reboot because it needs
  99. to run before the LoadWB command is run, so that the Workbench will know
  100. about the directories added to the command search path.
  101.  
  102. If you want a more customized environment, you can look at what the
  103. GNU-Startup and Useful-Startup scripts are doing and use appropriate bits
  104. and pieces in your own S:User-Startup.  Future disks may have a more
  105. sophisticated method of customizing the environment to allow things to run
  106. off the CD-ROM.
  107.  
  108. =============
  109. GNU UTILITIES
  110. =============
  111.  
  112. This CD-ROM contains ports of various GNU utilities.  See GNU/README
  113. for further information about what is included.
  114.  
  115. We are very picky about adhering completely to the conditions of the GNU
  116. Public License, so all of the GNU code that goes on one of the CD-ROM's has
  117. to be built and tested the first time it is included and each time it is
  118. updated.  Expect this portion of the CD-ROM to continually grow with each
  119. CD-ROM release, as more ports of GNU code are added.
  120.  
  121.                *** IMPORTANT ***
  122.  
  123.     Some of the GNU utilities, gcc in particular, require a
  124.     very large stack.  You need to arrange that the CLI/Shell
  125.     or whatever you run these programs from has a large stack
  126.     set.  In a CLI you can set this with a command of the
  127.     form "stack 100000" (400000 is what we use).  You can also
  128.     put this command in your S:Shell-Startup file to get large
  129.     stacks for all CLI/Shell startups, without having to 
  130.     remember to manually set the stack each time.  Really huge
  131.     compiles, like recompiling the compiler itself, may require
  132.     even more stack space (like 300-800 Kb).  Work is in
  133.     progress to include automatic stack growth code in gcc,
  134.     so this requirement will hopefully disappear in a future
  135.     release.
  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.