!WMAdmin is the WimpMail Administrator.
The purpose of thin programme is nothing else than to enable you to do the
tings you want to do more easily or more quickly.
So it can be of use for everyone weather he's using WimpMail or not.

!WMAdmin is configured via three textfiles.

KeyDef	   This File defined the hotkeys
	   !WMAdmin does not wait for hotkeys from the WIMP as many
	   programmes use them theirselves and would only allow for
	   very strange combinations in the hope noone else uses them.
	   !WMAdmin will instead halt the WIMP and wait for a keypress
	   if a certain combination of shifting keys are depressed.
	   This combination is defined in the first line of this file.
	   Please see appendix B for the allowed Keywords.
	   You can use more than one combination. The logical operations
	   AND, OR and NOT may be used. I use the following:
	   (L-Shift and R-Shift) or (Shift and Ctrl)
	   Which will wait for a keypress if either both shift keys are
	   pressed or one of the shift keys and one of the control keys.

	   After this line you can define your keys by giving the key and
	   the command to be executed seperated by at least one space.
	   The key can be defined by it's number (see PRM p. 1198) or
	   by an asterix and the character the key represents. Control
	   characters can be given as an asterix, a pipe and the key
	   which would generate the code if pressed along with control.
	   This is as in the GSTrans format.
	   Some examples: 8 or *|H would mean the backspace key
			  65 or *A would mean the A key
			  437	   would mean shift-control-F5
	   If you are in doubt of the code generated by a certain keypress
	   you can simply try it out. !WMAdmin will open an error window
	   telling you this key isn't defined along with it's number.
	   For a list commands see appendix A.


MenuDef	   This file defines the menu structure and it's effects.
	   Here an exception at the beginning too:
	   The first line gives the command to be executed it the !WMAdmin
	   icon on the icon bar is clicked on with select. The second line
	   gives the command for being clicked using adjust.
	   For a list commands see appendix A.

	   The following lines define the menu structure.
	   submenus can be created by indenting the enties with two more
	   spaces than the parent menus entry.
	   An example. To get a menu looking like this:

	   +--------+---------+		 +--------+
	   |WM Admin|  Apps   |		 |WM Admin+-----------+
	   +--------+---------+		 +--------+  Misc     |
	   |  Apps |  WP/DTP |		 |  Apps +-----------+--------------+
	   |  Misc |  Comms  |		 |  Misc |  Mode 12  |  Shutdown    |
	   |  Quit  |  Music  |		 |  Quit  |  Mode 20  +--------------+
	   +--------+---------+		 +--------+  Sutdown |  Yes, sure!  |
						  +-----------+--------------+

	   the definition would look like this:
	       Apps
		 WP/DTP
		 Comms
		 Music
	       Misc
		 Mode 12
		 Mode 20
		 Shutdown
		   Yes, sure!
	       Quit

	   The menu entries may be up to 12 characters in length.
	   The entry to be displayed is followed by at least tree spaces (to
	   allow spaces in the menu entries) and the command to be executed
	   upon selection so the above example might look like this:
	       Apps		Open scsi::4.Apps
		 WP/DTP		Open scsi::4.WP/DTP
		 Comms		Open scsi::4.Comms
		 Music		Open scsi::4.Music
	       Misc
		 Mode 12	ChMode 12
		 Mode 20	ChMode 20
		 Shutdown
		   Yes, sure!	Shutdown
	       Quit		Quit

	   As you can see the parent entries of sumbenus may be defined to
	   execute a command if you like so.

	   For explanations of the single commands please refer to appendix A.


MailCheck  This file is only of use for WimpMail users.
	   It defines the users whose mailboxes are scanned and the path
	   if necessary.

	   The first line specifies weather !WMAdmin has to scan the users
	   mailbox itself.
	   If you run !WMAdmin on the same machine as WimpMail write "Local"
	   to the first line. !WMAdmin is informed by WimpMail wia the WIMPs
	   message system in this case.
	   If you want to check your mailbox on another computer via econet
	   use type "net " followed by a number giving the intervals to check
	   the mailboxes in seconds. e.g. "net 6" to check 10 times a minute.

	   The following lines specify the names of the users who want their
	   mailbox checked for new mail arrived. (max 10)

	   !!! WARNING !!!
	   If you are not running WimpMail, delete this file.
	   Otherwise !WMAdmin will fail trying to find the users.



Appendix A
==========

Commands available:

ChMode	   Changes the wimps screenmode
	   Parameters: the wanted screenmode

CWBack	   Brings the window with the input focus to the buttom
	   Parameters: none

CWClose	   Closes the window with the input focus
	   Parameters: none

CWFront	   Brings the window with the input focus to the top
	   Parameters: none

CWTogle	   Toggle the window with the input focus to it's full size
	   Parameters: none
	   The window will be moved to the top left corner of the screen, too.

MailCheck  Checks for new mail of up to 10 users
	   Parameters: Usernumber or none
	   When called without parameter or 0 the userlist will be displayed.
	   you can then click on a user to open his mailbox.
	   MailCheck can also be called with the nuber of an user to directly
	   open his mailbox. The number is the position of that user in the
	   MailCheck file, not the WimpMail user number.
	   In the mailbox window the first 10 mails of the particular users
	   mailbox are displayed sorted by urgency.
	   You can click on a mail to make !WMAdmin generate a temp file which
	   will be displayed by an editor (see Open).

Open	   Opens a file or directory
	   Parameters: Pathname to object to open
	   The given object is first offered to other programmes currently
	   running. If none of these care to open the object it will be
	   *RUN if clicked with select or *LOADed if clicked with adjust.
	   Directories are always displayed by the filer.
	   The Pathname may contain system variables.

OpenRec	   Opens a directory structure recoursively
	   Parameters: Pathname to direcrory
	   This command generates submenus equal to the directory structure
	   from the specified directory on.
	   If an entry is clicked on it is opened (see above).

Quit	   Quits !WMAdmin
	   Parameters: none

Run	   Runs a given file or application
	   Parameters: Pathname of object to be started
	   This command is equal to *Run

Redraw	   Redraws the entire screen
	   Parameters: none

Reload	   Reloads configuration files
	   Parameters: none

ShutDown   Issues a shutdown
	   Parameters: None
	   This command is equal to pressing shift-control-F12

Type	   Simulates keypresses
	   Parameters: String of keypresses to be simulated
	   The string is passed through GSTrans so you can type control-
	   characters is the GS format. Function key presses can be given
	   by a backslash an their name. See appendix C for details.



Appendix B
==========

shifting keys to activate hotkey grabb upon:

Shift			       Either shift key
Control = Ctrl		       Either control key
Alt			       Either alt key
L-Shift			       The left-hand shift key
R-Shift			       The right-hand shift key
L-Control = L-Ctrl	       The left-hand control key
R-Control = R-Ctrl = Action    The right-hand control key
L-Alt			       The left-hand alt key
R-Alt			       The right-hand alt key



Appendix C
==========

magic words to be used in Type comand:

\\
\F0	  = \Print
\F1
\F2
\F3
\F4
\F5
\F6
\F7
\F8
\F9
\F10
\F11
\F12
\Copy
\Left
\Right
\Down
\Up
\PgDown
\PgUp
\Ins	  = \Insert
\Tab
\Esc	  = \Escape    = \Break
\Del	  = \Delete
\Home
\BS
\NL	  = \CR	       = \Return



Appendix D
==========

How to contact me:

wimpy@yeti.dk
Phone:	 +49-461-23240
Fax/BBS: +49-461-9094288