
Thu Oct 23 22:03:10 GMT-5:00 1997

wc0v3d.zip
WorldClock v0.3 demo version

by Paul McDermott 

Introduction 

This is the demo version of the WorldClock traveler's clock for the 
PalmPilot. The clock shows the time in up to six different user-selectable 
locations. The demo version contains time-zone information for 10 
countries - the full version contains time-zone information for nearly 300 
countries.

Features 

- Display the time in six different locations.
- User definable home location.
- Daylight saving time adjustments.
- Time-zone information for nearly 300 countries (registered version). 

Installation

1. Unzip the archive file into a new directory.
2. If you have an earlier version of WorldClock, delete it from your Pilot.
3. Install the file wc0v3d.prc into your Pilot using the PalmPilot
Install Tool.
4. HotSync your Pilot 

WorldClock should be compatible with the Pilot 1000, Pilot 5000,
PalmPilot Personal Edition and PalmPilot Professional. If you find that
it isn't, please let me know... 

Usage

1. Start WorldClock by tapping on the WorldClock application icon from the
launcher.

2. Tap the 'Menu' silk screen icon, and set your location (the time-zone
that the Pilot's clock is set to) using the 'Preferences' menu item. Also
indicate whether the local time-zone is currently using 'daylight-saving
time' (DST). 

3. If you don't want to see the date, uncheck the 'Show Date' check box,
also in the Preferences dialog. 

4. Press the 'Done' button in the 'Preferences' dialog.

5. gain, tap the 'Menu' silk screen icon, and choose the 'Locations' menu
item. Select the countries you would like to see the time for, using the
'Locations' dialog. You can choose up to 7 locations. Also indicate whether
these time-zones are currently using 'daylight-saving time' DST. 

6. Press the 'Done' button in the 'Locations' dialog.

7. The main screen will show the time at the locations you have selected. 

8. As the year progresses, you will have to check and un-check the
'daylight-saving time' check-boxes for the countries you have selected (in 
the 'Locations' dialog)

9. The format for the date and time is taken from the you general Pilot
preferences.

'Daylight-saving time' is also known as 'summer-time', and is the
process of moving the clocks (usually) forward during the summer months.

Please Note 

The time-zone information is not authoritative. Please send any
corrections to the author. 

Note on the Demo Version 

The demo version of WorldClock is fully functional, and contains
time-zone information for 10 countries. The registered version of
WorldClock costs US$10, and contains time-zone information for nearly
300 countries.

I would be grateful for any feedback on bugs or errors, and also for
suggestions of improvements and enhancements. Please email me at
tintagel@kagi.com.

How to Register

The full version of WorldClock contains time-zone information for nearly
300 countries, and costs US$10. There are many ways to register:

On the web:
	http://order.kagi.com/?2Y5

By mail:
	Send US$10 or the equivalent in UK to:
		Paul McDermott,
		100 Morningside Drive #8,
		New York NY 10027,
		USA

By email & fax:
	Download the registration software from
		http://fp97.inet-images.com/tintagel

In each case, a copy of the full version of WorldClock will be sent to
you by email. If you require a copy on floppy disk, add an extra US$2
and supply your postal address.

Known Problems

- Does not cater for places which have a DST shift of +2 hours, or -1
hour. (Yes, these places do exist).
- Does not cater for countries with fractional time-zones: Afghanistan,
Australia Northern Territory, India, Iran, Marquesas Islands, Myanmar
Norfolk Island, Nepal, Sri Lanka, Australia Lord Howe Island, Australia
South, Canada Newfoundland, Chatham Island
- The names of the time-zones in the CIS may be wrong. I used as my 
original source data from the US Naval Observatory at 
http://tycho.usno.navy.mil/tzones.html. This database lists the following 
timezones in the CIS:

Russian Federation zone eight: +9 hours (Local summer +10 hours)
Russian Federation zone eleven: +12 hours (Local summer +13 hours)
Russian Federation zone five: +6 hours (Local summer +7 hours)
Russian Federation zone four: +5 hours (Local summer +6 hours)
Russian Federation zone nine: +10 hours (Local summer +11 hours)
Russian Federation zone one: +2 hours (Local summer +3 hours)
Russian Federation zone seven: +8 hours (Local summer +9 hours)
Russian Federation zone six: +7 hours (Local summer +8 hours)
Russian Federation zone ten: +11 hours (Local summer +12 hours)
Russian Federation zone three: +4 hours (Local summer +5 hours)
Russian Federation zone two: +4 hours (Local summer +5 hours)

However, it was pointed out to me that there are a number of problems with 
this data:
+ Zones two and three are the same
+ Moscow is definitely at GMT+3, which is not an option on the above list
+ There are eleven timezones listed, but I have only ever been able to 
count ten timezones in the CIS on any maps.

Therefore, I have changed the database for the CIS to read:

Russian Federation zone one: +3 hours (Local summer +4 hours)
Russian Federation zone two: +4 hours (Local summer +5 hours)
Russian Federation zone three: +5 hours (Local summer +6 hours)
Russian Federation zone four: +6 hours (Local summer +7 hours)
Russian Federation zone five: +7 hours (Local summer +8 hours)
Russian Federation zone six: +8 hours (Local summer +9 hours)
Russian Federation zone seven: +9 hours (Local summer +10 hours)
Russian Federation zone eight: +10 hours (Local summer +11 hours)
Russian Federation zone nine: +11 hours (Local summer +12 hours)
Russian Federation zone ten: +12 hours (Local summer +13 hours)

If anyone can provide any more guidance on this issue, please let me know 
at tintagel@kagi.com

Contact Information 

Please email any suggestions, comments, correction or bugs to Paul
McDermott at tintagel@kagi.com. This is my first Pilot application, my
first ever shareware program, and the first program I have written for a
long time. I hope you like it...

Technical Information 

Name: WorldClock v0.3 
App ID: wCAP
Database ID: wCDB 

Credits

This program was written with GCC and the Pilot ADSK. Credit and
kudos is due to many people for their efforts: Jeff Dionne and Kresten
Krab Thorup for prc-tools, Wes Cherry for pilrc/pilrcui, Greg Hewgill
for copilot, and Darrin Massena for hosting the useful news and web
sites.

The time-zone data for this program comes from the US Naval Observatory
website at http://tycho.usno.navy.mil/tzones.html.

Update Log
5/9/97 v0.1 beta 1a
	Fixed - Local DST flag should be ignored (i.e. Assume that Pilot 
        clock is set to DST when checked).
	Changed name to WorldClock because WorldTime clashes with a 
        competing product 11/9/97 v0.1 beta2
	Upgraded to v0.1 beta 2 in worldclock.rcp and README(wc0v1b2d).txt
	Fixed - Locations list popup box is too long (14 lines) for no 
        options (10) in locations form. (extend the no. of locations 
        choices available).
	Fixed - How to Register Form: '300' should read '300 countries'
	Done - Register the application ID.
26/9/97 v0.2
	Upgraded to v0.2 in worldclock.rcp and README(wc0v2d).txt
	Added registration info.
	Fixed - Problem with full version not being generated by the 
        makefile.
	Done - Registered version README file.
	Done - Make a generic README.txt which uses CPP to produce 
        different versions (full vs. demo) depending on the VERSION macro
	definition.
21/10/97 v0.3
	Done - Global control of version numbers
	Done - Credits section: Pilot GCC, pilrc, copilot, US Naval 
        Observatory.
	Done - Widen the field for the location names.
	Done - Conditional compilation of worldclck.rcp depending on 
        VERSION
	Done - Make the "Help|How to Register" window dependant on the 
        version of the program. Done - Help info for the Preferences dialog.
	Fixed - Incorrect title in main screen.
	Done - Conditional compilation of README file depending on VERSION
        Fixed - Problems with timezones in the CIS
	Fixed - Usage instructions improved.

The Legal Section 

Disclaimer

WorldClock is provided as-is with no warranties expressed or implied.
You use this software at your own risk. 

Copyright

WorldClock is Copyright  1997 by Paul McDermott, All Rights Reserved.
Pilot and PalmPilot are trademarks of U.S. Robotics. 

