-------------------------
WorldClock - Version 1.27
-------------------------
Released:   April 7, 1999
-------------------------


Introduction
------------

WorldClock allows you to select almost any area of the world and find what the current local time is in that area. This is done by either clicking on a world map or, for the geographically impaired :-), by selecting a city or area from a list. In determining the local time, it takes into account whether local Daylight Savings Time is in effect for most major areas of the world.

If you are logged on to the Internet, WorldClock can also check your PC's time against an Internet time server for accuracy. It will automatically reset your PC's clock if it finds any differences.

You can also set up to eight alarms. These can be set for a given time and activated for the current day only or for selected days that you specify.

WorldClock also has a nice calendar feature that includes all Canadian and US holidays; it is even able to calculate the date of moving holidays such as Easter weekend as well as generic holidays such as Thanksgiving. You also have the ability to 'mark' certain days (such as loved one's birthdays) on the calendar. 


Version History
---------------

[04/07/99] Version 1.27:
Following quickly on the heels of 1.26, 1.27 fixes a few bugs and adds a few features.
1. When changing the name of a place selection and selecting that place for the multiple clock display, the old name is displayed ISO the modified name. Now fixed.
2. 1.26 introduced a bug. The multiple clock display did not save its place selections. Now fixed.
3. If you ran with the '/d' paramter, the day/night window did not automatically update every minute. Now fixed.
4. Due to popular demand, I've also added moonrise/moonset information for your local area.
5. Also due to popular demand, I have added a moon phase graphic.
6. Also due to popular demand (!), the WorldClock icon in the system tray now displays *your* day and not the selected timezone's day.
7. Added a new option that auto-detects when you logon to the Internet and does a timesync. This option should only be activated if you have a  dial-up connection to the internet (should not be used with direct network or cable-modem connections) and if you are not on a TCP/IP network.
8. I've included a new file in the distribution called CitiesLatLong.txt. As you can probably figure out, this file contains the latitudes and longitudes for most of the world's major cities. The format is: City Name, Longitude, Latitude.
9. I have changed the distribution method for WorldClock updates because many of you have written to complain about the large e-mails. From now on, an e-mail notice will be sent to everyone notifying them that an update is available along with a link to the update file.

[04/05/99] Version 1.26:
1. You may now display up to four different multiple clock windows giving you a total of 16 cities.
2. Changed the 'Toll Hourly Bell' Preference so that you can now choose a 'Big-Ben' style of hourly sound or a 'Toll'-the-hour sound. The Big-Ben option is like the old 'Toll the Hour' option. The new 'Toll the Hour' option will sound the hour (i.e. 3 bells if it's 3 o'clock).
3. Added a check for the correct year on startup. This could be very useful if you have a non-Y2K compatible machine. WorldClock will automatically reset the year in this instance.
4. When the time is reset, WorldClock now issues a system broadcast message so that the new time is immediately reflected in the system tray clock.
5. In the multiple clock display, I now hide the 'what would the time be' section of the screen. You can 'roll-down' and 'roll-up' this section by clicking on a little arrow button.
6. When minimized to the system tray, the WorldClock icon now displays the current day of the month.
7. Added sunrise/solar noon/sunset information for your area. This feature needs to know your geographic location (latitude/longitude) to operate correctly. Note that although this feature will calculate sunrise/sunset for any lat/long, the reported times are tied to your local timezone and will return correct values only for locations within your timezone. If you are unsure about your location, go to the following web page to look up your city's lat/long: http://www.ahip.getty.edu/tgn_browser (my thanks to Ron Swenson for this link).

[02/09/99] Version 1.25:
Oops! Fixed a big bug -- if you rename your selected timezone, you get an access violation the next time you run WorldClock. My apologies to all.

[02/08/99] Version 1.24:
1. You can now view multiple alarm messages on screen at the same time. If you haven't cleared a previous alarm message when a new alarm triggers, the alarm messages will be presented in cascading message windows.
2. Added the ability to rename your selected timezone area.
3. Changed the multiple clock display so that the larger timezone names now fit into the timezone name displays.
4. Fixed a bug with the calendar. Under certain circumstances, the calendar would come up as September 1997 regardless of the actual date.
5. Fixed a bug with the use of the '/s' parameter which caused an access violation.
6. Fixed a bug with the use of the scheduled timeset feature behind firewalls.
7. Valentine's Day wasn't programmed into the calendar. Got this update out just in time! :-)
8. Added '/m' start-up parameter. If your run WorldClock with a /m parameter, only the multiple clock display will be shown.
9. Added '/d' start-up parameter. If your run WorldClock with a /d parameter, only the day/night view will be shown.
Note: These last two options are very useful if you want to place either of these displays on your screen independently of the main WorldClock program. Simply create new shortcuts (i.e. 'Clocks' and/or 'Day/Night') with either of these parameters in the command line. Note also that the '/m' and '/d' parameters are mutually exclusive. If you put both in your command line, only the first will take effect.

