home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / maps / terra50z / tt.doc < prev    next >
Text File  |  1991-01-02  |  32KB  |  659 lines
  1.  
  2.  
  3.  
  4.  
  5.          ************************************************************
  6.          *                                                          *
  7.          *                                                          *
  8.          *               T  E  R  R  A  *  T  I  M  E               *
  9.          *                                                          *
  10.          *                        Version 5.0                       *
  11.          *                                                          *
  12.          *                      (C)opyright 1990                    *
  13.          *                    All Rights Reserved                   *
  14.          *                                                          *
  15.          *==========================================================*
  16.          *                                                          *
  17.          *                    GeoGraphics Software                  *
  18.          *                   126 Mountain View Road                 *
  19.          *                    Glastonbury, CT 06033                 *
  20.          *                                                          *
  21.          *----------------------------------------------------------*
  22.          *                                                          *
  23.          *     Terra∞Time is user-supported software provided to    *
  24.          *   you at no charge on a trial basis.  If you use this    *
  25.          *   software and find it of value please register your     *
  26.          *     copy for $20.00 and support the shareware concept.   *
  27.          *    Registered users will be provided with information    *
  28.          *    about program updates. Please make checks payable     *
  29.          *          to G. K. Marek at the above address.            *
  30.          *                                                          *
  31.          *      You are encouraged to share this software with      *
  32.          *      others provided that it is distributed complete     *
  33.          *      with documentation and in unmodified form and       *
  34.          *     that no fee or other consideration is charged or     *
  35.          *     accepted.  All commercial, business and government   *
  36.          *           users must register each copy in use.          *
  37.          *                                                          *
  38.          *  We hope you enjoy using Terra∞Time.  Your comments and  *
  39.          *  suggestions to improve this product are always welcome. *
  40.          *  Please refer to TT Version Number 5.0 in your comments. *
  41.          *                                                          *
  42.          *                                                          *
  43.          ************************************************************
  44.  
  45.  
  46.  
  47.  
  48.  
  49. PROGRAM DESCRIPTION
  50.  
  51. Terra∞Time is a program which tracks and displays the local time in as
  52. many as 64 cities all around the globe.  Unlike other programs of this
  53. type, Terra*Time accounts not only for time zone effects but also for
  54. daylight savings time at each city.  Information is provided on a
  55. full-screen color display.  Windows and menu-driven commands are used
  56. for program modifications.  Program options provide users with the
  57. ability to tailor the display for their specific needs.  Military or 12
  58. hour clock can be selected and the layout of the world map can be varied
  59. to suit the user.  Additional program features include time zone
  60. differences, great circle distances between cities, currency conversion
  61. and a special alarm feature which can be set for any world city time.
  62.  
  63.  
  64. HARDWARE REQUIREMENTS
  65.  
  66. This program is designed for IBM Personal Computers and close
  67. compatibles.  It will execute on the IBM-PC, PC-XT, PC-AT, PS/2 and
  68. PC-jr.  DOS Version 2.0 or later is required.  Terra∞Time does not
  69. require an internal clock and will accept the time set by you during DOS
  70. boot-up.  Of course, the use of the internal clock will allow for
  71. automatic timekeeping.
  72.  
  73. Since the program relies extensively on color, a color monitor is
  74. recommended.  The program will run, however, unmodified, on many
  75. monochrome machines.  Terra∞Time requires about 128K of memory and does
  76. not require BASIC to operate.
  77.  
  78.  
  79. PROGRAM FILES
  80.  
  81. The Terra∞Time system comes in five files which are transmitted in a
  82. special self-extracting archive file called TERRA50.EXE.  Just running
  83. this file causes it to create a fresh original copy of all of the files
  84. below (no archiving programs are required):
  85.  
  86.     File        Size    Description
  87.     ---------  ------   --------------------------------------------
  88.     TT.EXE     104472   executable program module
  89.     TT.DAT              default settings and cities information
  90.     TTDAT.BAK           back-up duplicate copy of TT.DAT
  91.     TT.DOC              documentation file (ASCII); (this file)
  92.     TTREAD.ME           short program description with latest changes
  93.  
  94. The first two files must reside on the current directory or
  95. path for the program to be accessible.
  96.  
  97. None of these files is copy-protected.  The original self-extracting
  98. archive file (TERRA50.EXE) should be saved as a backup on a separate
  99. disk.  Just run this file again to create a fresh original copy of all
  100. the above files.
  101.  
  102. Please distribute as shareware only the archive file TERRA50.EXE since
  103. it contains all of the program files in their original state in a
  104. compact, single package.
  105.  
  106. Terra∞Time is executed from the current directory or path with this
  107. command at the DOS prompt:
  108.  
  109.                  TT [FN]
  110.  
  111. The optional argument [FN] (FileName) allows the user to specify an
  112. alternative data file to read in city information.  If [FN] is omitted,
  113. data is read from the file called TT.DAT.  If a filename is specified
  114. without an extension, Terra∞Time adds .DAT as the extension.  The data
  115. filename used is displayed in the upper left of the map unless it is
  116. TT.DAT.
  117.  
  118.  
  119. PROGRAM START-UP
  120.  
  121. Upon execution, Terra∞Time will load from the current directory and
  122. access the data file (either TT.DAT or [FN]) to load current settings
  123. and cities information.  Once the program and data are loaded, the
  124. program no longer requires these files unless a new configuration is
  125. saved to disk for future use.  The program is virtually self-explanatory
  126. and uses menus extensively.  The program will load into [AutoTime] mode
  127. incorporating the default values and cities information in the selected
  128. datafile at time of execution.
  129.  
  130.  
  131. GENERAL PROGRAM FEATURES
  132.  
  133. Terra∞Time generates a stylized world map with cities indicated by three
  134. letter codes.  The map is divided into 24 time zones each of which is
  135. further divided into three twenty-minute segments.  One timezone,
  136. normally the one you are in, is specially designated as the "Local"
  137. timezone.  The local timezone city (initially set by the program
  138. defaults to New York) is indicated on the top scale by a magenta symbol.
  139. Time and date details about the local time zone as indicated in the
  140. center of the black area below the world map.  The local time indication
  141. is standard time if it is shown in yellow and daylight savings time if
  142. it is shown in brown.
  143.  
  144. The black background on the map itself indicates the portion of the
  145. globe in darkness and moves with the time in twenty minute intervals.
  146. The shape of this background changes with the seasons in the form of a
  147. sinewave to describe true sunrise and sunset.  Cities are indicated on
  148. the map in bright yellow if they are presently on standard time and in
  149. brown if they are presently on daylight savings time.
  150.  
  151.  
  152. HOUR-DAY SCALE
  153.  
  154. Across the bottom of the world map is an hour-day scale with some
  155. features in white and some in yellow.  The white (upper) scale indicates
  156. the STANDARD time in that particular world zone.  One point on this top
  157. scale is the yellow letter M which represents midnight; N indicates
  158. noon.  The lower scale, in yellow, is in the form:
  159.  
  160.                           << Sun | Sat >>
  161.  
  162. and is used to determine the day of the week for any time zone.  The
  163. symbol | represents the International Date Line in the central Pacific
  164. Ocean.  In this example, from this symbol to the left (west), it is
  165. Sunday until the M (midnight) symbol is encountered on the scale above.
  166. It is Saturday toward the east until the M symbol.  Of course, the scale
  167. wraps around at the left and right edges of the map.
  168.  
  169.  
  170. A WORD ABOUT TIME SYSTEMS
  171.  
  172. Terra∞Time displays time using the standard US AM/PM 12 Hour Clock and the
  173. International (or Military) 24 Hour Clock.  However, for simplicity, all
  174. INPUTS to Terra∞Time must be given using the 24 Hour Clock (the same as
  175. DOS).  Some examples of the relationships between the two systems are
  176. shown below:
  177.  
  178.  
  179.                      US/12 Hr   Intl/24 Hr    Input      Input
  180.                                               HH:MM:SS   HHMM
  181.  
  182.          MIDNIGHT    12:00 AM      00.00      00:00:00   0000
  183.                      12:37 AM  =>  00.37      00:37:00   0037
  184.                       1:24 AM      01.24      01:24:00   0124
  185.                      11:08 AM      11.08      11:08:00   1108
  186.  
  187.          NOON        12:00 PM      12.00      12:00:00   1200
  188.                      12:15 PM  =>  12.15      12:15:00   1215
  189.                       3:59 PM      15.59      15:59:00   1559
  190.                      11:49 PM      23.49      23:49:00   2349
  191.  
  192.  
  193.  
  194. The ACTUAL local time (whether daylight or standard) should be input and
  195. Terra∞Time will take care of the rest.  If you have an internal computer
  196. clock, you must set it forward and back during switches between daylight
  197. and standard time just as you do with your other clocks.
  198.  
  199. Some computers have clocks that lose the seconds when time is reset.
  200. For example, the time 10:15:53 would be set to 10:15:00 and 53 seconds
  201. would be lost.  In these cases time adjustments should be made just
  202. after the minute has turned to minimize this time loss effect.
  203.  
  204.  
  205.  
  206. PROGRAM FEATURES
  207.  
  208. Terra∞Time incorporates a number of special features and options which
  209. are explained below.  These features are accessed by selecting the
  210. letter [F] from the [AutoTime] mode.  The program can be exited with a
  211. single keystroke from this mode by pressing the <Escape> key.
  212.  
  213. The menus are executed by selecting the first letter of the desired
  214. option.  Options followed by periods (e.g., [S]ettings..) indicate that
  215. other menus will follow.
  216.  
  217.  
  218. CITY CODES
  219.  
  220. The cities are plotted on the world map using a special city code.  Also
  221. some program features require that a particular world city be
  222. identified.  Each city has been assigned a three letter abbreviation.
  223. These abbreviations can be changed to suit the user.  For example, the
  224. code NYC could be changed to JFK to represent John F. Kennedy airport,
  225. or to HQ, for Corporate Headquarters.  Three letters is a default for
  226. this code, but one to ten characters is acceptable.  It could even be
  227. altered to HFD, (or to "HARTFORD") for Hartford, Connecticut, a nearby
  228. city with the same parameters as New York.  The program allows, and
  229. comes set up with, 59 cities and 5 dummy cities for additional user
  230. input.  The 5 dummy cities are included at the end of the list and are
  231. called ZZZ1, ZZZ2, ZZZ3...  Once a city is renamed, it will appear in
  232. its proper alphabetical order in the city list.  Any of the 59
  233. established cities can also be revised.  So the cities can become
  234. HAM radio stations, corporate subsidiaries, or pen pals.
  235.  
  236. ALARM
  237.  
  238. The Terra∞Time alarm can be set for a specific time in a specific world
  239. city.  This could be the local time or the time in a foreign location.
  240. For example, assume that you are in New York.  You can set the clock to
  241. ring when it is 7PM (1900) in Paris without having to compute time
  242. differences simply by indicating PAR and 1900 when the alarm is set.
  243. Terra∞Time keeps track of the timezones and any savings time that might be
  244. in effect at either city.
  245.  
  246. Activating the alarm will illuminate a note in the lower left corner of
  247. the screen.  The alarm will ring and flash at the appropriate time,
  248. chiming every five seconds for one minute or until any key is selected
  249. to stop it.  The alarm will be turned off once it has rung and will have
  250. to be activated again even to ring again at the same time on the next
  251. day.  The command [Activate] will engage the alarm with the current
  252. settings unchanged.  The [LOC] city code can be used for local time
  253. alarm.  Be sure to input the alarm time in HHMM format, two digits for
  254. the hours and two for the minutes using a 24 Hour clock.
  255.  
  256.  
  257. TIMEZONES
  258.  
  259. The [TimeZones] feature allows you to check the number of hours
  260. (timezones) any city is ahead or behind any other.  A base zone is
  261. initially set to the local city but can be moved to any other city, one
  262. zone at a time, with the [W]est or [E]ast keys.
  263.  
  264.  
  265. LOCK SCREEN
  266.  
  267. Selecting the LockScreen feature allows the user to leave the world
  268. timer map running normally while he leaves the computer with the
  269. keyboard locked so that it cannot be accessed by another person.
  270. Carefully enter a secret code you will remember because you will have to
  271. restart your computer if you forget it.  The flashing bullet will remind
  272. you that this feature is set.  You simply re-enter the secret code to
  273. unlock the program.  When you re-enter the first character the bullet
  274. will change to a question mark to acknowledge your entry.  If you make a
  275. mistake while entering the code, just press the <ENTER> or <RETURN> key
  276. and try again.
  277.  
  278.  
  279. DISTANCES
  280.  
  281. Terra∞Time can also compute the distance between any of the cities in
  282. the program database (not just those shown on the map).  A listing of
  283. cities is windowed.  The distance shown is the "great circle distance,"
  284. which is the shortest distance between the two points on a globe.  This
  285. distance is provided in statute miles (ordinary measure) or in nautical
  286. miles, a system used extensively in air and sea navigation.  One
  287. nautical mile is about 1.151 statute miles.  In addition, each city
  288. distance calculation includes a bearing computation which is the true
  289. heading from the origination city to the destination city.  A bearing of
  290. 90 degrees means that the destination is due east of the origination
  291. city.  This feature is useful for aligning antennas.
  292.  
  293.  
  294. CURRENCY
  295.  
  296. The Currency features determines the monetary rate of exchange between
  297. the countries of the two cities selected.  Since these values are
  298. constantly changing, this conversion rate should be considered as only a
  299. rough estimate.  Currency information can be updated on the [CityData]
  300. menu.  Information for many countries is generally available from the
  301. Wall Street Journal.  The exchange rates provided in TT.DAT are from the
  302. December, 1989, International Financial Statistics published by the
  303. International Monetary Fund, Washington D.C.
  304.  
  305.  
  306. TIMESET/DATESET
  307.  
  308. Times and dates must be valid and follow the format specified.  Dates
  309. cannot precede 1980 since DOS will not recognize any date before
  310. 1-Jan-1980.  Since the Local Time display also computes the
  311. day-of-the-week, this feature will allow the determination of the
  312. day-of-the-week on which some future date will occur, such as a birthday
  313. or Christmas.
  314.  
  315.  
  316. MAPSHIFT
  317.  
  318. The displayed map can be centered on the US, on Europe, or on the Far
  319. East with this option.  There is no effect on the time.
  320.  
  321.  
  322. 12/24 HOUR SELECTION
  323.  
  324. The times displayed with the cities on the map can be presented in
  325. either U.S. 12/Hr format or Intl 24/Hr format using this option.  The
  326. U.S. format suppresses leading zeros.
  327.  
  328.  
  329. LOCALZONE
  330.  
  331. Any city in the Terra∞Time city list can be designated the Local time
  332. city.  The Local Time strip in the black area below the map will take on
  333. the attributes of this designated city and the LocalZone marker on the
  334. top scale will move.  When a new LocalZone is selected the times in all
  335. cities remain unchanged.  Only the alarm, local time strip and other
  336. features using the local time are affected.
  337.  
  338. SOUND COMMAND
  339.  
  340. The sound command enables and disables all program sound.  This setting
  341. is save in the datafile for subsequent default use.  All sound,
  342. including hourly blips and alarm sound is suppressed.
  343.  
  344.  
  345. HEADER COMMAND
  346.  
  347. The title line at the top center of the world map is input with the
  348. header command.  It is automatically centered.  This header is saved
  349. with the other program settings in the datafile.  Any ASCII characters
  350. can be used.
  351.  
  352.  
  353. FILE COMMAND
  354.  
  355. When you have chosen a configuration of features and cities that you
  356. prefer, they can be saved to the TT.DAT file (or other file you specify)
  357. and subsequently automatically loaded with the program.  Any changes
  358. made in program features or options will be in effect only for the
  359. remainder of the current session unless they are saved with the [File]
  360. command.  Once a new configuration is saved in a data file the previous
  361. configuration in that file is erased.  Be sure a backup copy of
  362. TERRA50.EXE has been saved in case you want to start over or reinstate
  363. the original options.  A file called TTDAT.BAK is provided as a backup
  364. duplicate of the original TT.DAT file.
  365.  
  366.  
  367. CITIES DISPLAY
  368.  
  369. The marked cities are set for display on the screen.  Unmarked cities
  370. are not shown.  The mark is toggled with the [Enter] key.
  371.  
  372.  
  373. MOVECITY COMMAND
  374.  
  375. The selected city from the window is moved to a new plotting location
  376. on the map using the arrow keys.  [Enter] fixes the new location, and
  377. [Esc] cancels the move.  Only cities which are displayed can be moved.
  378.  
  379. The 59 cities have been carefully selected and plotted so they remain
  380. relatively true to their intended time zones but so that a minimum will
  381. overlap when they are displayed.  Thus many cities can be displayed
  382. together at once.  Since many U.S. and European cities are close
  383. together, they will overlap if they are all selected at once.  Select
  384. and move cities to provide the most attractive display; but, if
  385. possible, try to keep cities vertically within their correct zones.
  386.  
  387. The following charts show the actual plotting locations in TT.DAT as
  388. a program default.  This will give some idea of which cities can
  389. be displayed and moved to suit your particular purpose.  Remember,
  390. on the chart below each box represents only one plotting character.
  391. The house symbol will plot at this location followed by the city code
  392. (of length 1 to 10) and then the time itself (of length 4 to 6).
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                     UNITED STATES PORTION OF WORLD MAP
  401.        <----WEST                                           EAST---->
  402.             ZONE 9         ZONE 8         ZONE 7         ZONE 6
  403.  
  404. CODE D ║ 90   91   92 ║ 80   81   82 ║ 70   71   72 ║ 60   61   62 ║
  405.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  406. CODE   ║    ║ VCR║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  407. E    8 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  408.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  409.        ║    ║ SEA║    ║    ║    ║    ║ MSP║    ║    ║ TOR║ MTL║    ║
  410.      9 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  411.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  412.        ║    ║ SFO║    ║    ║ DEN║    ║    ║ CHI║ DTW║    ║ PHL║ BOS║
  413.     10 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║ WSH║ NYC║
  414.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  415.        ║    ║    ║ LAX║    ║    ║ DFW║    ║    ║    ║ ATL║    ║    ║
  416.     11 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║ MIA║    ║    ║
  417.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  418.        ║    ║    ║    ║    ║    ║ MEX║    ║    ║    ║    ║    ║    ║
  419.     12 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  420.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  421.  
  422.  
  423.                         EUROPEAN PORTION OF WORLD MAP
  424.        <----WEST                                           EAST---->
  425.             ZONE 1         ZONE 0         ZONE 23        ZONE 22
  426.  
  427. CODE D ║ 010  011  012║ 000  001  002║ 230  231  232║ 220  221  222║
  428.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  429. CODE   ║    ║    ║    ║    ║    ║ STO║ HEL║    ║    ║    ║    ║    ║
  430. E    7 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  431.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  432.        ║    ║ LON║ AMS║ CPH║    ║    ║    ║    ║    ║ MOS║    ║    ║
  433.      8 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  434.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  435.        ║    ║    ║ PAR║ FRA║ ZRH║ VIE║    ║    ║    ║    ║    ║    ║
  436.      9 ║    ║    ║    ║ GVA║    ║    ║    ║    ║    ║    ║    ║    ║
  437.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  438.        ║ MAD║    ║    ║ ROM║    ║    ║    ║    ║    ║    ║    ║    ║
  439.     10 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  440.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  441.        ║    ║    ║    ║    ║    ║    ║    ║ CAI║    ║    ║    ║    ║
  442.     11 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  443.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  444.  
  445.  
  446. CITYDATA COMMAND
  447.  
  448. The [CityData] command allows the user to see and change the
  449. attributes of the cities provided in the Terra∞Time database.  For
  450. example, any city can be shown or deleted from the map display.  The
  451. following information about each city is displayed and can be altered as
  452. indicated.
  453.  
  454. CODE - The city code is a one or more character designation.  The
  455. default provided in the original data file is a three letter character
  456. code.  This code is used to identify the city on the map and to select
  457. and save city features.  Any code except LOC can be selected.  For
  458. example, NYC could be replaced by MAN (for Manhattan).
  459.  
  460.  
  461. ZONE - The zone parameter represents the number of timezones east
  462. (positive) or west (negative) of the Prime Meridian (Greenwich, England)
  463. that the subject city lies.  For example New York Zone is -5.0 and Paris
  464. is 1.0.  Some cities are in timezones which are not an exact integer
  465. number of hours from GMT (Greenwich Mean Time).  Bombay, India, for
  466. example, is 5 and one-half hours ahead of GMT. Its zone is indicated as
  467. 5.50, with the .50 indicating 0.50 hours more advance than five hours.
  468. This method is a change from earlier program versions.  Believe it or
  469. not, there are quarter hour timezones in Nepal and other areas.  Any
  470. fractional zone can now be specified as indicated above.
  471.  
  472.  
  473. START DATE OF DAYLIGHT SAVINGS TIME
  474.  
  475. This is a four digit value which indicates the month and day that is the
  476. first day of daylight savings time for this city.  It is specified in
  477. the form MMDD, so 0531 would mean May 31st is the first day of daylight
  478. savings time.  DD can be specified as 00 to indicate that the day should
  479. be the last Sunday of that particular month; for example 0400 would mean
  480. that daylight savings time should start the last Sunday of April.  A
  481. face with a question mark will appear in the lower left of the screen on
  482. the dates the program is told daylight savings time starts and ends in
  483. the local timezone city.  This icon is a reminder to set the clock
  484. forward in the spring and backward in the fall (Northern hemisphere).
  485.  
  486.  
  487. END DATE OF DAYLIGHT SAVINGS TIME
  488.  
  489. This value indicates the LAST day of daylight savings time.  Otherwise,
  490. the comments indicated above for START apply.  Note that it is possible
  491. for the END date to precede the START date when summer comes in the
  492. months of December, January and February as it does in the Southern
  493. hemisphere.
  494.  
  495.  
  496. DAYLIGHT SAVINGS TIME
  497.  
  498. Daylight savings time is a convenience adopted by many localities during
  499. the summer months depending upon their particular needs and their
  500. geographic location.  The information provided for the cities in
  501. Terra∞Time was accurate for 1987-1988.  But these rules are subject to
  502. change depending upon legislation in each country.  For this reason
  503. Terra∞Time allows the changing and saving of information relating to
  504. daylight savings time in the [CityData] menu.  Data regarding country
  505. time zones and daylight savings time rules is available from the local
  506. library or in a reference called the Official Airline Guide (OAG) which
  507. is published monthly and used by most travel agents in the United
  508. States.
  509.  
  510. The Timezone information in this program is data from the February,
  511. 1990, Official Airline Guide.
  512.  
  513.  
  514. NATIONDATA COMMAND
  515.  
  516. Since all cities in a nation use the same monetary units and many cities
  517. have the same start and end daylight dates, this feature allows the
  518. change of these parameters for all cities with the same country code at
  519. one time.  Simply select this option and choose any city with the
  520. desired country code.  Then input the new currency and/or daylight
  521. savings dates and all of the cities' data is automatically changed.
  522.  
  523.  
  524. CREDITS
  525.  
  526. This program uses special functions from the excellent Advanced Function
  527. Library for the Basic Compiler called ADVBAS.LIB v3.4, (C) Thomas Hanlin
  528. III, Alexandria, VA, available on many bulletin boards.
  529.  
  530. Some copies of Terra∞Time are distributed via an excellent self-
  531. extracting archive program called PKARC version 3.5, dated 27 April
  532. 1987, and available from PKWARE, Inc., 7032 Ardara Avenue, Glendale, WI
  533. 53209.
  534.  
  535. I hope Terra∞Time will prove to be of value to you.  Please contact the
  536. author with any problems, useful comments or suggestions at the address
  537. at the top of this file.
  538.  
  539. *+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*
  540.  
  541. TERRATIME SCREENS FLOWCHART
  542.  
  543. [AutoTime]
  544.  ┌ [Esc]                   - Exit from TerraTime
  545.  └ [F] Features..
  546.     ┌ [A] Alarm..
  547.     │  ┌ [A] Activate
  548.     │  ├ [H] Halt
  549.     │  ├ [S] Set
  550.     │  └ [R] Return
  551.     ├ [T] Timezones        -Display City Time Differences
  552.     ├ [L] LockScreen       -Lock Screen with Secret Code
  553.     ├ [D] Distances        -Compute Distances BetweenCities
  554.     ├ [C] Currency         -Currency Conversion Between Cities
  555.     ├ [I] Info             -Displays GeoGraphics Information
  556.     ├ [R] Return           -Return to [AutoTime]
  557.     ├ [Q] Quit             -Exit from TerraTime
  558.     └ [S] Settings..
  559.        ┌ [T] TimeSet       -Set Internal Computer Clock Time
  560.        ├ [D] DateSet       -Set Internal Computer Clock Date
  561.        ├ [M] Mapshift      -Select Central Map Area
  562.        ├ [1] 12/24 Hr      -Choose between Time Formats
  563.        ├ [L] LocalZone     -Select Alternate Local City
  564.        ├ [S] Sound         -Enable/Disable Sound Effects
  565.        ├ [H] Header        -Designate Title at Top of Map
  566.        ├ [F] File          -Save Current Settings to Disk File
  567.        ├ [R] Return        -Return to Previous Screen
  568.        ├ [Q] Quit          -Leave Program; Changes NOT Saved
  569.        └ [C] Cities
  570.           ┌ [D] Display    -Include/Exclude Cities from Display
  571.           ├ [M] MoveCity   -Use Arrow Keys to Move City Location on Map
  572.           ├ [C] CityData   -Alter City Data (Name, Latitude, etc.)
  573.           ├ [N] NationData -Alter Data for Nation (all cities)
  574.           └ [R] Return     -Return to Previous Screen
  575.  
  576. *+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*
  577.  
  578. ADVANCED PROGRAMMING CONSIDERATIONS
  579.  
  580. NOTE:  ALL FEATURES IN TERRA∞TIME ARE NOW AVAILABLE FROM WITHIN THE PROGRAM
  581. ITSELF, SO IT IS NOT NECESSARY TO READ OR UNDERSTAND THIS SECTION.
  582. IT IS PROVIDED SIMPLY AS DOCUMENTATION OF THE STRUCTURE OF THE DATAFILE.
  583.  
  584. Terra∞Time is compiled in Basic and reads all of the city information as
  585. well as the default settings from an ASCII file.  The default file is
  586. called TT.DAT but any filename can be specified.  It is not necessary to
  587. examine or edit this file since all values can be conveniently changed
  588. from directly inside of Terra∞Time.  This file can be edited with any
  589. text editor.  Make sure the edited file is saved in "ASCII" format by
  590. your editor or word processor.  The first line of the data file contains
  591. a 40 character header (or title) which will appear centered on the top
  592. portion of the display.  This line can be revised to display any heading
  593. the user desires, but two double quotes is succession ("") are not
  594. allowed.  The next two lines of the file contain default settings,
  595. followed by 64 lines of city data and a terminating line.  Only advanced
  596. users should revise this file since its formatting is critical to ensure
  597. proper reading of the data by the program.  Always save a backup copy
  598. just in case.  The format of some typical city data lines is presented
  599. here:
  600.  
  601. COLUMN   1         2         3         4         5         6         7         8
  602. 12345678901234567890123456789012345678901234567890123456789012345678901234567890
  603.  
  604. FIELD A         B   C     D  E    F   G    H    I    J       K    L       M     N
  605.  
  606. "JAKARTA",      0,"JKT",181,15,  7.00,0,   0,   0, -6.07,-106.39,"IA",1791.05,"Indonesian Rupiahs"
  607. "JOHANNESBURG", 1,"JHB",231,17,  2.00,0,   0,   0,-26.08, -28.15,"SA",   2.63,"S African Rand"
  608. "KARACHI",      0,"KHI",212,12,  5.00,0,   0,   0, 24.54, -67.09,"PK",  21.19,"Pakistani Rupees"
  609. "LAGOS",        0,"LGS",  0,14,  1.00,0,   0,   0,  6.35,  -3.19,"NG",   7.37,"Nigerian Naira"
  610. "LIMA",         0,"LIM", 61,15, -5.00,1, 101, 331,-12.01,  77.07,"PE",4394.51,"Peruvian Intis"
  611. "LONDON",       1,"LON", 11, 8,  0.00,1, 300,1000, 51.28,   0.27,"UK",   0.63,"British Pounds"
  612.  
  613. A comma must delimit (come between) each field and the alphabetic
  614. characters must be in quotes as shown.  The fields have the following
  615. meanings:
  616.  
  617. A => The city name
  618. B => Code to include plotting on map for that city (1) or not (0)
  619. C => City code for plotting on map (default three characters)
  620. D => A code for horizontal plotting location of that city (see below)
  621. E => A code for vertical plotting location of that city (see below)
  622. F => The time zone from Greenwich, England, with eastbound positive
  623. G => Code to indicate daylight savings time is applicable (1) or not (0)
  624. H => Code for start of daylight savings time (described in START above)
  625. I => Code for end of daylight savings time (described in END above)
  626. J => Latitude of city in Degrees and Minutes, with North positive
  627. K => Longitude of city in Degrees and Minutes, with West positive
  628. L => Two letter Country Code to set exchange rates and daylight time
  629. M => Amount of country's currency equivalent to one US Dollar
  630. N => Description of currency and country
  631.  
  632. Code E is a number between 5 and 20 which represents the vertical
  633. plotting location for the given city.  The fifth row down is the highest
  634. (northernmost) plotting location.  The 13th row represents cities that
  635. fall along the equator such as Dakar, in Africa.  The 20th row is the
  636. southernmost plotting position.  You will be able to tell where to plot
  637. a new city by looking at the value of Code E for the cities around it.
  638. All selections for this parameter must be integers from 5 to 20.  The
  639. remainder of the screen is reserved and other values will produce
  640. unpredictable results.
  641.  
  642. Code D is a value which determines the horizontal plotting location of a
  643. particular city.  This code is more complicated than Code E and must be
  644. deciphered to be understood.  The map grid is divided into 24 horizontal
  645. areas, each of which allow three plotting positions, for a total of 72
  646. horizontal plotting locations.  If the last digit of Code D is dropped,
  647. the remaining value is always between 0 and 23.  This code represents
  648. one of the 24 plotting regions starting with Geneva as 0 and moving
  649. westward with New York as 6, Hong Kong as 17, Bombay as 20, and finally
  650. Helsinki as 23.  Note that the last digit of the code is always a 0, 1,
  651. or 2.  This digit represents the plotting position of the point within
  652. the main region with 0 westmost, 1 central and 2 eastmost plotted.  Thus
  653. Chicago, with Code D of 71, is plotted in the central portion of the 7th
  654. zone west.  Note that from west to east the plotting codes would follow
  655. a sequence such as 70,71,72,60,61,62,50,51, etc.  Again, unpredictable
  656. results will occur if these conventions are not followed.
  657.  
  658.                        ** ++ ** ++ ** ++ **
  659.