home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / home / misc / 018 / anytime.doc < prev    next >
Encoding:
Text File  |  1992-12-30  |  8.9 KB  |  192 lines
  1.  
  2.                        Any-Time Version 1.0  by  RejTech
  3.                        - - - - - - - - - - - - - - - - -
  4.                           Copyright(c) 1992, RejTech
  5.                                  P.O. Box 721247
  6.                       Oklahoma City, Oklahoma  73172-1247
  7.  
  8.  
  9.    OVERVIEW:
  10.    ---------
  11.       ANYTIME is a program which will display the current time in up
  12.       to eleven cities (worldwide) simultaneously.  The program uses
  13.       a modern user interface which is very simple to use and can be
  14.       controlled either from the keyboard or with a mouse.  The cities
  15.       displayed are selected from a database which currently contains
  16.       over 1300 entries and may be customized using any ASCII text
  17.       editor.
  18.  
  19.  
  20.    INSTALLATION:
  21.    -------------
  22.       Simply copy all files to any desired directory.
  23.  
  24.       Files contained on the installation disk:
  25.           ANYTIME.EXE   - Main Program File
  26.           ANYTIME.CFG   - Stores Current Program Configuration
  27.           ANYTIME.DOC   - Documentation for ANYTIME.EXE (this file)
  28.           REJTECH.COM   - Software Registration Module
  29.           REGISTER.BAT  - Batch procedure to print registration form
  30.                           and receive a discount for registering both
  31.                           ANYTIME and SUNTIME together.
  32.           CITIES.DAT    - City Data File
  33.           TIMEZONE.DAT  - Time Zone Definition File
  34.  
  35.       Both data files (CITIES.DAT and TIMEZONE.DAT) are required for
  36.       operation and must be in the same directory as ANYTIME.EXE.
  37.  
  38.    OPERATION:
  39.    ----------
  40.       Using this program is very simple.  To start the program from DOS
  41.       simply type "ANYTIME" and hit <Enter> at the DOS prompt.  When the
  42.       program has been activated, just select one of the 4 buttons shown
  43.       at the bottom of the screen (by pressing the indicated function key
  44.       or clicking on the button with your mouse):
  45.  
  46.           [About]  - Supplies version and registration information
  47.                      about the program.
  48.  
  49.           [Cities] - Allows selection of a new city to replace one of
  50.                      the currently displayed cities.  Three picklists
  51.                      will be displayed in succession to complete this
  52.                      process.  To select an entry from a pick-list,
  53.                      simply scroll thru the list using your mouse and
  54.                      the scroll-bar at the right or by using the cursor
  55.                      keys.  When the desired entry is highlighted,
  56.                      press enter or click on that entry to select it.
  57.  
  58.                        Any-Time Version 1.0  by  RejTech
  59.                        - - - - - - - - - - - - - - - - -
  60.  
  61.    OPERATION (Continued):
  62.    ----------------------
  63.  
  64.                      1st picklist:  Selects a new city to replace an
  65.                            existing entry shown on the screen.
  66.                      2nd picklist:  Selects the slot containing the old
  67.                            entry that is to be replaced.
  68.                      3rd picklist:  Selects the time zone associated
  69.                            with the new city.  Initially, the default
  70.                            time zone for the city will be highlighted.
  71.                            To select it, simply press <Enter>.  Note:
  72.                            for automatic daylight savings time adjust-
  73.                            ments, always select the default (STANDARD)
  74.                            time zone for the city.
  75.  
  76.                      At any time during this process, you can hit <Esc>
  77.                      or click with the mouse cursor outside of the pick-
  78.                      list window to cancel the selection.
  79.  
  80.           [Zones]  - Selects the base time zone for the computer.  This
  81.                      selection only needs to be made once when the program
  82.                      is installed and thereafter only when the time changes
  83.                      from STANDARD to DAYLIGHT (or vice versa).  This base
  84.                      time zone is displayed on line 2 of the program window
  85.                      along with the current computer time.  This must be
  86.                      correct to enable the program to compute the correct
  87.                      time in the cities selected.
  88.  
  89.           [Exit]   - Ends the program.  Your current configuration will be
  90.                      saved before exiting the program, therefore the next
  91.                      time you execute "ANYTIME", the same cities will be
  92.                      shown.
  93.  
  94.  
  95.    DATA FILES:
  96.    -----------
  97.       The data files CITIES.DAT and TIMEZONE.DAT are simple ASCII text
  98.       files which can be edited with any ASCII text editor.  You may add
  99.       or delete cities at will, but fields must begin in the same column
  100.       on each line (one city per line), therefore your text editor should
  101.       not insert any 'TAB' characters.   Comment lines may be inserted in
  102.       the files by placing an asterisk in column 1.
  103.  
  104.  
  105.                        Any-Time Version 1.0  by  RejTech
  106.                        - - - - - - - - - - - - - - - - -
  107.  
  108.    DATA FILES (Continued):
  109.    -----------------------
  110.       The CITIES.DAT file currently contains over 1300 cities which have
  111.       been compiled from several sources.  The program should be able to
  112.       handle up to 2600 entries (128K of data).   The current data is
  113.       believed to be correct for the most part, but no guarantee can be made
  114.       as to its accuracy.  Latitude and longitude information is not required
  115.       for ANYTIME.EXE, as long as a valid time zone (as defined in TIMEZONE.
  116.       DAT) is entered.
  117.  
  118.       The TIMEZONE.DAT file defines time zones used in CITIES.DAT.  All 24
  119.       time zones are currently defined here along with several location-
  120.       specific time zones.  For areas where a non-standard time zone is used
  121.       (Saudi-Arabia, etc), a code of 'XXX' should be placed in the 'CITIES
  122.       .DAT' file.  This will cause the standard time to be computed based on
  123.       the longitude of the city.
  124.  
  125.       Note - The 3-digit time zone code MUST match in both files.  If you
  126.              decide to change this in the TIMEZONE.DAT file, you must also
  127.              change each occurance of it in the CITIES.DAT file.
  128.  
  129.            - The program SUNTIME.EXE also uses these same data files.  If
  130.              you are using both programs, keep them in the same directory
  131.              so that they may each share a single copy of the data files.
  132.  
  133.  
  134.    DAYLIGHT SAVINGS TIME:
  135.    ----------------------
  136.       If the 'Auto DST' flag in the CITIES.DAT file is set to 'Y' for the
  137.       chosen city, that city is assumed to use the standard "Daylight Savings
  138.       Time" pattern adopted by the United States.  Under this system, day-
  139.       light savings time begins on the first Sunday in April and ends on the
  140.       last Sunday in October.   If a city does not follow this pattern, this
  141.       flag should be set to 'N'.  You will then need to manually select a
  142.       time zone corresponding to daylight savings time when it is in effect.
  143.  
  144.  
  145.    SOFTWARE LICENSE REGISTRATION:
  146.    ------------------------------
  147.       This program is copyrighted shareware and should be registered if
  148.       you find it useful and intend to use it.   A single user registration
  149.       fee is only $5.00.
  150.  
  151.       To register, select the <About> button in the programs main window,
  152.       then select the <Register> button.  You will then be prompted for
  153.       required information and a mailable registration form will be
  154.       printed on your system printer.  If this process fails or you do
  155.       not have a printer connected to LPT1, send your name, address and
  156.       and $5.00 (Check or MO, U.S.) to:
  157.  
  158.                        RejTech, ANYTIME Registration
  159.                        P.O. Box 721247
  160.                        Oklahoma City, Oklahoma  73172-1247.
  161.  
  162.       Please state version number so that I can be sure you have the latest
  163.       release.
  164.  
  165.       You may freely distribute the original program package to anyone that
  166.       you think might benefit from it, provided all the files stated above
  167.       are supplied intact and unaltered, including the REJTECH.COM file.
  168.  
  169.       Thanks for your support.
  170.  
  171.  
  172.                        Any-Time Version 1.0  by  RejTech
  173.                        - - - - - - - - - - - - - - - - -
  174.  
  175.    WARRANTY:
  176.    ---------
  177.       This program is provided on an AS-IS basis WITHOUT warranty of
  178.       any kind.  As with all computer software, it could contain logic
  179.       errors which might give erroneous results.  RejTech will not be
  180.       held liable for any damages, whether direct or consequential,
  181.       arising from the use of this software.
  182.  
  183.  
  184.       Please direct any comments or report any bugs to the address given
  185.       above.  You may also leave me a message on CompuServe.
  186.  
  187.                                           Rob Jordan, RejTech
  188.                                           CompuServe ID: 70515,722
  189.  
  190.  
  191.  
  192.