[12/22/98] Version 1.23:
1. Added new feature to MultiClock display. You can now determine the time it would be in all four selected timezones if the current time were whatever time you specify.
2. Added new Preference: 'Show Seconds'. If you turn this off, the time display will show the time in HH:MM format.
3. Added 'timeout' parameter for timesync protocols.
4. Ability to enter (and remember) your own address for a timesync server.

[10/31/98] Version 1.22:
1. WorldClock will now remember your window layout. If you have multiple windows open when you close the program, they will be restored in the same position the next time you run WorldClock.
2. Added a clock to display the current local time in the Day/Night view.
3. The Day/Night view now updates automatically every minute.
4. If you Minimized and then Restored and then dragged the main window around, a 'ghost' window would remain at the original position. Now fixed.

[10/10/98] Version 1.21:
1. Added a day/night display. This display shows the world with a shadow on the areas that are currently in night.
2. Added a multiple clock display. This will allow you (in a separate window) to view the time in four different areas concurrently.
3. Added an option to display the current time in the foreground window. With this option set, the time will be displayed in the caption bar (near the close button) of whatever window is currently active (even other application windows).
4. Reorganized the main popup menu -- moved all option settings to a 'Preferences' sub-menu.
5. I have received many e-mails concerning the placement of Kashmir on the WorldClock map. Although I thought it quite self-evident, it seems that I need to point out the obvious: The areas you select on this map are not political zones, they're time zones. Thus the placement of Kashmir with Pakistan is simply a reflection of the fact that these two areas share the same timezone. It is not a political statement on my part. I trust that this clears up this matter once and for all.

[09/23/98] Version 1.20:
1. I now support the (much more accurate) SNTP protocol in addition to the older Time protocol. This adds great flexibility to the TimeSync function.
2. I'm sure that many of you will be pleased to know that I have finally broken down and added the widely requested option of Proxy support to WorldClock. However, this feature is still considered to be in beta. (Please refer to the Proxy notes -- Proxy.txt -- included in this distribution.)
3. I've added the ability for you to specify a maximum correction value for the TimeSync function.
4. I've fixed the 'Stay-on-Top' feature to operate as expected.
5. I've adjusted a couple of incorrect DST entries.

[08/28/98] Version 1.19:
New to this release is the ability to select places within a given timezone from the popup menu. Changed the way I iconize the application to the System Tray. The old method was preventing users from shutting down their machines if WorldClock was running -- not nice! Also fixed a small memory leak.

[08/03/98] Version 1.18:
Added options to minimize to System Tray and to start minimized. Added option to set clock at user specified intervals. Added '/s' startup paramater. Fixed bug where selecting the GMT timezone causes a 'List Index' error.

[07/21/98] Version 1.17:
Fixed a small problem with date formats in the alarm system. Also added an option to toll hourly bells. This version also includes more cities, updated Daylight Saving Time information for more areas, and a few interface improvements.

[07/15/98] Version 1.16:
Added new time display fonts. Also fixed German date format problem.

