home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / fish / disks / d1048.lha / Programs / Event / Event.doc < prev    next >
Encoding:
Text File  |  1994-10-07  |  6.9 KB  |  282 lines
  1.  
  2.  
  3.  
  4.                             Event´er  1.17
  5.                             ==============
  6.                               2-Oct-94 mk
  7.  
  8.  
  9.  
  10. Preface
  11. -------
  12. The program and files in this distribution are freely distributable,
  13. but are also copyright (c) by Klaus Muckenhuber. They may be freely
  14. distributed as long as no more than a nominal fee is charged to cover
  15. time and copying costs.
  16.  
  17. No commercial usage is permitted without written permission from the
  18. author.  Everything in this distribution must be kept together, in 
  19. original unmodified form.
  20.  
  21. The above is generally known as freeware.
  22.  
  23. Please contact me if you have any comments or suggestions !!
  24.  
  25.  
  26.  
  27. Disclaimer
  28. ----------
  29. No warranties of any kind are made as to the functionality of 
  30. this program.  You are using it at your own risk.
  31.  
  32.  
  33.  
  34. Information:
  35. ------------
  36. With this software you have a good tool to remember everything you want.
  37.  
  38.  
  39.  
  40. Features:
  41. ---------
  42. * requiers only 12 kB memory (a primary argument!)
  43. * the event´s are storend in a data file
  44. * multitasking friendly
  45. * "gliding" event´s
  46. * loading only the Event´s from the current day
  47.  
  48.  
  49.  
  50. Installation:
  51. -------------
  52. 1. step
  53. Copy the hole drawer on your disk.
  54.     Workbench:    move the drawer icon with the mouse (drag & drop)
  55.     CLI:        copy df0:Event SYS:tools/Event all
  56.  
  57.  
  58. 2. step
  59. Add in your "S:user-startup" file the following lines
  60.  
  61. ; Startup Event´er
  62. run >NIL: SYS:tools/Event
  63.  
  64.  
  65. 3. step
  66. put in the "S:" directory your data file.
  67.  
  68.  
  69.  
  70.  
  71. Data-File
  72. ---------
  73.  
  74. Note:   At first Event´er search the data-file in the local directory,
  75.         second looking in the "S:" directory.
  76.  
  77.         The data-file must be named as "Event.data"
  78.  
  79.  
  80. The Data-File has the following description
  81.  
  82. 1. line     Delay time between the event test (default value=50)
  83.             Normally the value is set on 50 == 1 sec.
  84.             If you want saving your CPU power set the value 
  85.             on "200" ~2 sec´s
  86.             You can set the value between -2147483646 and 2147483647 (int)
  87.             Every value under 0 will have the same effect!
  88. 2. line     Delay time between the data file test. (default value=60)
  89.             Normally it will be set the value an 60 == 60 sec.
  90.             If you edit the file mostly you can set the value on a short
  91.             number, otherwise you can set a high value if you dont want
  92.             update from the datafile.
  93.             You can set the value between -2147483646 and 2147483647 (int)
  94. 3. line;    first Event TYP
  95. 4. line;    first Event DATE
  96. 5. line;    first Event TIME
  97. 6. line;    first Event MESSAGE
  98. 7. line;    second Event TYP
  99. 8. line;    second Event DATE
  100. .....
  101. ....
  102. ..
  103.  
  104.  
  105.  
  106.  
  107.  
  108. Event Options:
  109. --------------
  110.  
  111. Event TYP: (these are Flags, combinations are possible)
  112.     0   normal (aktiv DisplayBeep + Requester)
  113.     1   No DisplayBeep
  114.     2   No Requester
  115.     4   Quit Event´er 
  116.     8   Event Weekday   If you set this flag the value for the day will 
  117.         be interpreted as weekday:
  118.         -1.-1.01    every Monday
  119.         -1.-1.02    every Tuesday
  120.         -1.-1.04    every Wednesday
  121.         -1.-1.08    every Thursday
  122.         -1.-1.16    every Friday
  123.         -1.-1.32    every Saturday
  124.         -1.-1.64    every Sunday
  125.  
  126.         You can also combine the day´s when you added the Number´s:
  127.         -1.-1.96    only Saturday and Sunday
  128.         -1.-1.31    only Monday till Friday
  129.         -1.-1.05    only on Monday and Wednesday
  130.  
  131.     16  Once feature
  132.         If you define this option, the event will be displayed minimal ONE TIME!
  133.         A good reason to use this feature is a birthday. 
  134.             - You want to remember on a spezial day
  135.             - but the time is not fixed
  136.  
  137.         See the following examples:
  138.             16                  /* Typ: ONCE */
  139.             -1.05.30            /* Every year - in may - the 30. day */
  140.             16:00:00            /* Beginning at 16:00 a clock (4:00 pm) */
  141.             You must learn!     /* Message */
  142.  
  143.         If you start Event´er at 16:15:00 on this day - he will display the 
  144.         above event!
  145.  
  146.  
  147.  
  148. Event DATE:
  149.     Format: yy.mm.dd  (Year.Month.Day)
  150.     ie: 94.09.27
  151.  
  152. Event TIME:
  153.     Note: 24 Hours only (no am/pm shit)
  154.     Format: hh:mm:ss
  155.     ie: 16:55:09
  156.  
  157. Event MESSAGE:
  158.     You can enter everything you want - but only the first 60 
  159.     characters are loaded and displayed!
  160.  
  161.  
  162.  
  163. Spezial Feature:
  164. ----------------
  165.     With the "-1" statement by date or time you tell Event´er a gliding Event
  166.  
  167.     DATE
  168.     94.09.10    means 1994 September 10
  169.     94.09.-1    means every day in September 1994
  170.     94.-1.-1    means evers day 1994
  171.     -1.-1.01    means on each first month day 
  172.     -1.04.05    means every year the 4 day in may (ie: birthday..)
  173.     -1.-1.-1    means every Day
  174.  
  175.     DATE with set typ=8 (Weekday)
  176.     94.09.01    means every Monday in September 1994
  177.     94.-1.06    means every Saturday 1994
  178.     -1.-1.-1    means every Day
  179.     -1.01.05    means every Year in January every Friday
  180.     
  181.  
  182.     TIME
  183.     -1:00:00    means every full hour 
  184.     13:-1:00    means every minute in the time between 13:00:00 and 13:59:00
  185.     13:00:-1    means every second in the time between 13:00:00 and 13:00:59
  186.     -1:-1:00    means every full minute every hour
  187.     -1:15:00    means every hour 15 mins past beginning
  188.             and so on....
  189.  
  190.  
  191.  
  192. Example "Event.data" File:
  193. ------------------------
  194.  
  195. 100     ; delay between event test (100 == 2 sec)
  196. 60      ; delay between datafile test (60 == 60 sec)
  197. 0
  198. 94.10.04
  199. 19:00:00
  200. normal event like, with gudrun to cinema!
  201. 8
  202. -1.-1.31    ; 31 == Mo-Fr
  203. 08:00:00
  204. Begin Working ......
  205. 8
  206. -1.-1.31    ; 31 == Mo-Fr
  207. 17:30:00
  208. Finshed Working !!!!!
  209. 1
  210. -1.-1.-1
  211. 20:15:00
  212. looking in television, or forget it!
  213. 0
  214. -1.-1.-1
  215. 23:30:00
  216. YOU MUST GO TO BED!!!
  217. 2
  218. -1.-1.-1
  219. 22:59:00
  220. dummy; only a warning - no message
  221. 9
  222. -1.-1.01
  223. 17:00:00
  224. every Monday, training!
  225. 2
  226. -1.-1.-1
  227. 23:11:-1
  228. one minute - DisplayBeep!!!
  229. 8
  230. -1.-1.00
  231. 19:10:00
  232. Computerclub, only Sunday
  233. 16
  234. -1.05.04
  235. -1:00:00
  236. Birthday Mike !!!
  237. 4   ;Quit 
  238. 99.-1.-1
  239. -1:-1:-1
  240. set >99< to the current year - save it - Event´er will exit!
  241.  
  242.  
  243.  
  244. Remember:   Event´er will test your datafile about any modifcation, 
  245.             and if it was modified Event´er will reload the file!!
  246.  
  247.             Do not enter empty lines - every event must have 4 lines!
  248.  
  249.             WATCH ON CORRECT SYNTAX !!!!!
  250.  
  251.  
  252.  
  253. Future:     ? graphics interface
  254.             ? show error messages (in the moment only internal)
  255.             ? starting other programs
  256.             ? including time ressource management 
  257.                 (Event: start 8:00, end 9:00)
  258.             ? any wishes ?
  259.  
  260.  
  261.  
  262. History:
  263. --------
  264.  2-Oct-94  1.17  Fixing a MAYOR Bug - reloading and freeing event´s; (12556 Bytes)
  265. 25-Sep-94  1.16     The ONCE Eventtyp is born (12448 Bytes)
  266. 24-Sep-94  1.15     now it is possible to fix a group of days ie: Weekend, Mo-Fr.. (13036 Bytes)
  267. 18-Sep-94  1.14     added the weekday support (12448 Bytes)
  268. 17-Sep-94  1.05     added date support
  269. 15-Sep-94  1.02  added the QUIT feature
  270. 12-Sep-94  1.01     added the automatic load feature
  271. 11-Sep-94  1.0     first realease - privat  (10528 Bytes)
  272.  4-Sep-94        the idea
  273.  
  274.  
  275.  
  276. The Author:
  277. -----------
  278.     Klaus Muckenhuber
  279.     Markt 37
  280.     A-4625 OFFENHAUSEN
  281.     AUSTRIA
  282.