Central to the operation of the program is this concept; the file that MailWatch watches can be in one of three states:

NONE

The file either does not exist, or it does exist but has a filesize of 0.

OLD

The file exists, but is either

• already present when the program starts; or
• changed, but smaller than the previous filesize.

NEW

The file exists, has changed and is larger than the size that it was previously.

The preferences program allows you to use a GUI to configure the response of the program to changes in these states. It is composed of various parts, in order to separate the different types of response for each state.

	On the left there is a listview, the separate items of which define the files to be 'watched' by MailWatch. Only the name of the file is shown in the listview; the file's full name, with path, is shown in the string gadget beneath the list. The gadgets underneath the listview perform the standard actions; ADD adds an entry DUP duplicates (i.e. copies) the selected entry DEL deletes the selected entry, and CLR clears the list completely. The file gadget and the string gadget are, of course, used to edit the name of the file or files that should be 'watched'.
On the right hand side is a field with four different pages, controlled by a cycle gadget at the top. You can choose which type of behaviour you wish to edit for the currently chosen file by selecting one of the values from the cycle gadget. Click on each of the fields to get an explanation of the different pages.
You can use these gadgets to exit the preferences program. Save saves the preferences to 'ENVARC:MailWatch.prefs' and 'ENV:MailWatch.prefs', Use only saves the preferences to 'ENV:MailWatch.prefs', and Cancel quits the program without saving anything, in the same manner as the close-gadget in the upper-left corner of the window.
	The preferences program only has one menu, and the options accesible from it are those that you would expect: Save saves the preferences to 'ENVARC:MailWatch.prefs' and 'ENV:MailWatch.prefs'. Save as... gives you a file requester, allowing you to choose what file the current preferences should be saved to. Load opens a file requester with which you can load preferences from a particular file. About brings up a tiny 'About' requester. Quit... well... see if you can work that one out for yourself.

Tooltypes

The current tooltypes for the MailWatch program itself are:

Tooltype	Description
CONFIG	The name of a configuration file specifying the options for a number of files to be watched. This defaults to 'ENV:MailWatch/MailWatch.prefs'.
MWDF	The name of the MailWatch GUI definition module to use. If this tooltype is not provided, the value defaults to 'modules/appicons.mwdf'.

The program looks for the modules in the directory you specify it in, and then (I am pretty sure that this is standard AmigaDOS behaviour) in LIBS:. Therefore, you can specify the modules by name only if they are to reside in any directory which is part of the LIBS: path, or you can specify them by their full path and hide them somewhere else on the hard drive.

The preferences program looks for these tooltypes:

Tooltype	Description
PUBSCREEN	The name of the public screen that the program should open its window on.
FONTNAME	The name of the font to be used for the GUI. Must include the '.font' extension. For example, FONTNAME=topaz.font is acceptable, while FONTNAME=topaz is not.
FONTSIZE	The size of the font. If FONTNAME is specified, then this must be specified as well.

If the FONT#? tooltypes are not specified, then the program will use the screen font for the screen it opens on.

If PUBSCREEN is not specified, this will be the default public screen.

ARexx

From v3.1a, MailWatch has an ARexx port. The name of the port is MailWatch. It's a simple little beast at the moment, and it only understands a few commands...

Command	Template	Description
ADD	ALIAS/A	This command (given in the form, f.ex., Add MailListIcon) will enable the icons for any file which has the same alias as the one given as the parameter to this command. It reverses the effect of the REMOVE command, below.
REMOVE	ALIAS/A	This command (given in the form, f.ex., Remove MailListIcon) will disable the icons for any file which has the same alias as the one given as the parameter to this command. It reverses the effect of the ADD command, above.
DISABLE		This will do the same as a Commodities Exchange 'Inactive' command; MailWatch will hide its icons and temporarily stop watching the files.
ENABLE		This, of course, reverses the effect of the above command. It is the same as using the Commodities Exchange to issue an 'Active' command.
QUIT		Closes the program down.