[07/11/98] Version 1.14:
Fixed a few time zones and added lots of new cities. Also added 24-hour time display option.

[07/03/98] Version 1.10:
First major update to WorldClock. Fixed many little (and big) bugs.

[06/14/98] Version 1.00:
First release.


Setup Instructions
------------------

There is no setup utility as the whole program is self-contained in one executable file. To install WorldClock, simply put the program into the directory of your choice. Note that although the program itself is contained in one file, an associated options file called WorldClock.ini will be created in the same directory that you installed WorldClock. This file is used to keep track of your configuration.


Using WorldClock
----------------

When you run the program, you will see a map of the world. You can click anywhere on the map to select that area's timezone. You will see the selected zone time display (the right pane) update to reflect the UTC hour shift as well as the local time in your selected timezone. Alternately, you can select an area/city in the listbox at the bottom of the screen. As stated previously, the program takes into account whether or not DST is in effect in the selected timezone. If so, you will see a little 'sun' icon appear just to the right of the timezone display. You will also notice that once you have select a timezone, the 'Select Place in Zone' popup menu item is filled in with all of the places associated with that specific timezone. You can use this feature as a very quick and easy method to select a specific area or city within a timezone.

The time display is broken down into two panes. The pane on the left shows you your local time, while the pane on the right shows you the current time in the timezone you have selected. The time display has header bars to display the name of the selected areas. For your local time, I display what Windows reports as your local timezone. You can customize the typically bland nature of this information (i.e. 'Eastern Standard Time') with your own text. You do this by selecting the 'Set Local Name' option from the popup menu. This allows you to personalize the display to reflect something a little more meaningful (i.e. 'Montreal, Quebec').

