Most Current

This program will update B. Lennart Olsson's Aquarium (V1.12) database
so that a new button will be created called "Most Current".  Each entry
in the db that is the most recent available will have the "Most Current"
button set, and all of it's precursors will have the button cleared.
This way people will no longer have to search backwards through the db
to find the most current version or read multiple entries for the same
program.

As of disk 360 there are 1836 entries in the Fish Library.  However,
402 of them are versions that are no longer current.  Those buttons
will have the "Most Current" button cleared.

	There is a cost for this feature, you must give up
		one of the following buttons:

			Assembly
			Basic (or)
			Modula II

This will make room for the new button "Most Current".  The button
that you give up will be thrown into the category "Other code".

You're better equipped to use these programs if you read the whole
doc, but if you just can't stand reading documentation, and you
>>have to<< implement the program --->NOW<---, do the following:

	1) Get on to the CLI or Shell (sorry Mouse users).
	2) CD into the directory where you keep your Aquarium.
	3) Execute the script "Ren" found with this package.
		This will do the following renames:
			o "KeyNames" to "KeyNames.old"
			o "index" to "index.old"
	4) Run the program "ClearSpace" and tell it which
	   button you want to give up.
	5) Run the program "MostCurrent".
	6) Look at all the little fishies in your aquarium.
	   If you don't like what you see:
   		Delete the files "KeyNames" and "index", and then
		rename "KeyNames.old" to "KeyNames", and
		"index.old" to "index", and everything will be
		back to normal.
	   If you like what you see:
   		Delete the files:
		   "KeyNames.old" "index.old" and "index.tmp"
		   Read the Miscellaneous Notes at the bottom of this.

		...and in the future...
		When you add new fish to your library you can run
		the program "MostCurrent" again by doing the following:
		1) Drop your new fish in the aquarium (using NewFish).
		2) Rename the file "index" to "index.tmp".
		3) DO NOT run the program "ClearSpace" again!
		4) Run the program "Most Current" again.
		5) Confirm that your aquarium works to your liking.
		6) Delete the file "index.tmp"

Detailed explanation

This software "package" comes as two (count 'em) standalone programs.
The first (ClearSpace) should be run only once.  This program will ask
you which button you wish to surrender.  It will first adjust all the keys
in the "index.old" file to create the empty space for the "Most Current"
button.  The output will be placed in the file "index.tmp".  It will then
read the "KeyNames.old" file and change the headers so that the buttons
read correctly when you plug in the lights on your aquarium.  The output
will be placed in "KeyNames".  This program will abort before doing any
modifications if the "KeyNames.old" file has previously been changed by
the ClearSpace program.

The second program (MostCurrent) will read "index.tmp" and update the
"Most Current" button.  It may be run again in the future when you add
new fish to your aquarium.  After adding the new fish, just rename the
"index" to "index.tmp" and run the "Most Current" program again.  If
any of the new fish are updates to fish already in the aquarium,
"MostCurrent" will recognize them, and update the "Most Current"
button appropriately.

F    L   A   W   S

The MostCurrent program recognizes entries by the entry in the Name
file (not case sensitive).  Some updated programs have new names on
them (like Yachtz3, etc.).  I did not put any logic into the program
to recognize these name changes.  Therefore both versions will be
considered "Most Current".  A few programs have duplicate names,
but are by different authors.  Rubik on Disk's 285 & 362 is
one example.  The former will have it's "Most Current" button
cleared (sorry Roger).

The programs will operate on up to 10000 entries as written.  If
you're still alive after disk 1960 comes out, then just modify
the defintion SIZE in "MostCurrent", and recompile (see below).

Miscellaneous Notes

  o The programs will preserve any comments you have
    made in the "KeyNames" file.

  o Thanks to Howard Hull for the technical docs,
    without which I wouldn't have bothered to write this.

  o Someone who's smarter than me might want to write
    a quick patch program so that the Aquarium comes
    up with "Most Current" on.

  o I included the source because I'm a nice guy.
	It was compiled with Manx 3.6a as follows:
		cc ClearSpace +p
		ln ClearSpace -lml32 -lcl32
		cc MostCurrent +p
		ln MostCurrent -lml32 -lcl32

  o If you like this program, please send twenty-five
    cents (U.S. only, sorry no checks accepted) to:

			Peter A. Phelps
			3515 Central Road, #304
			Glenview, IL  60025

		and I will think of you often.
	(Watch... I'll probably get bombarded with quarters!)