X World Clock   Vers. 1.0              		Wilfried Kienemund
------------------------------------------------------------------

Purpose
-------
This exciting alarm clock will show you different time zones 
simultaneously, as well as set off an alarm for an important 
appointment.  For those people who work with clients on opposite 
ends of the world, this clock is a must.                    


Usage Notes
-----------
World Clock with eXtended setup for all time displays, time zones and
alarms to any city or country in the world.   It requires the 
presence of VBRUN100.DLL in your Windows directory.  VBRUN100.DLL is 
on the PC Magazine Windows Premium disk -- unzip VBRUN1.ZIP to find 
it.  Be sure you copy VBRUN100.DLL into the directory containing 
your Windows program files.

1. Install

Unzip the file WCLOCK.ZIP and copy XCLOCK.EXE, XCLOCK.CFG, 
XCLOCK.DAT, XCLOCK.INI and XCLOCK.TXT to your hard disk.

With the Program Manager group active where you want XCLOCK to 
be located, select File then New.  Fill in the boxes and enter the 
path (for example, C:\WINDOWS\ACCESS\) followed by XCLOCK.EXE.  You 
can use the BROWSE button to find the file.  The XCLOCK icon will 
appear in the active program group.

(Start XCLOCK and choose Help / Read Doc to read the documentation 
file.)


2.  Setup

 Choose Set from menu of X World Clock.

 Set Local :  Set the Local Time to a certain Time Zone.
                 This is stored in XCLOCK.CFG file and
                 restored on next start of XCLOCK

 Set Clock :  Set System Clock by Windows Control Program.

 Mouse DblClick on a timer :      Set local time to this time zone
 (if enabled in Special Menu)     for temporary use, not saved to config file

 Local Time Zone is displayed by  different colors of location, date and time
 (depends on Color Setup). Location is signed by an asterisk.

 Set Colors : Set Colors in Color Setup Window ( ? for help )
 

3.  Edit Time Zones
 
 1. Select Normal or Special Setup
    Normal Setup: Select time difference in hours only for ordinary use.
    Special Setup: Additional selection for minutes.

 2. Mouse DblClick on Location Label:
    
    In SETUP Window:

    - Select location from location list 
 
    In Location List Editor :

    - Insert new location
    - Select standard time difference to Greenwich Mean Time

    Optional:

    - for daylight-saving time (summer time) select:

        - month and first day of summer time
        - month and last day  of summer time
        - summer-time time difference in hours (opt. minutes)
          to Greenwich Mean Time 

       XCLOCK is checking for summer time settings at:
       Start of Xclock, closing setup window, resizing Xclock window.
       If Xclock is running for days or weeks without resizing Xclock or
       without closing Xclock / Windows, you have to use "Check Summertime".
       Choose "Check Summertime" in Special Menu to force Xclock checking
       for summer time settings.

       The timer of Xclock checks system timer every 10 seconds to set time 
       displays but there is no checking for date. There is no need to check
       for daylight-saving time settings more then once a day. 

       Xclock automatically reflects summer time settings for each location 
       from 02:00 of first day to 03:00 on next day after last day of summer time.
 
       Standard time difference is used if there is no setup for summer time.    
       Select Month as 0 if no summer time setup is required.

    "Add new entry" saves new entry to XCLOCK.DAT and location list.   
    "Delete entry" deletes selected entry from pulldown list and data file. 

    You must know the time difference / time zone related to Greenwich Mean Time
    if you choose others than defaults. (see example in setup window)
   
    For this release you have to look for those time zones. Users of XCLOCK
    are invited to support this world clock with their own XCLOCK.DAT Files or
    messages at CompuServe. 

   

4. Time Display at Icon

 Mouse Click on City Label and minimize Xclock to icon shows City 
and related   time at icon. City and time display are saved on exit 
(if confirmed). XCLOCK is loaded in Windows as an icon with time 
display if you edit WIN.INI file using notepad or sysedit: 

 load=c:\windows\utils\xclock.exe 

 (if you have xclock.exe in a subdirectory "utils" of the windows 
directory on drive C:) 

5.  Alarm Setup

Mouse Dblclick on Alarm Clock: Set Date, Time, City and Alarm 
Message in Alarm Window.

Alarm settings will be written to config file (if confirmed) for 
use in next  Windows sessions.  If alarm times has passed between 
two Windows sessions, you will get the alarms when XCLOCK starts.


6.  Reset

 Reset sets XCLOCK to default time settings (see Reset Window)
 Optional: Reset of XCLOCK.DAT location file.


7.  Help
 
Summary Help Window, also certain help windows for setup.

User Help:  Write your own helpfile in User Help Window 
            or use notepad and save text file as XCLOCK.HLP .
                

8.  Exit

If XCLOCK is closed by Exit Menu, by Control Box or by closing 
Windows, Xclock asks to save new configurations if setup has 
changed.   


9.  Enhancements for this release:

 - User-defined Colors
 - Sizable XCLOCK window, position and size saved to next session
 - Sorted entries in location list
 - Location list editor with special setup for summer time
 - Xclock supports separate daylight-saving time setting for any location
 - Auto-Time-Corrections for summer time settings 
 - Viewer for Xclock's documentfile 
 - Support of user-defined helpfile 

 One minor restriction in this release: Absolute Time Base is fixed to 
 Greenwich Mean Time. 


 
10.  XCLOCK FILES

XCLOCK.CFG saves configuration of locations, time displays, colors and
alarm settings.

XCLOCK.DAT saves locations, time differences and summer time setup of
location editor window.

XCLOCK.INI saves position and size of Xclock on exit (always).
Closing Xclock when iconized, next start Xclock is iconized.

XCLOCK.TXT  This document file. 

Optional: User-defined helpfile XCLOCK.HLP

Write your own help informations in User Help File Window and save it
or use notepad and save text file as XCLOCK.HLP . 
XCLOCK.HLP is loaded in User Help File Window.


About X World Clock

 This application was written as a first project in Visual Basic.
 It was designed to work best in SVGA modes 800x600 or 1024x768.  
  
 Please send a short message via CompuServe, if you detect some bugs in
 this program. Any other comments are also welcome.

 
 Author
 
 Wilfried Kienemund

 CompuServe 100015 , 2550 