Right-clicking anywhere on the WorldClock window will bring up the popup menu. Using the 'Preferences' item on this menu you can select various options such as whether or not to show the map and/or places segments of the WorldClock window. This can be handy when you want to park WorldClock in a small corner of your screen and take up as little space as possible. Note that there is also a 'Stay On Top' option in the Prefernces menu. As the name implies, this option will force the WorldClock window to always remain above your other windows. Another nice option is the 'Show Time In Caption Bar' feature. With this set, the current time will be displayed in the caption bar of the currently active window (including other applications' windows).

If you minimize the WorldClock program, you will note that the program name on the Windows taskbar changes from 'WorldClock' to display the current location and time of your selected timezone. If the taskbar is cluttered and the WorldClock item is too small to contain the complete text, move your mouse over the WorldClock item and a hint window will popup to display the complete text. You also have the option of minimizing WorldClock to the System Tray (this is where the time is displayed). To activate this feature select the 'Minimize To Tray' option from the menu. Note that if you choose this option, you will lose the taskbar display of the selected area's current time. However, if you move the mouse over the WorldClock icon in the tray area, a hint window will popup to display this time. You can also choose to start your program already minimized. Select the 'Minimize On Launch' option from the menu.

You also have the ability to see where it is currently day and where it is night in the world. Simply select the 'Show Day/Night View' from the popup menu. This will bring up a display of the world with a shadow over the areas that are currently in night. If you keep this display open for an extended period of time, WorldClock will automatically update the display every minute to reflect the change in elapsed time. Note that there is a small red circle on this display. This is the point on the Earth where (at the current time) the sun would be directly above a viewer. On this screen, you will also note that there is a facility to enter your location's latitude and longitude. This is used to calculate the displayed Sunrise, Solar Noon and Sunset values. If you do not know your location's lat/long, go to the following web page to look it up:

http://www.ahip.getty.edu/tgn_browser  (my thanks to Ron Swenson for this link)

Once you have the lat/long, you need to convert to a decimal value. The equation is as follows: Value = Degrees + Minutes/60 + Seconds/3600. North and West coordinates are entered as positive values; South and East are entered as negative.

Another very handy feature is the multiple clock display. Select the 'Show Multiple Clocks' item in the popup menu to activate this display. You have access to 4 independent clocks that display the times in four seperately configurable areas of the world. Simply click on the little up-arrow button below any of the clocks to select a new area/zone. A list will popup above the button from which you can select an area. (Note that this list is identical to the area list in the main display.) Note also there is a checkbox at the top of this window labelled: 'Show the time in these zones if the local time were:'. If you check this box, you then can do a 'what time would it be in X if the local time were Y' scenario.  Specify the time in the edit window and the clocks will automatically update the times in the selected timezones. This is great for organizing on-line meetings or international tele-conferences. (The specified time is always assumed to be for local today.)

If you don't like my choice of font or colour for the time display, you have the option of changing it. Simply select the 'Set Time Display' option from the popup menu and you can select from several different choices.

If you only want to see the hours and minutes in the time display, simply turn off the 'Show Seconds' option in the Preferences menu.

Selecting the 'Set Clock' option from the menu (or double clicking on either time display) will bring up the TimeSync screen. Press the 'Check Time' button on this screen to validate your PC's clock against your selected Internet Time Server. Note that you are not limited to my list of selected time servers. You can also enter your own server address if you so choose. If you find that the program is returning immediately without setting the time, it could be that your request is timing out for some reason. Try increasing the timeout value (which is given in milliseconds) until it works. You can also ask WorldClock to set your's PC's clock at pre-set intervals. Select the 'Set Clock Every' option from the menu and you can choose from every hour, 3 hours, 6 hours, or 12 hours. If you wish to run the program just to set the clock and then exit, there is a '/s' command line option to do this. (NOTE: This /s option is available only with the registered version of WorldClock.) Obviously, you must be connected to the Internet for all of these clock-set features to operate properly.

You can set up to eight alarms. From the popup menu select 'Set Alarm' and then the alarm you want to set (there are eight available). On the alarm configuration screen you specify the time of the alarm and the frequency. You can choose to set it as a one-time only alarm or to go off for certain days of the week. You can also choose whether or not a sound is played when the alarm goes off. You can choose to use either the internal built-in sound (a ringing alarm clock sound) or any .WAV file of your choice.

You will note that if you move your mouse over the date areas, the dates turn into buttons. Press either of these buttons and a calendar will popup on the side of the main screen. You can move the calendar display around by clicking and dragging while your mouse is over the month name. You can close the calendar display by clicking on the little 'x' at the lower right-hand corner of the calendar screen. (You can also bring up the calendar screen by selecting the 'Show Calendar' option from the popup menu.)

Once the calendar screen is up, you will note that there are two sets of buttons at the top of the calendar. The set on the left allows you to scroll the calendar through the months, while the set on the right allows you to scroll the calendar through the years. If you right click while your mouse is over the calendar area of the calendar screen, you will get a popup menu that allows you to select various options for the calendar. The main use for this menu is to set/reset your 'marked' days. Note that you can mark a day for the current year, or for all years. For instance, if you want to mark an upcoming event (concert, date, whatever) you would only mark for the current year. Birthday reminders, on the other hand, you  would want to mark for all years.


Registration
------------

WorldClock is distributed as shareware (it has a $10 US registration fee). The trial version has nag-screens which prompt you to register every 4 minutes or so. I have an on-line registration system which you can access from my home page located at:

	http://www.carefile.com/WorldClock

You will need a major credit card to register.

If you prefer not to register on-line, you can mail a registration check in the amount of $10 US made payable to Fulvio Castelli to the following address:

           Fulvio Castelli
           44 Courtney Drive
           Montreal, Quebec
           Canada
           H4X 1M5

Please include your e-mail address. Once I receive your check, I will e-mail you the registered nag-free version of the program.

Thank you.


E-Mail Me!
----------

If you find any problems or bugs, please e-mail me at fulvio@rocketship.com and I will address them as quickly as possible. I'd also like to hear any comments (likes, dislikes, suggestions) that you might have.

I hope you enjoy the program.


Fulvio J. Castelli
April 7, 1999.