


                            Event´er  1.17
                            ==============
                              2-Oct-94 mk



Preface
-------
The program and files in this distribution are freely distributable,
but are also copyright (c) by Klaus Muckenhuber. They may be freely
distributed as long as no more than a nominal fee is charged to cover
time and copying costs.

No commercial usage is permitted without written permission from the
author.  Everything in this distribution must be kept together, in 
original unmodified form.

The above is generally known as freeware.

Please contact me if you have any comments or suggestions !!



Disclaimer
----------
No warranties of any kind are made as to the functionality of 
this program.  You are using it at your own risk.



Information:
------------
With this software you have a good tool to remember everything you want.



Features:
---------
* requiers only 12 kB memory (a primary argument!)
* the event´s are storend in a data file
* multitasking friendly
* "gliding" event´s
* loading only the Event´s from the current day



Installation:
-------------
1. step
Copy the hole drawer on your disk.
	Workbench:	move the drawer icon with the mouse (drag & drop)
	CLI:		copy df0:Event SYS:tools/Event all


2. step
Add in your "S:user-startup" file the following lines

; Startup Event´er
run >NIL: SYS:tools/Event


3. step
put in the "S:" directory your data file.




Data-File
---------

Note:   At first Event´er search the data-file in the local directory,
        second looking in the "S:" directory.

        The data-file must be named as "Event.data"


The Data-File has the following description

1. line     Delay time between the event test (default value=50)
            Normally the value is set on 50 == 1 sec.
            If you want saving your CPU power set the value 
            on "200" ~2 sec´s
            You can set the value between -2147483646 and 2147483647 (int)
            Every value under 0 will have the same effect!
2. line     Delay time between the data file test. (default value=60)
            Normally it will be set the value an 60 == 60 sec.
            If you edit the file mostly you can set the value on a short
            number, otherwise you can set a high value if you dont want
            update from the datafile.
            You can set the value between -2147483646 and 2147483647 (int)
3. line;    first Event TYP
4. line;    first Event DATE
5. line;    first Event TIME
6. line;    first Event MESSAGE
7. line;    second Event TYP
8. line;    second Event DATE
.....
....
..





Event Options:
--------------

Event TYP: (these are Flags, combinations are possible)
    0   normal (aktiv DisplayBeep + Requester)
    1   No DisplayBeep
    2   No Requester
    4   Quit Event´er 
    8   Event Weekday   If you set this flag the value for the day will 
        be interpreted as weekday:
        -1.-1.01    every Monday
        -1.-1.02    every Tuesday
        -1.-1.04    every Wednesday
        -1.-1.08    every Thursday
        -1.-1.16    every Friday
        -1.-1.32    every Saturday
        -1.-1.64    every Sunday

        You can also combine the day´s when you added the Number´s:
        -1.-1.96    only Saturday and Sunday
        -1.-1.31    only Monday till Friday
        -1.-1.05    only on Monday and Wednesday

    16  Once feature
        If you define this option, the event will be displayed minimal ONE TIME!
        A good reason to use this feature is a birthday. 
            - You want to remember on a spezial day
            - but the time is not fixed

        See the following examples:
            16                  /* Typ: ONCE */
            -1.05.30            /* Every year - in may - the 30. day */
            16:00:00            /* Beginning at 16:00 a clock (4:00 pm) */
            You must learn!     /* Message */

        If you start Event´er at 16:15:00 on this day - he will display the 
        above event!



Event DATE:
    Format: yy.mm.dd  (Year.Month.Day)
    ie: 94.09.27

Event TIME:
    Note: 24 Hours only (no am/pm shit)
    Format: hh:mm:ss
    ie: 16:55:09

Event MESSAGE:
    You can enter everything you want - but only the first 60 
    characters are loaded and displayed!



Spezial Feature:
----------------
    With the "-1" statement by date or time you tell Event´er a gliding Event

    DATE
    94.09.10    means 1994 September 10
    94.09.-1    means every day in September 1994
    94.-1.-1    means evers day 1994
    -1.-1.01    means on each first month day 
    -1.04.05    means every year the 4 day in may (ie: birthday..)
    -1.-1.-1    means every Day

    DATE with set typ=8 (Weekday)
    94.09.01    means every Monday in September 1994
    94.-1.06    means every Saturday 1994
    -1.-1.-1    means every Day
    -1.01.05    means every Year in January every Friday
    

    TIME
    -1:00:00    means every full hour 
    13:-1:00    means every minute in the time between 13:00:00 and 13:59:00
    13:00:-1    means every second in the time between 13:00:00 and 13:00:59
    -1:-1:00    means every full minute every hour
    -1:15:00    means every hour 15 mins past beginning
            and so on....



Example "Event.data" File:
------------------------

100     ; delay between event test (100 == 2 sec)
60      ; delay between datafile test (60 == 60 sec)
0
94.10.04
19:00:00
normal event like, with gudrun to cinema!
8
-1.-1.31    ; 31 == Mo-Fr
08:00:00
Begin Working ......
8
-1.-1.31    ; 31 == Mo-Fr
17:30:00
Finshed Working !!!!!
1
-1.-1.-1
20:15:00
looking in television, or forget it!
0
-1.-1.-1
23:30:00
YOU MUST GO TO BED!!!
2
-1.-1.-1
22:59:00
dummy; only a warning - no message
9
-1.-1.01
17:00:00
every Monday, training!
2
-1.-1.-1
23:11:-1
one minute - DisplayBeep!!!
8
-1.-1.00
19:10:00
Computerclub, only Sunday
16
-1.05.04
-1:00:00
Birthday Mike !!!
4   ;Quit 
99.-1.-1
-1:-1:-1
set >99< to the current year - save it - Event´er will exit!



Remember:   Event´er will test your datafile about any modifcation, 
            and if it was modified Event´er will reload the file!!

            Do not enter empty lines - every event must have 4 lines!

            WATCH ON CORRECT SYNTAX !!!!!



Future:     ? graphics interface
            ? show error messages (in the moment only internal)
            ? starting other programs
            ? including time ressource management 
                (Event: start 8:00, end 9:00)
            ? any wishes ?



History:
--------
 2-Oct-94  1.17  Fixing a MAYOR Bug - reloading and freeing event´s; (12556 Bytes)
25-Sep-94  1.16	 The ONCE Eventtyp is born (12448 Bytes)
24-Sep-94  1.15	 now it is possible to fix a group of days ie: Weekend, Mo-Fr.. (13036 Bytes)
18-Sep-94  1.14	 added the weekday support (12448 Bytes)
17-Sep-94  1.05	 added date support
15-Sep-94  1.02  added the QUIT feature
12-Sep-94  1.01	 added the automatic load feature
11-Sep-94  1.0	 first realease - privat  (10528 Bytes)
 4-Sep-94        the idea



The Author:
-----------
	Klaus Muckenhuber
	Markt 37
	A-4625 OFFENHAUSEN
	AUSTRIA
