                                  GEMMAIL 

1.	GEMMAIL is a Freeware Multitos GEM based internet mail reader written 
by Andrew Colvin (apc@raleigh.zynet.co.uk).  

2.	The main screen is divided into two sections.  At the top are the 
folders where messages can be stored.  Beneath this are the messages available 
in each folder.

3.	Double clicking on a message extracts a message to a temporary file 
with pathname 'u:/tmp/msg%1%2', where %1 is the app id and %2 is a number to 
make the file unique. This message is then passed to the application found in 
the MAILREAD environment variable.  This environment variable must be a 
complete GEM based pathname i.e. 'C:\MULTITOS\VIEWER.APP'.

4.	A single click on a message selects the message, which is displayed by
placing a tick by the message.

5.	Double Clicking on a folder opens that folder for reading.  The 
currently open folder is identifiable by the bold text.

6.	A Single click on folder selects that folder.  It is then possible to 
delete the folder and its contents.  The operation is final!!!!

7.	New mail is expected to arrive in /usr/spool/mail/user (user is your
username).  You can pretend to be another user by starting the program as 
'gemmail -u user'.  However, if you do not have the privaleges to read this
mail box then the program will produce errors.  If started on its own the
program will determine the users own username.  

8.	The program will adjust its default directory to be relative to 
drive u. 

9.	When a message is selected a reply can be sent, or the message 
forwarded.  This calls the program found in the environment variable MAILSEND. 
this variable should contain the complete path of 'mailsend.prg' or 
equivalent (when somebody writes a mime aware version :-]).
Forwarding and replying can only be selected when a single message is 
selected.  This will change, especially for multipart messages.
Note that 'mailsend' uses the environment variable MAILEDIT to hold the
complete path of an editor ( I was going to build one in but at this point
decided not to), and expects to find an MTA as /usr/lib/sendmail relative to
drive u.


10.	When a folder is selected and  messages are also selected these 
messages can be copied/moved to the folder. Note that the program will not 
let you copy messages to their original folder or to the New Mail folder.  
Messages can be deleted in a similar fashion to folders.

11.	With AES 4.1 the window can be iconified.  In this state when 
new mail arrives the window changes to inform the user.

12.  Mailsend allows you to maintain a list of up to 15 alias; these only
work for the 'To:' line and not the 'CC:' lines.  Your aliases are kept in
the file '~/.aliases'. Your signature file (~/.signature) if it exists is 
appended to the end of the message. 

----------------------------------------------------------------------

Have fun and report bugs to apc@raleigh.zynet.co.uk

Andrew

PS: I knocked this together in just over a week in my spare time.  The code is
not the best, nor has it many comments (mainly those for editor navigation).
Do not pull it apart unless you are going to re-write it :-) 

PPS: The code quality of mailsend is absolutely disgusting (even worse than 
the reader if it is possible :=}).  

As a software engineer I am appauld that I actually wrote this code the way 
I did, with no notes, no design, no comments, and off the cuff.  What a
masterpiece.  I am actually considering whether to withdraw the code until
it is cleaned up, but then again I don't have the time (my holiday is at an
end).

Anyway, if somebody wants to unhack my hack then please do so with pleasure.


PPPPPPPPPPPS:  The way I have coded it you will need to have at least
mint/mintnet/minixfs/multitos (ie the GEM part).  

PPPPPPPPPPPPPPPS:  Oh and during my lazyness I didn't put tests in many
places when dealing with files.  Therefore if it tries to open a file and it
doesn't exist you may get bus errors (what a nightmare somebody please fix
it).

