Epoch CLI V1.0
                       (C) C.S.J.Brady 1994

This  program  may  be freely distributed, no fee is required either from 
people distributing the program or from people using the program.  People 
distributing  the  program may not make more than a reasonable charge for 
distributing the program to cover disks and postage.  The distribution by 
0898  BBSs  or  any  BBS  claiming  copyright  to  file  on the system is 
particularly forbidden.

J. Pritchard  has  been specifically granted the right to distribute this 
program and document with his own program Epoch Master.

NO  ONE  may  tamper with this software in any way; this includes, but is 
not limited to, reverse  engineering, recompiling, editing the executable 
or document files.

Epoch CLI was written in C using DICE on a very old Amiga 500 with WB1.3, 
and although Epoch CLI is FREEWARE I would like to upgrade my machine :-)

This  program  uses  the  file  S:EpochCal which is produced by a program 
called  Epoch  Master  which  is  (C) J. Pritchard 1994.  Epoch Master is 
SHAREWARE;  shareware  contributions of £10 should be sent to J.Pritchard 
at HIS address below.

Epoch  CLI  was written by me as an alternative to EpochGlance written by 
J. Pritchard.  EpochGlance  requires  that  the user uses the mouse while
scanning  the directory outside the main Epoch Master program, and prints
its output to a separate window.

NB: The first argument must be the calendar file that you wish to read.

The   output  from Epoch CLI can be made to go straight to the CLI window 
from  which  it  was  run from.  Output from the program can therefore be 
directed  to a file in the normal CLI/Shell way i.e. "program >PATH:file" 
sends  the  output to a new file (a file will be created automatically, a 
file  with  the same name, if present, is DELETED).  The command "program 
>>PATH:file"  will send the output to a new file, if a file called "file" 
doesn't exist, or  it  will  append  the  output  to the file if the file 
already exists.

If  you  wish  to  use redirection when using Epoch CLI please use the -p
option as this will stop the program waiting for the user to press return
after each entry and also sends the output to the CLI/SHELL window (which 
is needed when using redirection).  To do this type :-

      epoch_cliV1.0 >>ram:diary.txt s:epochcal -p

Replace s:epochcal with the filename that you use.

To use this program in your startup-sequence I recommend that you use the
following lines in the startup-sequence of your system (boot) disk:-

ask "*e[33mCheck Diary ?*e[0m {y/n}"
if WARN
   epoch_cliV1.0 s:epochcal
   echo "Checked Diary"
else
   echo "Did not check diary"
endif

Please  ensure  that  you have the commands "ask", "if", "else", "endif",
"echo"  and  "epoch_cliV1.0"  available  on  the  current  (search) path,
for example in the C: directory of the system (boot) disk.

Epoch_CLI  uses  the  system date and so you need to have set your system 
clock  before  you  run the program, using "setclock load".  If you don't 
have a system clock use the "-i" option when running the program, as this 
stops the program loading and using the system date.  There is no need to 
use  this option with the "-p" option as the system date is not currently 
used  when  using the "-p" option.  There is no need to use the -c option 
if you use the -i option (see later).

The  -c  option  stops the program from searching for the next entry that 
will occur (which is the  default).  If you don't use this option you may 
find  that  the program starts displaying on, for example, the 6th entry, 
this is not a bug !

If you use  the  option "-s" when running Epoch_CLI then you will only be 
given a brief summary of each entry in your S:epochcal file.  This option 
can  be  used  in  conjunction  with the "-p" option to create a table of 
entries.

At  the  moment  this program can NOT read encrypted calendar files, this 
will hopefully change soon; if a file is saved with a password but is not 
encrypted this program reads the file anyway !

You  will  be  told if there are any notes relating to the entry but they
will not be displayed.

If you have any  questions, comments or queries relating to Epoch_CLIV1.0
then please write to me (Chris Brady) at my address below.

If you have any  questions, comments, or queries relating to Epoch Master
then please write to J. Pritchard at his address.

        Chris Brady,                           J. Pritchard,
        (epoch_cliV1.0)                        (Epoch Master)
        5 Hill Grove,                          5 Parklands Close,
        Salendine Nook,                        Gosport,
        Huddersfield.                          Hampshire.
        West Yorkshire.                        
        England.                               England.
        HD3 3TL.                               PO12 4XJ


Please support the AMIGA by sending the SHAREWARE fee to J.Pritchard, and 
send me a postcard of your home town if you can.

Chris Brady