Welcome to CityTime version 2.6

Released March 8, 2000


CityTime is an advanced world clock which shows an accurate and easy to
use day/night plot on the screen.  The plot adjusts throughout the day
as the earth rotates, and changes shape with the seasons as the earth
tilts north and south relative to the sun.

The program includes one hundred and thirty default cities and these are
fully customisable allowing for the display of the current time in any
city in the world.  With the release of version 2.6, a large collection
of cities can now be imported from easily accessible data files provided
online.

CityTime also has advanced time utility functions such as the Time
Calculator, the ability to work out sunrise and sunset times for cities
throughout the world and a unique Change Location option which allows
you to adjust the Palms date and time automatically when travelling to
other cities.



____Installation

Weve designed CityTime from day one so that it is easy to install and
update.  There is only ever one file to install and all the database and
other information which the program requires is automatically re-created
if any files go missing or become corrupted.

The file is normally transferred over the Internet as a compressed
.zip file which will be decompressed automatically by most computer
systems.  The file required to either install or upgrade the program is
called CityTime.prc.

 New Installation:  The CityTime.prc file can be installed either by
choosing Install Handheld Files from the Palm Desktop program or the
HotSync Manager program.  The file can also be dragged onto either of
these programs.  The file will be installed on the device during the
next HotSync. 

If youre having trouble, please see the support section at our web site
(www.codecity.com.au) for more detailed information.

- Existing Installation.  CityTime 2.6 (and all the versions before) can
be installed over the top of any previous version.  All database and
registration information will be automatically updated if required from
previous versions.  There is no need to delete any files before
upgrading the product.



____Getting Started

The operation of CityTime should be fairly straightforward.  Detailed
help text is provided to explain every area of the program and can be
accessed either by tapping on the (i) button in any dialog, or by
choosing Help from the menus.

The first thing to do is to ensure that your home city is set correctly
so that the day night plot and remote city times will be accurate.

When the program is first run it will ask you to select your current
home city.  If you cant find a suitable city, choose one thats nearby,
or at least in the same time zone.  You can always return to this screen
later by choosing Select Home City from the Options menu. 

If required you can then go to the Edit Cities area and create,
duplicate or import any new cities which you require.

The best way to check that the home city is set correctly is by checking
that the edge of the day/night plot passes over your home city when the
sun is rising or setting outside!



 ____Useful Tips for Using the Program

- To make city selection faster when a list of cities is displayed,
write the first letter of the city in the Graffiti area to show cities
beginning with that letter.   For example, to find London quickly, write
an L in the Graffiti area..

 - Use the hardware up and down buttons to make navigating through the
lists of cities easier. This is easier and much faster than tapping  the
on screen up and down arrows.

- Tapping on the home city name and time (in the top right corner of the
screen) will show the current day and date in your home city for a few
seconds.

- Tapping anywhere on the map will show the time, day of week and the
current DST state in the nearest City.

- Star shaped indicators will appear throughout the program to indicate
that a city is currently in Daylight Savings Time.  Cities can have
either manual or automatic DST settings and all of the default (and
import) cities which use DST will update their DST state automatically
throughout the year.  Further information can be found in the help areas
in the Edit Cities screens within the program.

- While getting familiar with reading the day / night plot keep in mind
that the plot always moves gradually from right to left (as the earth
rotates East).  For example, if the dark area of the plot is just to the
left of a city, this means that the sun has recently risen in that area.
 With practice you can get a good estimation of the time anywhere in the
world just by referring to the day/night plot.

- Throughout the program (except the main screen), additional help can
be found by clicking on the (i) icon in the top right corner of any
window.  Main Screen help is available from the 'Help' menu option.

- The day night plot changes shape throughout the year as the rotation
axis of the Earth changes relative to the Sun.  Twice a year (at the
equinoxes near the end of September and March) the plot will be
perfectly square for a short time (We get lots of bug reports every six
months when this happens!).  The plot will move gradually north and
south each day between these times. 


____Registering the Program

CityTime can be easily registered online via the Register link on the
front page of our web site at;

    http://www.codecity.com.au

If you register online you will immediately receive an extension key
which will extend the trial period of the program by ten days.  A
permanent key will be sent by email within 1-2 days.

If you would prefer to register by mail, phone, fax etc., please get in
touch with the people at any of the following sites.  They are all
resellers of Code City products;

    Smaller.com:  http://www.smaller.com
    Handango:  http://www.handango.com
    Palm Gear:  http://www.palmgear.com

Phone, fax and address details should be on the front page or easily
accessible from each of these sites.


Registered users get as much support and help with the product as they
like and will receive information about important updates to the
program.

There will be no charge for updates to the program in the foreseeable
future.  People registering on or after February 1, 2000 will receive
the upgrade to the color versions of CityTime free of charge if/when
they upgrade to a color device.


____Version History

Version 2.6;

- New Import option allows for the simple importing of cities by region
from files stored in the Palms Memo Pad application.  Our initial import
files include more than 600 cites, including at least two from every
country and one from every dominion in the world.

- New Duplicate City option when creating a new city.

- The Time Calculator screen has been upgraded to show relative times
for up to four remote cities instead of the previous single city. 
Initial times are now based on the cities selected on the mainscreen.

- Set Time option in the Select Home City dialog allows for the setting
of the system date and time without having to go to the Prefs program.
 The seconds can be set in this screen, allowing for more accurate
setting of the Palm system clock.

- CityTime 2.6 is fully compatible with Palm OS version 3.5.


Version 2.5;

- New preferences screen allows for the setting of options for redraw,
timing, time formats etc.

- Support for display of the twilight zone at the edges of the day/night
plot.  A range of different twilight areas can be displayed.  Faster
drawing of day/night plot when no twilight area is selected.

- Menus reorganised to more closely meet Palm standards.  Next Field and
Previous Field shortcuts now operate in dialogs as appropriate.  New
Edit Menus with Graffiti Shortcut display in text edit areas.

- Preference option to force display of GMT (or UTC) times in 24 hour
format.

- Sound effects when selecting a city from the mainscreen map or when
viewing the home city date.

- Day of week now displayed in three characters in all areas, eg."We" is
now "Wed".

- Updated App launcher icons, updated internal help text.


____New Features in Version 2.53

- CityTime version 2.53 now supports the exchange of time zone
information with the Time Traveller suite of products from Class Action
P/L.  See the enclosed TTravel.txt readme file for more information
about this integration between the products.  We hope this will be the
start of a number of Palm applications sharing time zone information in
the future!




____Contact Details

Web Site:

    http://www.codecity.com.au
    
Email:

  Support@codecity.com.au
  Info@codecity.com.au
