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