Fresh Fish 5/FreshFish_July-August1994.bin/readme

Text File | 1994-07-17 | 6KB | 139 lines

           IMPORTANT INFORMATION FOR THIS CD-ROM

                (Updated 15-Jul-94)

--------
OVERVIEW
--------

This is the fifth CD-ROM in my "FreshFish" (TM) series.  This file contains
important information that applies to this particular CD-ROM, and points out
other important files that you should read.

For general information about the Amiga Library CD-ROM's, detailed informa-
tion about the contents of this particular CD-ROM, and other important in-
formation, read the various files in the "Information" directory.

The files "Changes" and "Feedback" may be of particular interest.  Also be
sure to read the LEGAL-NOTICE, COPYRIGHT, WARRANTY, and SHAREWARE files if
you have not done so before.  If you plan to use this CD-ROM in a BBS or
anonymous FTP environment, the BBS/README file will be particularly useful
to you.

-----------------
CONTENTS OVERVIEW
-----------------

There is a total of 647 Mb of material on this CD-ROM, broken down as
follows:

 Size (Mb)
 ----
  220    Archived (BBS ready) material from this CD and previous FreshFish.
  169    Full GNU source code and diffs for supplied GNU executables.
   77    Miscellaneous useful tools, libraries, documentation, and examples.
   76    New ready-to-run material released since last FreshFish CD.
   53    GNU binaries, libraries, runtime files, and documentation.
   26    Descriptions of contents of previous CD-ROM's and floppy disks.
   13    CD-ROM administration tools, documentation, search utilities, etc.
    7    Reviews of Amiga hardware, software, and other products.
    6    Commodore includes, libraries, and developer tools (V37-V40).

For further information about the contents, see the "QuickRef" and
"Contents" files in the "BBS", "GNU", "New", and "Useful" directories.

-----------------
LOCATING MATERIAL
-----------------

Included on this CD-ROM are two different programs for finding specific
material, or types of material, that you may be looking for.  The first
program is "A-Kwic", which does keyword searches on a database that is built
from the included product info files.  A-Kwic can be found in the
"Tools/A-Kwic" directory.

The second program is a new beta version of "KingFisher", which is included
in the "Tools/KingFisher" directory.  This program also uses a database
which is built from the included product info files.

For general browsing of the CD, you can use DirWork (in Tools/DirWork).

------------
INSTALLATION
------------

This CD-ROM contains lots of utilities that are ready to run directly off
the CD-ROM.  This will be slower than running off a hard drive, but CD-ROM
drives are improving constantly, so if you have one of the newer double,
triple, or quad speed drives, this should not be too painful.  You may be
able to save as much as 300 Mb of disk space by running directly off the
CD-ROM.

For this CD-ROM all of the setup necessary to run most things directly off
the CD-ROM is for you to run a couple of the startup scripts on the CD-ROM;
one to setup the GNU environment and one to setup the "Useful" environment.
The file Useful/Sys/S/User-Startup-Example is an example of one way to do
this that will find the latest available FreshFish CD at boot time, and
run the appropriate startup script(s).

Just copy the User-Startup-Example script to S:FFCD-Startup, and then add
the indicated commands at the beginning of the User-Startup-Example file to
your S:User-Startup file, and reboot.  You have to reboot because it needs
to run before the LoadWB command is run, so that the Workbench will know
about the directories added to the command search path.

If you want a more customized environment, you can look at what the
GNU-Startup and Useful-Startup scripts are doing and use appropriate bits
and pieces in your own S:User-Startup.  Future disks may have a more
sophisticated method of customizing the environment to allow things to run
off the CD-ROM.

-------------
GNU UTILITIES
-------------

This CD-ROM contains ports of various GNU utilities.  See GNU/README
for further information about what is included.

I am very picky about adhering completely to the conditions of the GNU
Public License, so all of the GNU code that goes on one of the CD-ROM's has
to be built and tested the first time it is included and each time it is
updated.  Expect this portion of the CD-ROM to continually grow with each
CD-ROM release, as more ports of GNU code are added.

               *** IMPORTANT ***

    Some of the GNU utilities, gcc in particular, require a
    very large stack.  You need to arrange that the CLI/Shell
    or whatever you run these programs from has a large stack
    set.  In a CLI you can set this with a command of the
    form "stack 100000" (100000 is what I use).  You can also
    put this command in your S:Shell-Startup file to get large
    stacks for all CLI/Shell startups, without having to
    remember to manually set the stack each time.  Really huge
    compiles, like recompiling the compiler itself, may require
    even more stack space (like 300Kb or more).

--------------------
USER FEEDBACK NEEDED
--------------------

I am always interested in hearing about things that might make this CD-ROM
more useful for users.  It is particularly important at this stage that I
get feedback from users about problems that need fixing, or suggestions on
how to make the CD-ROM more useful.

You can FAX your comments to me at [phone], however please understand
that I may not be able to respond to, or even acknowledge receipt of, every
problem report and suggestion that arrives.

------------------------------------
CHANGES SINCE LAST FRESHFISH CD-ROM
------------------------------------

See the file Information/Changes for a summary of changes since the last
FreshFish CD-ROM.

-Fred Fish  ><>