home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d583 / worldtime.lha / WorldTime / WorldTime.doc < prev    next >
Text File  |  1992-01-04  |  5KB  |  110 lines
  1.  
  2.                                WorldTime v1.31
  3.  
  4.                        © Copyright 1991 Jonathan Potter
  5.  
  6.                     This program is freely distributable.
  7.  
  8. ------------------------------------------------------------------------------
  9.  
  10.   WorldTime is a clock with a difference. It can show you the time in any city
  11. in the world, with 84 cities displayed at once.
  12.  
  13.   To run WorldTime, you must first either create or edit the WorldTime.cfg file.
  14. This file lives in either the S: directory or the current directory, and looks
  15. like this :
  16.  
  17.   -dData file      - The data file to read the list of cities from
  18.   -lpLocalCity     - The city YOU are in
  19.   -ltLocalTime     - Difference between you and GMT (in hours)
  20.   -opOtherCity     - Another city to look at
  21.   -otOtherTime     - Difference between the other city and GMT
  22.   -xClockXPos      - Default X position of clock window
  23.   -yClockYPos      - Default Y position of clock window
  24.   -tcColour        - Pen colour for times in today
  25.   -ycColour        - Pen colour for times in yesterday
  26.   -mcColour        - Pen colour for times in tomorrow
  27.   -ccColour        - Pen colour for the clock at the bottom of the window
  28.   -icColour        - Pen colour for the names of the cities
  29.   -i               - Iconify start
  30.  
  31.   Only -lp and -lt are required. The others are optional. A sample configuration
  32. file might look like this :
  33.  
  34. -lpAdelaide
  35. -lt9.5
  36. -opLondon
  37. -ot0
  38. -x100
  39. -y30
  40. -i
  41. -cc3
  42.  
  43.   In this file, the local city is Adelaide, and Adelaide is +9.5 hours from GMT.
  44. London is the other city whose time I want to look at, and London is 0 hours
  45. from GMT. The (x,y) coords of the clock window are 100,30, and I want the
  46. program to start in the iconified state (with the clock window open). The
  47. clock at the bottom of the main window is to be rendered in pen colour 3.
  48.  
  49.   The clock window displays the current time and date, as well as the amount
  50. of chip and fast memory free. If the -op and -ot flags are used, it also
  51. displays the current time and date in this specified city.
  52.  
  53.   If the -i flag is not specified, the program opens the main time window (this
  54. can also be reached by activating the iconified clock window and pressing the
  55. right mouse button).
  56.  
  57.     The program reads a list of 84 cities from a file. You may specify the name
  58. of this file by the -d flag in the configuration file. Otherwise, it looks
  59. for the file s:WorldTime.dat and then WorldTime.dat in the current directory.
  60. If the data file is not found, the program will not run.
  61.  
  62.     This data file has a list of cities and times, with one city and time on
  63. each line. For instance,
  64.  
  65. Adelaide,9.5
  66. Algiers,0
  67. Barbados,-4
  68.  
  69.     This indicates that Adelaide is +9.5 hours from GMT. Algiers is on GMT, and
  70. Barbados is -4 hours from GMT.
  71.  
  72.   This window displays the current time and date for the city you are in (as
  73. specified in the configuration file), as well as the current time in the 84
  74. selected cities around the world.
  75.  
  76.   If a time is displayed with a + in front of it, it indicates that that city
  77. is currently in tomorrow (but tomorrow never comes :-). If it has a - in front
  78. of it, it is in yesterday. Cities of tomorrow and yesterday are also displayed
  79. in a different colour (which can be specified in the configuration).
  80.  
  81.   From the main time window, you can click on any of the cities to go back to
  82. the clock window, and watch the time in that city. For instance, if you decided
  83. you wanted to look at the time in San Francisco, you would simply click on
  84. that name. If, however, you click on the name of your local city (as
  85. specified in the configuration), you will return to the clock window, watching
  86. the city specified by the -op and -ot flags in the configuration.
  87.  
  88. ------------------------------------------------------------------------------
  89.  
  90.     The source is included in the v1.1 release. A number of changes have also
  91. been made. This is at the request of several people. Have fun!
  92.  
  93. ------------------------------------------------------------------------------
  94.  
  95.   I wrote this program because I am sick of having to work out manually
  96. the time in other countries (especially at 2am!) whenever I want to ring
  97. someone there. I hope you find it just as useful.
  98.  
  99.   Address author correspondance, donations, and enquiries about Directory Opus
  100. to :
  101.  
  102.                                Jonathan Potter
  103.                                P.O. Box 289
  104.                                Goodwood, SA 5034
  105.                                Australia
  106.  
  107.                           ph : (08) 2932788
  108.                      FidoNET : 3:680/829
  109.                     Internet : jpotter@itd.adelaide.edu.au
  110.