home *** CD-ROM | disk | FTP | other *** search
/ Significant Series Windows / PCSIG-SignificantSeriesWindows-Win31.iso / 0winrun / 3433 / release.txt next >
Text File  |  1992-12-14  |  10KB  |  252 lines
  1. World Time A.0.4 Release Notes
  2. Written By Dan Hallock
  3.  
  4. General
  5.  
  6. Do you have to call people in other parts of the world frequently?
  7. With the WorldTime program, you can check the time in the city you are
  8. calling before you call.
  9.  
  10. This Windows program will display the current time for your location
  11. (based on your PC's clock), the Greenwich Median time (GMT), and the time
  12. for any city you select.
  13.  
  14. There is no copyright on this program. You are free to do with it
  15. whatever you wish, and give to whoever you wish. I only ask that you
  16. do not change it.
  17.  
  18. This is a pretty simple-minded program, I doubt too much can go wrong
  19. with it; however, if you find an error please feel free to let me
  20. know.
  21.  
  22.     Dan Hallock
  23.     CIS: 71760,3027
  24.  
  25. Topics in this file
  26.  
  27.        Installation
  28.        Configuration
  29.        Operation
  30.        Using the City Editor
  31.               GMT Offsets
  32.               Day Light Savings
  33.        Incorrect Times
  34.        LAN Operation
  35.  
  36. Installation
  37. ------------
  38.  
  39. This program was written in Visual Basic which means you must have
  40. VBRUN100.DLL in your PATH (put it in \windows\system if you're not sure).
  41. You can find VBRUN100.DLL in the WINADV forum on Compuserve. I did not
  42. include it in my zip file so that you don't have to pay to download it if
  43. you already have it.
  44.  
  45. The files TIMEZONE.EXE and TIMEZONE.DAT should be copied to the
  46. same directory. You may copy them to a new directory, or to an
  47. existing directory. The file TIMEZONE.DAT MUST be in the same
  48. directory as TIMEZONE.EXE.
  49.  
  50. TIMEZONE.DAT contains cities by their names. If you wish to use airport
  51. codes instead (JFK instead of New York), copy TIMEZONE.APT to
  52. TIMEZONE.DAT.
  53.  
  54. Once you have the files in the directory of your choosing, do the
  55. following:
  56.  
  57. Select the group in Program Manager where you want to place the
  58. World Time program. From the Program Manager menu, select File then New.
  59. The "New Program Object" window will open. Select "Program Item" and
  60. then click on "OK".
  61.  
  62. In the "Program Item Properties" field, enter any description you
  63. wish such as "World Time". In the command line field, enter the fully
  64. qualified program name, for example "C:\TIMEZONE\TIMEZONE.EXE".
  65.  
  66. In the "Working Directory" field, enter the path to the program such as
  67. C:\TIMEZONE. Click on OK.
  68.  
  69. The World Time icon will now appear in the selected group. Double click
  70. on the World Time icon to start the program.
  71.  
  72. Configuration
  73. -------------
  74.  
  75. After starting World Time for the first time, you should go into the SETUP
  76. window to configure the program. If you are in the United States, setup is
  77. very simple. Select the Time Zone you are in: Eastern (EST), Central (CST),
  78. Mountain (MST) or Pacific (PST). If Daylight Savings is in effect (mid-Spring
  79. to mid-Fall), turn on Daylight Savings.
  80.  
  81. If you are not in one of the four listed time zones, then you need to enter
  82. the correct GMT offset. The easiest way to do this is to go to the editor,
  83. find your city and its GMT, then return to SETUP and enter the GMT.
  84.  
  85. For example, if you live in Frankfurt, go into the Editor and type "F" then
  86. ALT-DownArrow. Press the DownArrow until you get to Frankfurt and finally
  87. press ALT to select Frankfurt. You will see the GMT Offset for Frankfurt
  88. is 1.00. Return to the SETUP Window, and enter 1.00 in the GMT Offset field.
  89.  
  90. Once you have completed the SETUP Window, press OK. Now check the times of
  91. a few cities that you know what the current time is to make sure that you
  92. have correctly configured World Time.
  93.  
  94. Operation
  95. ---------
  96.  
  97. When the World Time program starts, you will see your current time, the
  98. GMT time, and the time for the first city in the TIMEZONE.INI file. To
  99. see the time zone in another city, you can click on the down arrow and
  100. then scroll through the cities. You can also use the up and down arrow
  101. keys to scroll through the cities.
  102.  
  103. You can also type in the name of the city. As soon as you type in enough
  104. characters of the city to fully qualify it, it will appear.
  105.  
  106. To exit the program, use ALT-F4 or the Quit button.
  107.  
  108. Using the City Editor
  109. ---------------------
  110.  
  111. You can Add, delete, and change cities that World Time knows about. From
  112. the main window, click on Edit. This puts you in the city editor.
  113.  
  114. To add a new city, enter the correct city name (overwriting the current),
  115. and enter the correct GMT Offset and Day Light Savings flag. Once you are
  116. satisfied, click on the Add key.
  117.  
  118. To modify or delete a city, you must first find it. Use the mouse or the
  119. keyboard to select the city from the city box.
  120.  
  121. To update the city, make the desired changes, then click on the Update key.
  122.  
  123. To delete the city, click on the update key. You will be asked to verify the
  124. deletion before the record is actually deleted.
  125.  
  126. GMT Offsets
  127. -----------
  128.  
  129. Determining the correct GMT Offset is easiest done by finding an existing
  130. city in the same timezone. For example, to add Dusseldorf, first find
  131. Frankfurt's GMT and then use it for DusselDorf.
  132.  
  133. Day Light Savings Flag
  134. ----------------------
  135.  
  136. This flag indicates the city observes Day Light Savings when it is in effect.
  137. This flag does not indicate that day light savings is currently in effect
  138. (that is done in the Setup Window).
  139.  
  140. For example, Chicago observes Daylights Savings (as does nearly all U.S.
  141. cities); however, Phoenix does not. You will see that Phoenix does not have
  142. this flag set.
  143.  
  144. I currently have no way of knowing which foreign cities use Day Light Savings
  145. so most of those cities have the Day Light Savings flag turned off.
  146.  
  147. Incorrect Times
  148. ---------------
  149.  
  150. If World Time comes up with a wrong time, there are two likely reasons: the
  151. GMT offset is wrong, or the Day Light Savings flag is wrong. If you find such
  152. a mistake, please let me know so that the next version of World Time has the
  153. data corrected.
  154.  
  155. World Time's GMT Offset comes from a corporate Data Base and has a high
  156. probability of being correct. The GMT is an offset from the Greenwich
  157. Median Time (the time in London when Day Light Savings in not in effect).
  158.  
  159. There is a map of GMT Offsets in the "Information Please" Almanac. This map
  160. is not very detailed, but will probably be suitable enough if you already
  161. know exactly where the city is.
  162.  
  163. The more probable reason for the time being incorrect is Day Light Savings.
  164. In the US, Day Light Savings exists in nearly every city, but I do not
  165. currently know who is using Day Light Savings outside of the US other than
  166. England (they use it).
  167.  
  168. As such, I have assumed no foreign cities use Day Light Savings. If you call
  169. another country and find out that World Time is wrong by 1 hour, find out if
  170. they are using Day Light Savings. If so, update the city using the city
  171. editor, and the time will be correct. I hope to find some reference to
  172. day light savings in other countries so that World Time can correctly take
  173. day light savings into account.
  174.  
  175. LAN Operation
  176. -------------
  177.  
  178. I have World Time running on a Netware 3.11 LAN. Both TIMEZONE.EXE and
  179. TIMEZONE.DAT are placed in a read-only directory. When a user cannot
  180. gain write access to the TIMEZONE.DAT file, the SETUP and EDIT keys are
  181. disabled.
  182.  
  183. Modification History
  184. --------------------
  185.  
  186. A.0.4:  Dec 14 1992.
  187.  
  188.     Enh: The Window's position at closing is saved and used next time the
  189.     application is run.
  190.  
  191. A.0.3:  Dec 12 1992.
  192.  
  193.     Fix: When typing in the name of a city, after a city is fully qualified,
  194.     any other key resets the search (instead of just control-home).
  195.  
  196.     Enh: The active city is saved on exit and will be recalled when the
  197.     program starts. Note: this is done by adding the [TimeZone] section
  198.     header in the WIN.INI file.
  199.  
  200. A.0.2:  Nov 30 1992.
  201.  
  202.     Enh: Created new TIMEZONE.DAT file with 450 cities. NOTE: because
  203.     of the large number of cities loaded, TIMEZONE loads slower than
  204.     previously (it takes about 5 seconds on my 386/33). If the load
  205.     time is unacceptable, you could delete cities from the data base.
  206.  
  207.     Enh: The TimeZone Code may now contain fractions for those cities 
  208.     that are 1/4, 1/2, or 3/4 of a time zone. For example, India uses a  
  209.     GMT offset of 5.5. In the entire data base I include, only one city, 
  210.     Kathmandu uses 3/4 and none use 1/4.
  211.  
  212.     Enh: Redesigned the form to display all of the data in the smallest
  213.     possible window.
  214.  
  215.     Enh: Added Online Help.
  216.  
  217.     Enh: Added City Editor
  218.  
  219.     Enh: New TimeZone.DAT format that allows easy updating for the city
  220.     editor.
  221.  
  222.     Enh: When program is minimized, the timer interrupt is disabled so the
  223.     program does not use any time.
  224.  
  225.     Enh: Setup screen now allows any GMT Offset.
  226.  
  227.     Fix: When scrolling through cities (without using the scroll bar - 
  228.     ie. dragging), a subscript out of bounds would occur. While scrolling, 
  229.     the timer interrupt keeps occuring, using what ever city index was 
  230.     current. Apparently, this index is not always valid when using the 
  231.     drag method of scrolling. Now the program turns off the clock for the 
  232.     city during selection of a city. The other two clocks continue to be 
  233.     updated.
  234.  
  235. A.0.1:  Jul 5, 1992.
  236.  
  237.     Fix: Removed use of True Type fonts so program will display
  238.     correctly on Windows 3.0.
  239.  
  240.     Fix: Initial form now starts in the upper left hand corner.
  241.  
  242.     Enh: Added Date and AM/PM indicator.
  243.  
  244.     Enh: Local Time Zone, Daylight Savings flag, and location Database
  245.     is now loaded from a file allowing end-user to change.
  246.  
  247.     Enh: Allow configuration in program via the new Options window.
  248.  
  249. A.0.0: Jun 16, 1992.
  250.  
  251.     Initial Release.
  252.