Documentation for Mr Happy - The Automatic Message Sender
          =========================================================
                  (Example CTL file enclosed with archive)

Mr Happy allows you to define any number of messages that may be written
into any area Hudson Format message area that you wish. You may define
netmail or echomail messages, which can be sent with date limiting.

There is no GEM front end to this program, the reason being I just haven't
got round to it - if there is enough interest then I may decide to do one
in the future, but don't hold your breath.

HAPPY.CTL format
================

Mr Happy is controlled by his domineering wife whose name is CTL, because
of the way of the world usually defines the man first, her full title is
HAPPY.CTL :)

There are five lines that usually always reside within the CTL file, they
are :

	NETMAIL
	DEFAULT_TO
	DEFAULT_FROM
	DEFAULT_SUBJECT
	DEFAULT_ADDRESS

NETMAIL drive:\path\file
-------

	This defines the path and stub of the Netmail area on your system, this
	file is used when sending Netmail (!)

DEFAULT_TO ~~~
DEFAULT_FROM ~~~
DEFAULT_SUBJECT ~~~
DEFAULT_ADDRESS ~~~
---------------

	Defines the defaults to be used when writing any messages


A send block must be defined for Mr Happy to know what to do ...

START_SEND       -  Defines the start of the block
END_SEND         -  marks the end of the block, when this control word is
                    read from the CTL file the parameters of the block are
                    checked and if necessary the message is sent.

	START_SEND/END_SEND must be matched pairs.

DATE CONTROLS
-------------

	At least one or more date controls are needed before a message can be
	sent, obviously defining a month and not a day(or date) means nothing
	and so the message send will be aborted - you can test your CTL file by
	entering DEBUG on the command line - this reports what Mr Happy found
	and what actions he would normally take - using DEBUG on the command
	line does not send any messages.

DAY (Mon Tue Wed Thu Fri Sat Sun)
---

	One day, and one day only may be specified with this control word -
	although you may have upto 7 DAY commands in each block.

DAYS ALL
--------

	This is one command - this is the same as 7 DAY commands.

MONTH (Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec)
-----

	As with DAY, one month and only one month may follow this command, but
	you can have upto 12 MONTH statements in a block.

DATE (01 - 31)
----

	Same again but for dates, one date per command line, upto 31 DATE
	commands per block - Date validity is not checked, so if it never
	occurs it'll never get sent.

MESSAGE DEFINITIONS
-------------------

	If normal EchoMail is sent then it is flagged as local, Netmail is
	flagged as local and private.

TO ~~~
--

	Defines the recipient of the message.

FROM ~~~
____

	Defines the sender of the message.

SUBJECT ~~~
-------

	Defines the subject of the message.

TO_ADDRESS n:n/n.n
----------

    Used for Netmail Addressing, if defined then Netmail status is assumed.

FROM_ADDRESS n:n/n.n
------------

	Used to define the senders address for Netmail, if defined that Netmail
	status is assumed.

FILE drive:\path\file.ext
----

	Defines the preformatted ASCII file to be sent as the message.

WINDOWS
=======

	such a little dear of a proggy doesn't use windows, and so you may put
	NOPRINT on the command line to prevent text output to the screen.

	Any error messages are then sent to an error log.

DEFAULTS & ERRORS
=================

	If you define a FROM_ADDRESS then you must define a TO_ADDRESS

	You can reassign DEFAULT_* statements *OUTSIDE* of send blocks.

	ERRORS are not logged - no logging is performed - if you think you have
	a problem, or would just like to test your CTL file then pass DEBUG on
	the command line to Mr Happy and he will write you a .DBG file.

	If you think you have discovered a bug then please send full details of
	the problem along with a .DBG file to me - I'll have a look and a
	laugh at it at my pleasure - what do you expect for free :)

CONTACT
=======

	Dave Meaker

	The Holodeck SbbS

	+44-454-880267 24Hrs V32b

	NeST 90:106/151.0
	Fido 2:255/43.0
	Trek 107:1709/0.0
	Fish 777:100/0.0