home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / readme-first < prev    next >
Text File  |  1994-05-14  |  6KB  |  148 lines
  1.  
  2.            IMPORTANT INFORMATION FOR THIS CD-ROM
  3.  
  4.                 (Updated 14-May-94)
  5.  
  6. --------
  7. OVERVIEW
  8. --------
  9.  
  10. This is the fourth CD-ROM in my "FreshFish" (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. 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 650 Mb of material on this CD-ROM, broken down as
  29. follows:
  30.  
  31.   Size (Mb)
  32.   ----
  33.   151    Full GNU source code for supplied GNU executables.
  34.   126    New ready-to-run material not included in floppy library.
  35.    86    Archived (BBS ready) GNU source, binaries, libs & includes.
  36.    82    Archived (BBS ready) new material not in floppy library.
  37.    46    GNU binaries, libraries, and AmigaGuide info files.
  38.    42   Miscellaneous useful tools, libraries, and examples.
  39.    33    PasTeX source, fonts, and binaries.
  40.    22    Ready-to-run contents of floppy disks 976-1000.
  41.    17    Descriptions of contents of previous CD-ROM's & floppies.
  42.    13    CD-ROM administration tools, documentation, etc.
  43.    11    Archived (BBS ready) contents of floppy disks 976-1000.
  44.     9    Archived (BBS ready) material from Mar/Apr FreshFish CD-ROM.
  45.     6    Reviews of Amiga hardware, software, and other products.
  46.     6   Commodore includes, libs, and developer tools (V37-V40).
  47.  
  48. For further information about the contents, see the "Contents" file in
  49. the "Information" directory.
  50.  
  51. -----------------
  52. LOCATING MATERIAL
  53. -----------------
  54.  
  55. Included on this CD-ROM are two different programs for finding specific
  56. material, or types of material, that you may be looking for.  The first
  57. program is "A-Kwic", which does keyword searches on a database that is built
  58. from the included product info files.  A-Kwic can be found in the
  59. "Tools/A-Kwic" directory.
  60.  
  61. The second program is a new beta version of "KingFisher", which is included
  62. in the "Tools/KingFisher" directory.  This program also uses a database
  63. which is built from the included product info files.
  64.  
  65. ------------
  66. INSTALLATION
  67. ------------
  68.  
  69. This CD-ROM contains lots of utilities that are ready to run directly off
  70. the CD-ROM.  This will be slower than running off a hard drive, but CD-ROM
  71. drives are improving constantly, so if you have one of the newer double,
  72. triple, or quad speed drives, this should not be too painful.  You may be
  73. able to save as much as 300 Mb of disk space by running directly off the
  74. CD-ROM.
  75.  
  76. For this CD-ROM all of the setup necessary to run most things directly off
  77. the CD-ROM is for you to run a couple of the startup scripts on the CD-ROM;
  78. one to setup the GNU environment and one to setup the "Useful" environment.
  79. The file Useful/Sys/S/User-Startup-Example is an example of one way to do
  80. this that will find the latest available FreshFish CD at boot time, and
  81. run the appropriate startup script(s).
  82.  
  83. Just add the contents of User-Startup-Example to your S:User-Startup file
  84. and reboot.  You have to reboot because it needs to run before the LoadWB
  85. command is run, so that the Workbench will know about the directories added
  86. 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. Because of the amount of time that has gone into creating the first
  102. FrozenFish CD and the GoldFish (1000 floppy disk archive) CD-ROM's 
  103. during the last two months since the last FreshFish CD, we were not
  104. able to make any improvements in the GNU support for this CD, relative
  105. to the last FreshFish CD.  Expect significant enhancements on the next
  106. FreshFish CD.
  107.  
  108. I am very picky about adhering completely to the conditions of the GNU
  109. Public License, so all of the GNU code that goes on one of the CD-ROM's has
  110. to be built and tested the first time it is included and each time it is
  111. updated.  Expect this portion of the CD-ROM to continually grow with each
  112. CD-ROM release, as more ports of GNU code are added.
  113.  
  114.                *** IMPORTANT ***
  115.  
  116.     Some of the GNU utilities, gcc in particular, require a
  117.     very large stack.  You need to arrange that the CLI/Shell
  118.     or whatever you run these programs from has a large stack
  119.     set.  In a CLI you can set this with a command of the
  120.     form "stack 100000" (100000 is what I use).  You can also
  121.     put this command in your S:Shell-Startup file to get large
  122.     stacks for all CLI/Shell startups, without having to 
  123.     remember to manually set the stack each time.  Really huge
  124.     compiles, like recompiling the compiler itself, may require
  125.     even more stack space (like 300Kb or more).
  126.  
  127. --------------------
  128. USER FEEDBACK NEEDED
  129. --------------------
  130.  
  131. I am always interested in hearing about things that might make this CD-ROM
  132. more useful for users.  It is particularly important at this stage that I
  133. get feedback from users about problems that need fixing, or suggestions on
  134. how to make the CD-ROM more useful.
  135.  
  136. You can FAX your comments to me at (602) 917-0917, however please understand
  137. that I may not be able to respond to, or even acknowledge receipt of, every
  138. problem report and suggestion that arrives.
  139.  
  140. ------------------------------------
  141. CHANGES SINCE LAST FRESHFISH CD-ROM
  142. ------------------------------------
  143.  
  144. See the file Information/Changes for a summary of changes since the last
  145. FreshFish CD-ROM.
  146.  
  147. -Fred Fish  ><>
  148.