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