Cal
    ~~~
          This  is  my  first  program  which  really  makes  use  of
    Kickstart2.04, as a matter of fact, you NEED Kickstart2.04 to run
    it! (So you better run out and buy it right now..)


    What is Cal?
    ~~~~~~~~~~~~
       Cal is a kind of diary which helps you to keep  track  of  all
    those things you have to do, like making that dentist appointment
    (sigh!),  pay  your bills etc. etc. It is extremly small (written
    in  assembler)  and  quite  fast  and  easy  to  use.  The   only
    requirement  is  that  you  have  the new Kickstart and two files
    located on your disk. The first file is  of  course  the  program
    'Cal'  and  the  second  is  the  datafile, 'S:Calendar' which is
    a plain textfile which you can create using any editor.

    Why Cal?
    ~~~~~~~~
       I've seen a lot of  diary-programs,  some  mouse-driven,  some
    with  their  own appointment-editor etc. etc. Other requires that
    font, or that library. All of them are rather  big.  Cal  uses  a
    plain textfile, (with a very flexible format), is (currently) 712
    bytes  small and removes any old appointments automatically. Even
    if you are a floppy user you can  install  it  in  your  startup-
    sequence  since it works fast and load fast. (Buffered input) You
    could also use it as a 'Today'-program if you run a BBS (but have
    someone else building the Calendar-file for you...).  Output  may
    be redirected anywhere.


    Cal's syntax is

    Cal [-c] [dyy-mm-dd]

    Please note the order of the parameters!

    [-c]
       Cleanup. Will run Cal as usual, but will remove all old  dates
    and  notes  from  S:Calendar.  All notes which are older than the
    current date will be removed. You need to have your  disk  write-
    enabled.

    [dyy-mm-dd]
       Substitute todays date with this date.

    Examples (todays date is 92-02-22) :

    INPUT : Cal
    OUTPUT: 92-02-22 Well, yet another day... :-)

    INPUT : Cal d92-02-19
    OUTPUT: 92-02-19 Don't forget to bring that disk tomorrow.

    INPUT : Cal -c
    OUTPUT: 92-02-22 Well, yet another day... :-)

    INPUT : Cal d92-02-19
    OUTPUT: (Nothing, this entry has been erased from the file)


    S:Calendar
    ~~~~~~~~~~
       The format of this file is quite simple. Before  any  of  your
    dates  you  may  place  some text which you want Cal to greet you
    with each time it is run.  If  you  don't  want  any  text  start
    entering  the  dates  directly.  The dates must be located on the
    beginning of a line, and have the  form  yy-mm-dd  (year,  month,
    day). The Calendar-file may contain empty  lines anywhere and the
    dates may be in any order.

    Examples :

    Hi Niklas!
    Let us see what you have to do today....

92-08-03 Hey! This is my birthdate.
92-02-19 Don't forget to bring that disk tomorrow.


    Another example :

92-08-03 Hey! This is my birthdate.
92-02-22 Finish Cal today.
         Don't forget meeting at 15.00
         Promised go shopping (sigh!!)
92-08-03 Still is my birthdate, but placed after 92-02-22..

    You could also have written :

92-08-03 Hey! This is my birthdate.
92-02-22 Finish Cal today.
92-02-22 Don't forget meeting at 15.00
92-02-22 Promised go shopping (sigh!!)
92-08-03 Still is my birthdate, but placed after 92-02-22..


    ACKS
    ~~~~
    Cal is PD, use it as much as you like, anywhere you like.

    Niklas Sjöberg, 92-02-22
    2:203/415.3@FidoNet