Thu Jan  8 04:22:40 GMT-5:00 1998

                          WorldClock User's Manual

                              January 6, 1998

------------------------------------------------------------------------
WorldClock v0.4
------------------------------------------------------------------------

Introduction

This is the WorldClock traveler's clock for the PalmPilot. The clock shows
the time in up to seven different user-selectable locations. The demo
version contains time-zone information for 13 cities - the full version
comes with time-zone databases for  313 countries and 236 cities. You need
to register to obtain the full version.

Features

   * Display the time in seven different locations.
   * User definable 'home' location.
   * Daylight saving time adjustments.
   * Time-zone databases for  313 countries and 236 cities (full version).[NEW]
   * User installable time-zone databases for easy extension.[NEW]
   * Handles fractional time-zones.[NEW]

Installation

  1. Unzip the archive file into a new directory.
  2. Install the file "wc0v4d.prc" (demo version) or "wc0v4f.prc" (full
  	 version) into your Pilot using the PalmPilot Install Tool.
  3. Also install the databases into your Pilot using the PalmPilot Install
     Tool. Pilot database files have the extension "PDB". The demo version
     of WorldClock is supplied with one database, named
     "WC_Demo_Database.PDB". The full version of WorldClock is supplied
     with two databases, named "WC_Major_Cities.PDB" and
     "WC_Countries.PDB". Either or both of these databases should be
     installed.
  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...

Using WorldClock

  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. Again, 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 Tintagel Software. See below for details of time-zone data sources.

Note on the Demo Version

The demo version of WorldClock is fully functional, and contains time-zone
information for 13 cities. The registered version of WorldClock costs
US$10, and comes with installable databases covering 313 countries and 236
cities.

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 and Limitations

   * Does not cater for places which have a DST shift of +2 hours, or -1
     hour. (Yes, these places do exist).
   * The demo version has a limit of one user database, and thirteen
     records in that database. The full version has a limit of 65535 user
     databases and 65535 records in each database. We expect that you will
     run out of memory before you reach this limit though...
   * The back-up bit of installed databases is un-set automatically. This
     is not really a problem, but a feature. [Image] The only way  to
     create the databases was to download them from a PalmPilot, and this
     requires the backup bit to be set. However, in day-to-day use, one
     does not really want the backup bit on these databases to be set, as
     it would slow down HotSync. WorldClock automatically un-sets the
     backup bits of any WorldClock time zone databases which have their
     backup bits set. This should not impact day-to-day use, but if you
     deliberately set the backup bits (e.g. using "Backup Buddy"), you will
     notice this feature, and may become confused...
   * The names of the time-zones in the CIS may be wrong. The original time
     zone source data was from the US Naval Observatory at
     http://tycho.usno.navy.mil/tzones.html. This database lists the
     following time zones 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 timelines listed, but I have only ever been
          able to count ten timelines in the CIS on any maps.

     Therefore, we 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
     us know at tintagel@kagi.com

Contact Information

Please email any suggestions, comments, correction or bugs to Tintagel
Software at tintagel@kagi.com. This is our first Pilot application - we
hope you like it.

Technical Information

Name: WorldClock v0.4 demo version
App ID: wCAP
Database IDs: wCDB and wCTD

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 web
site at http://tycho.usno.navy.mil/tzones.html. Additional time-zone
information comes from a list sent to me by Dr. William T. Anton.

Musical Inspiration

During the construction of WorldClock, musical inspiration was provided by:

   * Portishead - "Portishead";
   * Primal Scream - "Vanishing Point";
   * Mychael Danna - "The Sweet Hereafter";
   * Jamiroquai - "Travelling Without Moving".

All highly recommended.

Revision History

5/9/97   WorldClock v0.1 beta 1 demo
         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
16/9/97  WorldClock v0.1 beta 2 demo
         Fixed - Locations list pop-up 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'
         Initial Release
26/9/97  WorldClock v0.2 demo
         Added registration info.
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 dependent 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 timelines in the CIS
         Fixed - Usage instructions improved.
6/1/98   v0.4
         Fixed - Blinking of time-shift numbers after checking/unchecking DST flag in
         locations form.
         Done - Separate importable databases for countries, cities, time-zone names...
         Done - Longer space for country names.
         Done - Make better use of in-place database data to conserve memory.
         Done - Create database of major cities.
         Done - Support for fractional time-zones.

The Legal Section

Disclaimer

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

Copyright

WorldClock is Copyright  1997-1998 Tintagel Software, All Rights Reserved.
Pilot and PalmPilot are trademarks of U.S. Robotics.
------------------------------------------------------------------------

