June 27/93

===========================================================================

                        FindFish.c V2.0

                  CNet C Pfile for CNet V2.63

                  Copyright © 1993 Alan Kramer

              This version is freely distributable.


Check the end of this doc file for information on the REGISTERED version!

===========================================================================
 About the program:

 - FindFish is a program to search and display information from the
   contents files of the Fred Fish library.

 Features include:

 - FindFish will display the complete contents text for a given disk
   or range of disks.

 - FindFish will search for 'text' strings in the title text and file
   description text, then displays the contents text for that file,
   also works with ranges.

 Ranges:

 A range can be a single disk number:
   ie. 214
   The command will operate on disk 214 only. 

 A range can cover multiple disks:
   ie. 214,220,300
   The command will operate on the given disk numbers in order.

 A range can cover a group of disks:
   ie. 214-300  or  300-214
   The command will operate on all disks from 214 through 300.

 A range can also contain a mix of multiple ranges separated by a space. 
   ie. 214-300 310,312 400-440 500,510
   The command will operate on all disks from 214 through 300, 310,312,
   all disks from 400 through 440, 500 and finally disk 510.

Example 1:
 To scan the contents of the latest FredFish disks all you have to do is
   use the S)earch command.  Each description will be displayed with an option
   to quit or continue.  The descriptions are displayed in new to old order.

Example 2:
 To find all files with `mine' in the title or description text on disks
   300 to 400 all you have to do is set the SEARCH TEXT: to `mine' (without
   the quotes) and set the SEARCH RANGE: to 300-400 then use the S)can command.

=======================================================================
 Notes:

 To abort a search you must hold ^C down until the search stops.

 If a caller is at less than 2400 baud the current disk# only will be
   displayed during a search, the row of ....... will not be displayed
   which will speed things up for low baud callers.

=======================================================================
 Installation:

 1 - FindFish requires one assign, add it to your startup script for CNet.

            ASSIGN FISHDATA: <where ever you put them>

     FishData: contains the ASCII data files fish0, fish1, fish2...
     (see below for file format)

 2 - The FindFish program can go anywhere you want, pfiles: is a logical
     location and then add it to your pfiles list as a CNet "C" Pfile
     or add it to you global menu commands.


=======================================================================
 FindFish data file format:

-----------------------------------
#436                               <- Fred Fish disk#
filename                           <- Name of the file.
n lines describing the file, taken <- Description text
from the contents file included on <- each line ends with
Fred Fish disks.                   <- a LF  (0x0A)
                                   <- A LF in column 1 indicates end.
filename
n lines describing the file, taken
from the contents file included on
Fred Fish disks.

#437
filename
n lines describing the file, taken
from the contents file included on
Fred Fish disks.

-----------------------------------
  Each data file contains the contents text for 100 Fish Disks.

  fish0 contains disks 1 to 99.
  fish1 contains disks 100 to 199.
  fish2 contains disks 200 to 299.
  and so on.

  FindFish will handle up to 9,999 Fred Fish disks (fish99).

  The current database files include disks up to #860, you will have
to manually append new data as Fred releases new disks or download the
latest database files from the support BBS (see below).

************
* WARNING! *
************
  The # character is reserved as an indexing marker and can only appear
  as the identifier preceding the disk number.  You must scan any text
  that you add to the database files and change any # characters to some
  other character or delete them.  If there are any stray # characters
  in the file, you are asking for trouble.


=======================================================================

                        FindFish.c V2.0

                  CNet C Pfile for CNet V2.63+

                  Copyright © 1993 Alan Kramer

              This version is freely distributable.

=======================================================================
  FindFish has been extensively tested on an A-4000 and an A-1000,
with AmigaDos V3.1 and V2.04 running CNet V2.63.


I am interested in any problems found or improvement requests.

I can be reached via:

                Medicine Hat AMIGA Users Group BBS

                          (403)528-2060
 
                       14400 SUPRA V.32bis


  FW BBS would be the next best place, I call every other week or so.

=======================================================================

  FindFish improvements:

  - The search routines have been reworked, this doubles the speed of
    the text searches.

  - Release of a version compiled for the 020, 030, 040.  Should make it
    even faster.

  - The ability to search through those large CDROM file listings generated
    from many CDROM disks.  You will have the ability to generate your own
    lists as well.

  - Any features that you would like to see implemented.

To receive the latest REGISTERED version of FindFish (V2.1) mail $7.00 to:

          Stallion Systems
          Attn: Alan Kramer
          1936 - 3rd Ave NE
          Medicine Hat, Alberta
          Canada
          T1C 1C5

=======================================================================
End of doc.