--------------------------------------------------------------------------- Fisher.rexx ARexx/DLG Front End for the KingFisher Database. Copyright © 1994 Keith R. Burby [User Documentation] --------------------------------------------------------------------------- Legal Stuff ~~~~~~~~~~~ The Fisher.rexx script and the documentation are copyrighted by the author. Feel free to make changes, to this program,to suit your needs, however, I ask two things: 1) If you feel that the changes you've made, to this program, are improvements or bug fixes, please send me a copy of the updated script with some notes regarding the changes you made. 2) Do not alter the program's title, in particular, the two lines which give credit to both myself and Mr. Shuermann. The author accepts no responsibility for any damage to the system of anyone who uses this program. USE THIS PROGRAM AT YOUR OWN RISK. Usage ~~~~~ Fisher.rexx is divided up into three separate menus: The main menu, the search menu, and the request menu. Main Menu ~~~~~~~~~ This is where most of the work will be done. This is also where the description of the titles can be seen. The commands are as follows: F) First Entry Move the entry pointer to the very first entry in the database. L) Last Entry Move the entry pointer to the very last entry in the database. P) Previous Entry Move the pointer to the previous entry. This will have no effect if you are already at the first entry. N) Next Entry Move the pointer to the next entry. This will have no effect if you are already at the last entry. -) Previous Disk Move to the first entry of the previous disk. This will have no effect if you are already at the first disk. +) Next Disk Move to the first entry of the next disk. This will have no effect if you are already at the last disk. <) Previous Version Move to an entry which is an older version of the current title. This will have no effect if there are no earlier versions of this title. >) Next Version Move to an entry which is a newer version of the current title. This will have no effect if there are no newer versions of this title. S) Begin Search Bring up the search menu. C) Continue Search Continue a previously set up search. This will have no effect if you haven't initiated a search earlier. R) Make Request Bring up the request menu. Note: depending on how the sysop has this script configured, this option may not be available. Q) Quit Fisher. The name says it all. If you enter a number, within the range of 1 and the last disk in the database, the pointer will be moved to the first entry of the specified disk. (i.e. entering 820 will move you to "Databench", the first entry of disk #820) If you enter a NEGATIVE number, within the range of 1 and the last entry in the database, the pointer will be moved to that entry. (i.e. entering -926, you will be moved to "GlobeDemo", found on disk #151) Pressing return, without entering anything, will toggle the display between the menu listing and the description of the current title. Note that all of the commands will still be available even when the description is displayed. Search Menu ~~~~~~~~~~~ When you first invoke the search menu, you'll be presented with the following list of defaults: Search mode will be set to TITLE search Search direction will be set to BACKWARDS Search range will be set to DISABLED (from the current entry to the 1st) Case sensitivity will be set to IGNORED (case insensitive) The search string will be empty ("") The menu entries are as follows: M) Change Mode This will switch the search mode between TITLE and DESCRIPTION. A TITLE search will search through only the entry titles for the specified pattern, while a DESCRIPTION search will search through both the titles and descriptions for the specified pattern. Needless to say, a TITLE search is much faster than a DESCRIPTION search. D) Change Direction This will switch the direction between BACKWARD and FORWARD. A BACKWARD search will search the database from the current entry to the first entry, while a FORWARD search will search from the current entry to the last. R) Change Range This entry does two things. If the range is currently DISABLED, you will be prompted to enter the lowest disk number and highest disk number you want to conduct the search though. If a range is already specified this option will clear and disable the search range. NOTE: If you have specified a range, and your current disk number is higher than the high range (for a FORWARD search) or lower than the low range (for a BACKWARD search), the search will abort. C) Change Case This will change the case sensitivity between IGNORED (a = A) and SENSITIVE (a <> A). Most likely, you'll never have to fool with this option. S) Change String After selecting this option, you will be prompted to enter the string/pattern you wish to search for. The search string can include any AmigaDOS pattern matching characters, including #? and possibly *, with the additional character & to represent a logical AND. B) Begin search Name says it all. Q) Quit search menu Ditto. If you have specified a range, and the disk pointer is currently at a disk below the specified range (for a BACKWARD search) or above the specified range (for a FORWARD search), the search will abort. If the disk pointer is above the range (for a BACKWARD search) or below the range (for a FORWARD search) the disk pointer will be moved to the high range or low range respectively. In order for a search to be initiated, a search string must be provided, otherwise the B) Begin Search option and the C) Continue Search option, found on the main menu, will not operate. Request Menu ~~~~~~~~~~~~ This menu will allow the user to make a request for either a specific title and which Fish disk it can be found on, or an entire disk. The menu entries are as follows: S) Current selection The sysop will receive E-mail stating that you requested a copy of the title currently displayed and the disk it can be found on. D) Entire disk The sysop will receive E-mail stating that you have requested a copy of the Fish Disk currently being displayed. Q) Quit (Don't send request) Name says it all. Again, depending upon how the sysop has this script configured, this menu may or may not be available. I hope you enjoy the program. I know I had fun writing it. As always. K/B ~~~