home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / util / boot / ClockChk11.readme < prev    next >
Encoding:
Text File  |  1997-03-02  |  4.6 KB  |  122 lines
  1. Short:  Keeps track of clock changes, V1.1
  2. Author: christian.wasner@hamburg.netsurf.de
  3. Type:   util/boot
  4. Author: christian.wasner@hamburg.netsurf.de
  5.  
  6.  
  7. Introduction:
  8.  
  9. This program is extremely useful when you need proper clock settings
  10. on your computer.  It's extremely annoying if some buggy software
  11. trashes the clock settings and e.g.  the newsreader sets the date of
  12. incoming news to 2023 (which happened to the author some days ago...
  13. that was the reason for writing this program).
  14.  
  15. Function:
  16.  
  17. When the program is started, it first checks when the last session on
  18. your Amiga was.  If the date differs from the current date by more
  19. than a certain number of days (which can be set via an environment
  20. variable), you will be notified about that and you can let the program
  21. autostart the time preferences program.  After that the clock is
  22. checked each second.  If it changes by more than one minute, a
  23. requester pops up.
  24.  
  25. The program can be ended by sending a CTRL-C signal to it, but that's
  26. not necessary because it uses very little memory and nearly no CPU
  27. time.
  28.  
  29. Installation:
  30.  
  31. Copy program to C: and enter the following line into s:user-startup
  32.  
  33. run <>nil: ClockChk
  34.  
  35. When ClockChk is started the very first time, the date of the last
  36. setting will obviously not be present and a requester will pop up that
  37. informs you about that.  Hit "Ignore" in this case.
  38.  
  39. Configuration:
  40.  
  41. ClockChk is configured by setting environment variables.  Don't forget
  42. to copy them to ENVARC: if you want to set them.
  43.  
  44. DAYDIFF
  45.    Contains the number of days that may lie between two sessions
  46.    without being notified by setting the environment variable DAYDIFF.
  47.    The default value is 3 which will be used when the variable isn't
  48.    set up or if it's invalid.
  49.  
  50. TIMEPREFS
  51.    Contains the full path of the Time Preferences editor.  If it isn't
  52.    set, SYS:Prefs/Time will be used.
  53.  
  54. LASTDATE
  55.    Contains the date and time of the last session.  You don't need to
  56.    bother about this variable.  If it's invalid or not present (the
  57.    latter will happen with the very first run of ClockChk), you will
  58.    be notified and after that the current date is saved to it.
  59.  
  60. Bugs:
  61.  
  62.    None known. However, it must be said that this program has to write
  63.    to ENVARC: in order to save the current session's date. If the
  64.    write operation fails, you will be notified about that, of course.
  65.  
  66. Disclaimer
  67.  
  68. The author cannot be held liable for the suitability or accuracy of
  69. this manual and/or the program(s) it describes.  Any damage directly
  70. or indirectly caused by the use or misuse of this manual and/or the
  71. program it describes is the sole responsibility of the user her/him
  72. self.
  73.  
  74. Copyright/Distribution
  75.  
  76. All files mentioned below are (C) Copyright 1997 Christian Wasner.
  77. All rights reserved.
  78.  
  79. These files/programs are FREEWARE, so no financial donations are
  80. required (but welcome).  They may be freely distributed as long as all
  81. files remain unchanged and are included with the distribution.
  82. Distribution on disks or CDs is permitted only on the disks or CDs
  83. from Fred Fish, the Aminet CDs, from disks that cost less than $1 or
  84. from CDs that cost less then $20.  Electronical distribution (e.g.  by
  85. Aminet, mailboxes, modems) is allowed.  Inclusion into freeware
  86. software packages is allowed, inclusion into other packages (e.g.
  87. commercial or shareware) must be expressly allowed by me in written
  88. form.
  89.  
  90. The following files should come along:
  91.  
  92. ClockChk             Executable program                 6088 bytes
  93. ClockChk11.readme    Documentation                      4185 bytes
  94. ClockChk.c           Source code                        7800 bytes
  95. SCOPTIONS            Options for compiling with SAS-C    196 bytes
  96. FILE_ID.DIZ          Mailbox description                 388 bytes
  97.  
  98.  
  99. History:
  100.  
  101.    05-Feb-97 V1.0   - Initial release
  102.  
  103.    12-Feb-97 V1.1   - Aminet version showed version 0.1 on "version"
  104.                       command.
  105.                     - File list contained wrong name of documentation.
  106.                     - Date of current session wasn't saved correctly
  107.                       when detecting a date discrepancy with the last
  108.                       session's date along with correcting the date.
  109.  
  110.  
  111. ============================= Archive contents =============================
  112.  
  113. Original  Packed Ratio    Date     Time    Name
  114. -------- ------- ----- --------- --------  -------------
  115.     6088    3355 44.8% 12-Feb-97 00:20:54  ClockChk
  116.     7800    2620 66.4% 12-Feb-97 00:20:44  ClockChk.c
  117.     4185    1918 54.1% 12-Feb-97 00:27:12  ClockChk11.readme
  118.      388     209 46.1% 12-Feb-97 00:25:46  FILE_ID.DIZ
  119.      196     142 27.5% 05-Feb-97 19:56:48  SCOPTIONS
  120. -------- ------- ----- --------- --------
  121.    18657    8244 55.8% 12-Feb-97 14:58:02   5 files
  122.