Description

  DST.PRG sets daylight saving time automatically in the summer and 
  reverts back to non-daylight saving time in the winter. The default 
  setting is one hour forward at 3 am on the last Sunday of March, and 
  one hour back at 3 am on the last Sunday of October. Other settings 
  can be specified in the info file (see below).
  
Usage

  The program is only useful if your computer has an internal clock. 
  If it hasn't, you can still run it after start-up and it will work.
  
  Put DST.PRG in your AUTO folder. It should be the last in the folder 
  (but always before MiNT). Put DST.INF in your boot drive (not in the 
  AUTO folder) and change the number in the first line of the file, if 
  necessary (0 for winter, 1 for summer). All verbal output is sent to 
  the screen and to a log file, which is automatically created 
  (X:\dst.log\dst, when the environment variable "LOGDIR" is not 
  accessible, else $LOGDIR\dst - see below under "Bugs").
  
  Settings other than the default can be specified in the second, third 
  and fourth lines of DST.INF. The second line is for the offset 
  (difference between daylight saving time and "normal" time), and the 
  third and fourth lines are for the begin and end time/date 
  respectively.
  
  The offset must be specified in the familiar time format HH:MM:SS. 
  Minutes and seconds, as well as leading zeros, are optional i.e. 
  01:00:00 is equivalent to 1:0:0, is equivalent to 1:0, is, indeed, 
  equivalent to 1.
  
  For the begin and end time/date the format is the following: first the 
  number of the month in which the change takes place (January=1, 
  December=12), second the week of the month in which the hour changes (5 
  is the last week), third the day of the week it happens (Sunday=0, 
  Saturday=6), and fourth the exact hour at which the transition takes 
  place. The numbers are separated by dots/full stops, the hour is again 
  in the familiar time format. (WARNING: if you specify the begin and/or 
  end date, you cannot skip the offset, even if it's the default value, 
  as that would leave the second line empty, or with the wrong 
  parameter.)
  
  Example.
  
  The following is a sample DST.INF file for a zone where daylight 
  saving time is twenty minutes, starting at the first Sunday of April, 
  and ending at the first Sunday of November, at 2 and 3 o'clock in the 
  morning respectively:
  
                 0                         (summer or winter value)
                 0:20                      (offset)
                 4.1.0.02:00:00            (begin time)
                 11.1.0.3                  (end time)
            
  Empty lines and lines beginning with `#' (for comments) are skipped. 
  Be sure to keep the right order, though.
  
  The program can be run independently as well. For test purposes, use 
  option `-t' on the command line with the name (full path) of the 
  dst.inf file (you might want to use another configuration file than 
  c:\dst.inf for test purposes). The program will not take any action 
  then, but prints all settings and issues a warning if DST is to be 
  changed. Option `-c' can be used to change the existing dst.inf file 
  into binary form, or vice versa. Used with an argument, it will work 
  on the file mentioned in the argument, or the default dst.inf file 
  (c:\dst.inf) if no argument is used.
  
Postcardware

  This program is "postcardware", so please send me a postcard if you 
  use it.
  
Bugs

  For reasons unknown to me, environment variables are not accessible by 
  AUTO-folder programs, hence DST.PRG cannot read either the "TZ" or 
  "LOGDIR" environment variables. Environment variables are accessible 
  by programs executed by MiNT, but for some reason, which I haven't 
  been able to ascertain, executing DST.PRG (or DST.TTP) by MiNT makes 
  the system go awry.
  
  For the rest: every non-trivial program contains at least one bug. 
  Please report to me if you find one.

Distribution

  DST.PRG may be freely distributed, provided this file is included in 
  the distribution.
  
Disclaimer

  Use this program at your own risk. I will not accept any liability 
  for damage caused by this software.


Jos den Bekker

Address:
Rhijnvis Feithstraat 35
1054 TV  Amsterdam

Email:
<josdb@xs4all.nl>

WWW:
http://www.xs4all.nl/~josdb

-----------------------------------------------
History after first release:

Version 1.4 (March 1997):

  - Option -t for `test' added.
  - Comments in info file.
  - Bug in setting minute and second values fixed.
  - Bug in transition from DST to STD - `ping-pong effect' - fixed; 
    thanks to Bruno Kozlowski <bkozlowski@nordnet.fr>.

Version 1.5 (April 1997):

  - Option -c added for changing configuration file into binary form, 
    or vice versa.
  