H     :HH
    HHH       H           HH   j.        HHHOOOo.      H     :HH
    HHH       H  .oOOOo.  HH  jHHf       HHH   `to     H     :HH
    HHH       H .H$' `$H. HH   `f        HHH    `:: .  H.    :HH
    HHHHHHHHHHH HH:   :HH HH             HHH     ::JH. `lOOOOOHH
    HHH       H HH:   :HH HH   HH        HHH     :JHfH.      :HH
    HHH       H lH$. .$H; HH   HH        HHH     JHf `H::OOOOOU'
    HHH       H  `^OOO^'  HH   HH        HHH    JHf   `H.
    HHH       H           `lOo `lOo      HHHOO:JHHHHHHHHH.
                                              JHf       `H.         v 0.3


                         (c) 1998 Andrew Fedorov



 1. Introduction.
 ================

 1.1. General.
 --------------

 MM_Holiday is an arexx-script for Mail Manager by Pino Aliberti. It can
automatically post messages reminding about some important events, holidays,
birthdays and anything else you want.

 Archive also contains the data file with basic list of events and examples
of descriptions for them.

 Script has a configuration file, do not forget to change all parameters to
suit your needs. BE CAREFUL - DO NOT OMIT ANY KEYWORDS.


 ----------------------------------------------------------------------------
  WARNING: This software is provided AS-IS, without warranty of any kind,
 either expressed or implied. In no event will the author be liable for
 direct, indirect, incidental or consequential damages or data loss resulting
 from the use or application of this software. The entire risk as to the
 results and performance of this software is assumed by the user.
 ----------------------------------------------------------------------------


 1.2. Requirements.
 ------------------

 Things are requiered for script to work:

 Path                      File
 ---------                 ---------------
 Sys:Rexxc                 rx
 MM:Rexx                   MM_HoliDay.rexx
 MM:Config                 MM_HoliDay.cfg

 And a registered version of Mail Manager should be running of course.


 1.3. Author.
 -------------

  Andrew Fedorov (Saint-Petersburg, Russia)

  If you have any suggestions and/or bug reports, send them to:

 FidoNet:                            2:5030/221.18@fidonet
 AmigaNet:                           39:240/100.18@amiganet


 2. Installation.
 ----------------

 There are two versions of MM_Holiday.rexx - in english and in russian.
Files are differ in suffixes - .eng and .rus accordingly. Remove these
suffixes in files of your language before use.

 Copy files:

 MM_HoliDay.rexx    to   MM:Rexx
 MM_HoliDay.cfg     to   MM:Config

 MM_HoliDay.data   \
 MM_Holiday.B.text  \ copy to any
 MM_Holiday.D.text  / directory you like.
 MM_Holiday.H.text /

 Then make changes in configuration file following explanations given there.


 2.1. Creating events data file and texts of messages.
 -----------------------------------------------------

 Events data file is a plain text file with following format:

   Date in           Kind of         Number of
 format DD/MM         event         key phrases
 (5 symbols)        (1 symbol)     (not limited)
   |                    |                |
   |    ________________|                |
   |   |  _______________________________|
   |   | |
 25/12 H 1

 After that follows n lines of key phrases (in this case n=1). Each key
phrase will be placed in message in order of its number.

 Key in text of a message starts from symbol "%" followed with number of key
phrase.

 Example:

 In events data file:
 ...
 25/12 H 1
 Christmas
 ...


 In text of message:
 ...
 I wish you a Merry %1, my friends!!!
 ...


 As a result we'll get a message dated 25 december:
 ...
 I wish you a Merry Christmas, my friends!!!
 ...

 Any "%" symbol in message text must be followed by number of key phrase. If
it not, this most likely lead to an error.


 3. Usage.
 ----------

 rx MM_HoliDay.rexx

 Script does not require any parameters. Each time you start the script, it
looks in events data file to find an event that matches with current date.
So it will be enough to run script once a day.


 4. History.
 -----------

 Version 0.3

  - Added work with keys;
  - Changed format of an events data file;
  - Added a config file.

 Versions 0.1 - 0.2

  - Internal test versions.


 5. Thanks.
 -----------

 Pino Aliberti         for his excelent Mail Manager!
 NOP                   for help and support.
 Antony Semenihin      for english translation.
 Eugene Stepanoff      dunno for what... :)