Mail Module - Nov 98 - by Patrice FAVRE
-----------

This module is a simple text mail sender.

The SMTP server used must be declared with its name or IP address.
The SMTP port (usually 25) can be changed.
The sender real name can be either the client login name or a
specific given value.
In the same way, the sender host IP can be either the scol server IP address
or a specific given value (name or IP).
You can also specify two text portions that will be included in all mails sent
before and after the user text body.

It provides 5 entries :
- send : sends a mail without displaying the client interface ;
	It must be associated with a parameter containing any of
	sender, recipients, copy, blind copy, subject and body, each one on a line (separated by '\n') :
		snd sender_e-mail_address
		rcp recipient_e-mail_address_list (separated by commas ",")
		cc  copy_e-mail_address_list (separated by commas ",")
		bcc blind_copy_e-mail_address_list (separated by commas ",")
		sub subject
		txt body_text
- start : starts the client
- show : displays the client interface ;
	It can be associated with a parameter containing any of
	sender, recipients, copy, blind copy, subject and body, each one on a line (separated by '\n') :
		snd flag sender_e-mail_address
		rcp flag recipient_e-mail_address_list (separated by commas ",")
		cc  flag copy_e-mail_address_list (separated by commas ",")
		bcc flag blind_copy_e-mail_address_list (separated by commas ",")
		sub flag subject
		txt flag body_text
	The values given are default values that will be sent with the mail.
	The client will be able to modify or append them according to the flag.
	The flag tells the client how to display the relative field :
		0 : field not displayed
		1 : value visible but read-only
		20 : value visible and append before
		21 : value visible and append after
		3 : value visible and alterable
		40 : value invisible and append before
		41 : value invisible and append after
- hide : hides the client interface
- destroy : destroys the client

There are 6 events :
- in : the client is started
- shown : the client interface is shown
- hidden : the client interface is hidden
- sent OK : the mail has been sent ; the subject is given as parameter
- sent KO : the mail has not been sent (an error occured) ; the subject is given as parameter
- destroyed : the client is destroyed

There is 1 zone
- Mail : mail interface zone (if no zone associated, the interface is a popup window)
