Short:    Quick Search Aminet Index - Thor + CEd
Author:   kenny@bgnett.no <Kenneth "Kenny" Nilsen>
Uploader: kenny@bgnett.no <Kenneth "Kenny" Nilsen>
Version:  1.0 
Type:     util/misc
Requires: CygnusED and/or Thor 


mailto:kenny@bgnett.no

$VER: SAminet 1.0 (05.08.98)

Copyright (C) 1998 by Digital Surface/Kenneth "Kenny" Nilsen.
All rights reserved.


This package contains two arexx script and one binary.
The arexx scripts are for Thor and CygnusED.

SAminet can search for a keyword or sentence in an Aminet INDEX file
(full index). The binary will output all lines containing the keyword
or sentence.

The two arexx scripts will use this output for more convinient reading.

----------------
THE THOR SCRIPT:
----------------

  - Start the script in the system you usually download files (or any
    other system if you just want to get a list). Preferably you would
    install it to a function key if you use it often.
  - Type in a keyword or sentence in the string requester.
  - After a while you will get a list in the message window with the
    comment followed by two buttons to push, one for the archive and
    the other for the readme file only. To download a file found in
    the search simply press one of the buttons. The lines also contains
    archive size and age in weeks. At the top is the total number of hits.


--------------------
THE CYGNUS-ED SCRIPT
--------------------

  - This script works much in the same way. After starting the script
    in CED you will get a string requester asking for a keyword/sentence.
  - After a while the script will print the list formatted as in the Thor
    scipt, from current cursor position. This allow you to easily include
    lists in messages or textfiles.
  - Optionally this script can copy its output to a Thor message window
    if possible (see CONFIGURATION below).

Both scripts can be aborted in the keyword input phase by simply pressing
return. The Thor script allow you to push an abort button between each
major step.

The search is done in assembler code, the output is formatted with the
aid of arexx.

----------
THE BINARY
----------

You can of course use the binary on its own or if you want to create
scripts for other editors etc.

Usage:

	SAminet <path/index> <keyword>

	path/index is a path with filename on the Aminet index file you
	           want to use. The INDEX must be a FULL index file
	           (found in the Aminet root as INDEX or INDEX.Z).
	keyword	   is the keyword you will search for. If you use spaces
	           then use quotes around the keyword/sentence.

Examples:

	To search for every file containing 'AIFF' in the filename or
	description do this:

	 SAminet <path/index> "aiff"   (the search is case-insensitive)

	Or if you want to search every file that is 2 weeks old:

	 SAminet <path/index> " 2+"

	From the scripts you simply type the keyword into the requester.

CONFIGURATION

	You may configure in the two arexx scripts the following settings:

	THOR SCRIPT

	- FTP site, defaults to WUSTL
	- Path and filename for full INDEX file. You need to change this

	CED SCRIPT

	- FTP site, defaults to WUSTL
	- Path and filename for full INDEX file. You need to change this
	- AllowThor, set a bool (0 or 1) to allow Thor output if Thor is
	  running.

INSTALLATION

	Copy the binary to C: - if you use another path then remember to
	update the scripts as well.

	Copy the Cygnus ED script to REXX:CED/ or just rexx:
	Copy the Thor script to THOR:REXX/ or just rexx:

	The supplied quick-install script will assume rexx:ced/ exist and
	that Thor is properly installed in your system. No error checking.


SUPPORT

	This package is uploaded AS-IS. No support is planned. It's made
	for private needs and of good will it's shared with you. Feel
	free to comment it though.


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    2210    1115 49.5% 05-Aug-98 21:04:22  SAminet.info
    2520    1193 52.6% 05-Aug-98 20:39:24 +SAminet
     143     106 25.8% 05-Aug-98 20:45:48 +QuickInstall
    3231    1761 45.4% 05-Aug-98 20:45:58 +QuickInstall.info
    2310    1077 53.3% 05-Aug-98 20:44:14 +SAminet.ced
    3809    1713 55.0% 05-Aug-98 21:04:02 +SAminet.readme
    2444    1058 56.7% 05-Aug-98 20:44:40 +SAminet.thor
-------- ------- ----- --------- --------
   16667    8023 51.8% 07-Aug-98 19:35:02   7 files
