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