home *** CD-ROM | disk | FTP | other *** search
/ 1st Canadian Shareware Disc / 1st_Canadian_Shareware_Disc_1991.ISO / comms / xdial122 / dial.doc < prev    next >
Text File  |  1990-02-22  |  37KB  |  1,042 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                 DDDDDDDDDD     IIIIIIII      AAAAAAA      LL
  9.                 DD       DD       II        AA     AA     LL
  10.                 DD        DD      II       AA       AA    LL
  11.                 DD        DD      II       AA       AA    LL
  12.                 DD        DD      II       AAAAAAAAAAA    LL
  13.                 DD       DD       II       AA       AA    LL
  14.                 DDDDDDDDDD     IIIIIIII    AA       AA    LLLLLLLLL
  15.  
  16.  
  17.  
  18.                                   Version  1.21
  19.  
  20.  
  21.                            Released February 13th, 1990
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                         Copyright 1990,  Hasmatallie A. Khan
  59.                                 All rights Reserved
  60.  
  61.  
  62. Introduction
  63. ────────────
  64.  
  65. Welcome, and thank you for trying DIAL.  DIAL is a telephone directory /
  66. dialer for IBM-PCs and compatibles.  DIAL features an integral international
  67. area code / time zone finder and full mouse support.  The telephone directory
  68. size is limited only by the size of your hard disk and a search can find as
  69. many 'hits' as can fit in memory.  All data / system files (except the
  70. program, of course) are plain ASCII files and as such can be edited with any
  71. ASCII text editor.
  72.  
  73. The program should work with any Hayes compatible modem and has been tested
  74. with Hayes, MultiTech and Everex modems.  Systems tested on include IBM-XT,
  75. IBM-AT, CompuAdd, FiveStar, Toshiba and Tandy.
  76.  
  77.  
  78.  
  79.  
  80.  
  81. Support
  82. ───────
  83.  
  84. Support is free and unlimited for registered users of DIAL.  If you do not
  85. register, well... send us a message anyway and we'll think about it.  If
  86. you have any suggestions or comments about the program then we'll be glad
  87. to hear from you even if you're not registered.  Registered users also
  88. receive free telephone support.
  89.  
  90.  
  91.  
  92.  
  93. How to contact the Author
  94. ─────────────────────────
  95.  
  96.          CompuServe Mail :  72770,1507
  97.  
  98.              U.S Mail:       :  15 Southpoint Dr., #307
  99.                                 Dorchester, MA 02125
  100.  
  101.              Channel1 BBS    :  617-354-8873
  102.  
  103.  
  104.  
  105.  
  106.  
  107. Registration
  108. ────────────
  109.  
  110. DIAL is a copyrighted program.  It is not public domain.  The program and
  111. associated data files are distributed as shareware.  You are authorized to
  112. use it for a limited time for evaluation purposes.  If you are satisfied that
  113. this program fulfills a need for you and find yourself using it on a regular
  114. basis, you are ethically obligated to register and pay for it.  The cost of
  115. the program is $50 and a registration form is included in the appendix to
  116. this manual or press Alt-R when in the program to print a registration form.
  117.  
  118. You are encouraged to copy and redistribute, either to friends or by uploading
  119. to BBS's, the unregistered version of this program provided all copyright
  120. screens are intact.  The documentation must not be modified in any way and all
  121. files included in the original distribution package must be distributed
  122. together.  The program package is distributed as XDIAL###.ZIP, where '###'
  123. represents the version number.  This filename must not be changed.
  124.  
  125. Corporate and site licenses agreements are available at reduced rates upon
  126. request.
  127.  
  128.  
  129.  
  130.  
  131.  
  132. Warranty
  133. ────────
  134.  
  135. This product is distributed 'as is' with no expressed or implied warranty.
  136. The author claims no responsibility for any damages caused by the use or
  137. misuse of this program.  The author will not be responsible for any losses
  138. incurred, directly or indirectly, from the use of this product.
  139.  
  140.  
  141.  
  142.  
  143. Other Products
  144. ──────────────
  145. The following shareware programs are also available from the author:
  146.  
  147.     DBSIZE    A database design utility for ORACLE Database Administrators.
  148.         The program assists in determining database space requirements
  149.         for ORACLE databases.  The program runs on an IBM-PC or
  150.         compatible but generates output for ANY hardware / Operating
  151.         System combination on which ORACLE runs.  It features editable
  152.         definition files for quick 'what if' analysis.
  153.  
  154.         This is a program that was originally commercially for $249
  155.         and the exact version is now available $50.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163. Acknowledgements
  164. ────────────────
  165.  
  166. This software was developed with the excellent CXL shareware function library
  167. written by Mike Smedley (BBS: 512-590-0460).
  168.  
  169.  
  170.  
  171. Distribution Files
  172. ──────────────────
  173.  
  174. The program is shipped with the following files:
  175.  
  176.     dial.exe     -  The DIAL program file.
  177.  
  178.     dial.cfg     -  A sample configuration file.
  179.  
  180.     acfile.dat   -  File containing national and international area
  181.             codes and time zone information.
  182.  
  183.     sample.pho   -  A sample telephone directory.
  184.  
  185.     dial.doc     -  The DIAL documentation file.
  186.  
  187.     dinstall.com - Automatic installation batch program.
  188.  
  189.  
  190. The files DIAL.EXE and PHONES.PHO are required for the program to run.  All
  191. others are optional.  However, the program will create a configuration file
  192. a(DIAL.CFG) every time it is run if the file does not exist.  It will also
  193. create a log file (default DIAL.LOG) if the call logging feature is enabled
  194. and the log file does not exist.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. INSTALLATION
  203. ────────────
  204.  
  205. Automatic Installation
  206. ──────────────────────
  207.  
  208. 1.  Go to the directory where the DIAL files are located and type:
  209.  
  210.                             dinstall
  211.  
  212.     You will be asked to enter the pathname of the directory where the program
  213.     and the data files will reside.  Enter the pathname as (for example):
  214.  
  215.                    C:\USR\BIN\  and  D:\DIAL\DATA\
  216.  
  217.     The files will then be copied to the appropriate directories.
  218.  
  219.     The program will prompt you to indicate weather you wish to update
  220.     your AUTOEXEC.BAT file.  If you respond 'YES', you will be prompted to
  221.     select the drive from which your computer boots.  A statement to set the
  222.     DIAL environment variable will be added to the end of AUTOEXEC.BAT.
  223.  
  224.     If you type 'NO', you will have to edit the file and add the environment
  225.     variable statement.  See the "Manual Installation" section for details.
  226.  
  227. That's it!  Now simply type 'dial Name' at your command line prompt to dial
  228. the number.
  229.  
  230.  
  231.  
  232.  
  233. Manual Installation
  234. ───────────────────
  235.  
  236. 1.  Copy the program file (DIAL.EXE) into a directory on your executable
  237.     path.
  238.  
  239. 2.  Copy the data files (DIAL.CFG, ACFILE.DAT, SAMPLE.PHO, DIAL.DOC) to the
  240.     directory in which you wish to store the data files and the log file.
  241.     All other files can be deleted.
  242.  
  243. 3.  Set the environment variable 'DIAL' in your AUTOEXEC.BAT file to point
  244.     to the 'data_dir' directory specified in the previous step.
  245.  
  246.     e.g:  If your data directory is 'C:\USR\DIAL\DATA', edit the
  247.           AUTOEXEC.BAT file and add the line:
  248.  
  249.         SET DIAL=C:\USR\DIAL\DATA\
  250.  
  251. 4.  Set any other environment variables you wish to use. (See section on
  252.     Environment Variables).
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260. CONFIGURATION
  261. ─────────────
  262.  
  263. If the program is started with the -c switch or the configuration utility
  264. called from within the program (Alt-C), the following window will be
  265. displayed:
  266.  
  267.                  ╒════════[ DIAL Configuration ]═════════╕
  268.                  │                                       │
  269.                  │     Phone List: PHONES.PHO            │
  270.                  │                                       │
  271.                  │     Area Code File: ACFILE.DAT        │
  272.                  │                                       │
  273.                  │     Log File: DIAL.LOG                │
  274.                  │                                       │
  275.                  │     Log Calls: YES                    │
  276.                  │                                       │
  277.                  │     Sound: ON                         │
  278.                  │                                       │
  279.                  │     Dial Prefix:                      │
  280.                  │                                       │
  281.                  │     Area Code: 1-617                  │
  282.                  │                                       │
  283.                  │     Modem Port: 1                     │
  284.                  │                                       │
  285.                  │     Case Sensitive: YES               │
  286.                  │                                       │
  287.                  ╘═══════════════════════════════════════╛
  288.  
  289.  
  290.  
  291. You may change any (or all) of the listed items.  For a list of editing
  292. keys while within the entry field, see appendix B.
  293.  
  294.  
  295. 1.  The name of your DIAL directory file.  
  296.  
  297. 2.  The name of the file containing area code data.
  298.  
  299. 3.  The name of the log file in which call information should be stored.
  300.     The program will create this file if the log switch is set and the file
  301.     does not exist.
  302.  
  303. 4.  Call log switch.  The valid values are 'YES', to add all calls to the
  304.     log file, or 'NO' if calls should not be logged.
  305.  
  306. 5.  Sound effects switch.  'ON' by default, or set to 'OFF' to eliminate
  307.     those irritating buzzes and beeps.
  308.  
  309. 6.  Dial prefix.  This is a character string that will be dialed before
  310.     ANY number is dialed.  Useful if you have to dial a number to get an
  311.     outside line from work for instance.
  312.  
  313. 7.  Current area code.  Any numbers in the directory which begin with the
  314.     string specified here will be dialed WITHOUT the area code.
  315.  
  316. 8.  Modem port.  Enter the number of the communications port to which your
  317.     modem is connected.
  318.  
  319. 9.  The default setting for case sensitivity.  Set to 'YES' if you wish
  320.     the searches to be case sensitive or 'NO' if case should be ignored.
  321.     Can be overridden with the '-i' switch.
  322.  
  323. When all the changes are made, the configuration disposition menu is
  324. displayed:
  325.  
  326.           ╒════════[ DIAL Configuration ]═════════╕
  327.           │                                       │
  328.           │     Phone List: PHONES.PHO            │
  329.           │                                       │
  330.           │     Area Code File: ACFILE.DAT        │
  331.           │                                       │
  332.           │     Log File: DIAL.LOG                │
  333.           │                             ╔════[ Disposition Menu ]═════╗
  334.           │     Log Calls: YES          ║                             ║
  335.           │                             ║     Save and Initialize     ║
  336.           │     Sound: ON               ║                             ║
  337.           │                             ║     saVe Only               ║
  338.           │     Dial Prefix:            ║                             ║
  339.           │                             ║     Initialize Only         ║
  340.           │     Area Code: 1-617        ║                             ║
  341.           │                             ║     Continue                ║
  342.           │     Modem Port: 2           ║                             ║
  343.           │                             ║     Quit!                   ║
  344.           │     Case Sensitive: YES     ║                             ║
  345.           │                             ╚═════════════════════════════╝
  346.           ╘═══════════════════════════════════════╛
  347.  
  348.  
  349.  
  350.  
  351.     Save and Initialize    Selecting this option will store the entered
  352.                 data in the configuration file and set the
  353.                 the parameters from the current session to
  354.                 be the same.
  355.  
  356.     SaVe Only        Will save the entered parameters in the
  357.                 configuration file but the parameters for
  358.                 the current session will remain the same as
  359.                 when the program was started.
  360.  
  361.     Initialize Only        Sets the current session's parameters to
  362.                 those just entered but will not save the
  363.                 information in the configuration file.
  364.  
  365.     Continue        Will move the cursor back to the configuration
  366.                 window to allow you to make further changes. 
  367.  
  368.     Quit!            Will exit the configuration function without
  369.                 either setting the current values or saving
  370.                 the data in the configuration file.
  371.  
  372.  
  373.  
  374. If a configuration file is not found when the program is started, a default
  375. configuration is created.  The default values are as specified on the sample
  376. screen above.
  377.  
  378.  
  379. Hint:    If it is necessary to dial a '1' before the area code for long
  380.     distance calls from your area, do not specify '1' as a prefix,
  381.     since the 1 will also be dialed before local calls.  The phone
  382.     numbers added to the data file can include the '1' before the
  383.     area code as part of the number and the 'default area code' entry
  384.     in the configuration file (or the D_DAC environment variable) be
  385.     set to 1 plus your local area code.
  386.  
  387.     e.g:    If you live in the 212 area code, your default area code
  388.         will actually be:
  389.  
  390.                 1-212
  391.  
  392.         and entries in the data file will actually be:
  393.  
  394.                 1-718-555-1234
  395.                 1-212-555-1562
  396.  
  397.  
  398.  
  399.  
  400. ENVIRONMENT VARIABLES
  401. ─────────────────────
  402.  
  403. DIAL looks for and uses the following environment variables:
  404.  
  405.     DIAL        This variable is mandatory if the program will be
  406.             used from any directory other than the one in which
  407.             DIAL was originally installed.  The value should be
  408.             the pathname of the directory which will contain all
  409.             of the files associated with the program.  The
  410.             pathname should end with a backslash ('\').
  411.  
  412.     All of the following environment variables are optional.  If defined,
  413.     the values specified in the environment takes precedence over the
  414.     configuration file.
  415.  
  416.     MODEMPORT    Contains the Communications port to which the modem is
  417.             connected.  Valid ports are 1, 2, 3 and 4.
  418.  
  419.     D_PLIST        The name of the telephone number list file that will
  420.             be used by the program.  This provides an easy way 
  421.             to temporarily change the phone list file for the
  422.             current session.
  423.  
  424.     D_ACODE        The name of the file containing the area code data.
  425.  
  426.     D_LOG        The filename of the call log file.
  427.  
  428.     D_PREFIX    This string should contain any characters which should
  429.             be dialed before the telephone number.  For example,
  430.             any long distance access codes.  Note that this prefix
  431.             will be dialed before ALL numbers.
  432.  
  433.     D_DAC        Default or current area code.  Any telephone numbers
  434.             with this area code will be dialed without the area-
  435.             code.
  436.  
  437.  
  438.  
  439.  
  440. COMMAND LINE SWITCHES
  441. ─────────────────────
  442.  
  443. The following switches are recognized on the command line:
  444.  
  445.     -c    Run the configuration utility.
  446.  
  447.     -i    Turn case sensitivity off.  By default, the searches on
  448.         the directory are case sensitive.
  449.  
  450.     -a    Use to add a new entry/entries to the phone list file.  Will
  451.         exit the program after the entries have been added.  The 
  452.         phone list file must exist before the program is run.
  453.  
  454.     -s    Will turn the sound on if the configuration file sets it off
  455.         by default.
  456.  
  457.     -m    Used to force the system into monochrome mode.
  458.  
  459.     -g    Used to force the system into color mode.
  460.  
  461.         The program tries to check the configuration of the hardware
  462.         that it is being run on.  However, it does sometimes get lost
  463.         on strange setups.  For example, on some two monitor systems
  464.         where the default display is the color monitor, it will not
  465.         run properly on the monochrome monitor.  Using the -m switch
  466.         when trying to run on the monochrome monitor will usually fix
  467.         this problem.  If you find any other situations under which
  468.         the program will not run, please let us know and we will try
  469.         to resolve the problem.
  470.  
  471.  
  472.  
  473.  
  474.  
  475. USING DIAL
  476. ──────────
  477.  
  478. ───────────────────────────────────────────────────────────────────────────────
  479. Whenever you're using DIAL, the one most important thing to remember is the
  480. <F5> key.  Pressing <F5> at any time in the program will provide help on the
  481. particular function you're using.
  482. ───────────────────────────────────────────────────────────────────────────────
  483.  
  484.  
  485. DIAL is invoked from the DOS command line by typing
  486.  
  487.                           dial Name
  488.  
  489. The search for 'Name' is by default case sensitive but can be changed (See 
  490. CONFIGURATION).  If the search string is listed in the directory with the
  491. first letter capitalized, the name typed on the command line must have the
  492. first letter capitalized.  Since the program simply looks for the pattern in
  493. each line of the file, any part of the name, or really any string can be
  494. entered.  For example, if you wish to know (for whatever reasons) all the
  495. numbers in the 212 area code, just type 'dial 212'.
  496.  
  497. Command line switches can be specified before or after the name.  Switches
  498. on the command line take precedence over environment variables and
  499. environment variables take precedence of the data in the configuration file.
  500. That is, if the area code specified in the configuration file is '304' and
  501. the area code specified in the environment variable 'D_DAC' is '212', '212'
  502. will be used and not '304'.
  503.  
  504. When DIAL is started, the following sequence of events take place.  The
  505. program first looks for the environment variable 'DIAL' to determine the
  506. location of the data files.  If the 'DIAL' variable is not found, it is
  507. assumed that all necessary files are in the current directory.  The user
  508. is alerted to this condition on the status line.
  509.  
  510. The configuration file is then read.  If a configuration file is not found,
  511. the user is alerted that a default configuration file will be created.
  512.  
  513. The directory file is then searched for the string specified.  If no match
  514. is found, a message is printed and the program exits.  If the search returned
  515. less than a full page of matches, the telephone numbers are displayed.  Move
  516. the cursor (red on white on color monitors, reverse video on monochrome
  517. monitors) with the up and down arrow or the mouse to the number you wish to
  518. dial and press <ENTER> or <F1> on the keyboard or the left mouse button to
  519. dial the selected number.  You can move to the first number on the page by 
  520. pressing <CTRL><HOME> or to the last number on the page by pressing
  521. <CTRL><END>. 
  522.  
  523.  
  524. ╔═════════════════════════════════ [ Museum ] ═══════════════════════════════╗
  525. ║  Computer Museum        300 Congress St., Boston       >>> 423-6758        ║
  526. ║  Museum of Fine Arts    465 Huntington Ave., Boston    >>> 267-9300        ║
  527. ║  Museum of Science      Boston                         >>> 723-2500        ║
  528. ║  Omni Theatre Info.     Boston Museum of Science       >>> 523-6664        ║
  529. ║                                                                            ║
  530. ║                                                                            ║
  531. ║                                                                            ║
  532. ║                                                                            ║
  533. ║                                                                            ║
  534. ║                                                                            ║
  535. ║                                                                            ║
  536. ║                                                                            ║
  537. ║                                                                            ║
  538. ║                                                                            ║
  539. ║                                                                            ║
  540. ║                                                                            ║
  541. ║                                                                            ║
  542. ║                                                                            ║
  543. ║                                                                            ║
  544. ║                                                                            ║
  545. ║                                                                            ║
  546. ║                                                                            ║
  547. ╚════════════════════════════════════════════════════════════════════════════╝
  548. ░ SN: 0001 ░░░░░░░░░░░░░░░░░░ Press <F5> for Help ░░░░░░░░░░░░░░░░░░  ░ LOG ░
  549.  
  550.  
  551. If the search returns more than one page of matches, the first page is
  552. displayed.  The pages can be scrolled through by pressing <PgUp> or <PgDn>
  553. on the keyboard or by pressing the left mouse button on the up and down
  554. arrows on the mouse menu.  The first page can be displayed by pressing the
  555. <HOME> key. and the last page by pressing the <END> key.  Within a page, the
  556. same keystrokes are used as in the preceding paragraph.
  557.  
  558.  
  559.  
  560.  
  561.  
  562. ADD NEW ENTRY
  563. ─────────────
  564.  
  565. Pressing <ALT><N> (or selecting the NAME option on the mouse menu) allows you
  566. to add a new entry to the telephone directory.  The following window will be
  567. displayed:
  568.  
  569.  
  570.           ╒══════════════════[ Add New Entry ]═══════════════════╕
  571.           │                                                      │
  572.           │     Name: .......................                    │
  573.           │                                                      │
  574.           │     Address: .....................................   │
  575.           │                                                      │
  576.           │     Phone: .................                         │
  577.           │                                                      │
  578.           ╘══════════════════════════════════════════════════════╛
  579.  
  580.  
  581. Enter the information for the new entry in the appropriate fields.  (See
  582. Appendix B for a list of editing keys).  If a '#' is entered as the first
  583. character in the name field, the entry is considered to be a comment.  If
  584. the entry satisfies a search criteria, it will be displayed (highlighted on
  585. monochrome monitors, yellow on color monitors) but the cursor will skip over
  586. the line when moved.  Comments can be used for storing additional information
  587. that do not contain a telephone number.
  588.  
  589. When adding comment records, the fields in a comment are concatenated with a
  590. space between fields.
  591.  
  592. The phone number should be entered EXACTLY as you would like it to be dialed
  593. (keeping in mind the PREFIX and LOCAL AREA CODE fields in the configuration
  594. file).
  595.  
  596.  
  597. After entering the information, the disposition menu is displayed:
  598.  
  599.  
  600.    ╒══════════════════[ Add New Entry ]═══════════════════╕
  601.    │                                                      │
  602.    │     Name: .......................     ╔═════[ Disposition Menu ]═════╗
  603.    │                                       ║                              ║
  604.    │     Address: .........................║     Save and Continue        ║
  605.    │                                       ║                              ║
  606.    │     Phone: .................          ║     Save and Exit            ║
  607.    │                                       ║                              ║
  608.    ╘═══════════════════════════════════════║     Clear Last / Continue    ║
  609.                                            ║                              ║
  610.                                            ║     Clear Last and Exit      ║
  611.                                            ║                              ║
  612.                                            ║     Clear All and Quit       ║
  613.                                            ║                              ║
  614.                                            ╚══════════════════════════════╝
  615.  
  616.  
  617.     Save and Continue    Selecting this option will save the current
  618.                 the entry in a entry buffer, clear the entry
  619.                 window fields and return the cursor to the
  620.                 entry window to allow you to enter any
  621.                 additional names.
  622.  
  623.     Save and Exit        This option will store all buffered entries
  624.                 (including the current) in the directory file
  625.                 and return to the main program window.
  626.  
  627.     Clear Last / Continue    Same as the first option except the current
  628.                 data is discarded (not saved in the buffer).
  629.  
  630.     Clear Last and Exit    Discards the current entry and returns to the
  631.                 main program window.
  632.  
  633.     Clear All and Quit    Discards ALL buffered entries (including the
  634.                 current entry) and returns to the main
  635.                 program window.
  636.  
  637.  
  638.  
  639.  
  640.  
  641. EDIT NEW ENTRY
  642. ──────────────
  643.  
  644. Pressing <ALT><E> allows you to edit the entry that is currently selected.
  645. The following window will be displayed:
  646.  
  647.  
  648.           ╒═══════════════════[ Edit Entry ]═════════════════════╕
  649.           │                                                      │
  650.           │     Name: Museum of Science                          │
  651.           │                                                      │
  652.           │     Address: Boston, MA                              │
  653.           │                                                      │
  654.           │     Phone: 617-555-1234                              │
  655.           │                                                      │
  656.           ╘══════════════════════════════════════════════════════╛
  657.  
  658.  
  659. The selected entry is displayed for editing.  See Appendix B for a list of
  660. editing keys.  When editing comment lines, words may be broken in the middle
  661. since the program simply fills the fields in the window in sequence.  Keep
  662. in mind when editing that the fields in a comment are concatenated with a 
  663. space between fields.
  664.  
  665. No disposition menu is displayed after editing a field.  Pressing <F10> when
  666. in any field will abort the entry without updating the record.  Pressing
  667. <ENTER> at the last field will automatically update the record.
  668.  
  669.  
  670.  
  671.  
  672.  
  673. AREA CODE SEARCH
  674. ────────────────
  675.  
  676. Pressing <ALT><A> (or selecting Ar Code from the mouse menu) will invoke the
  677. area code search function.  The following menu will be displayed:
  678.  
  679.  
  680.                         ╒═[ Area Code Search ]═╕
  681.                         │                      │
  682.                         │      Area Code       │
  683.                         │                      │
  684.                         │      State Code      │
  685.                         │                      │
  686.                         │      City            │
  687.                         │                      │
  688.                         │      Country         │
  689.                         │                      │
  690.                         │      Quit            │
  691.                         │                      │
  692.                         ╘══════════════════════╛
  693.  
  694.  
  695.     Area Code    Selecting this function will will allow you to select
  696.             an area code.  The city/state that uses this area code
  697.             will be displayed.
  698.  
  699.     State Code    Allows you to enter a two character state code.  All
  700.             area codes used in the state will be displayed.
  701.  
  702.     City        Allows you to enter the name of a city.  The
  703.             appropriate area code for that city, and the name
  704.             of the state/country it is in is the displayed.
  705.             Of course, not every city in the world is included,
  706.             but we try...
  707.  
  708.     Country        Allows you to enter the name of a country.  The
  709.             country code for that country is displayed along
  710.             with a time differential from Eastern Standard Time.
  711.             Most time differentials are added to the current EST
  712.             to determine the current time in that country.
  713.             Some countries (such as CANADA) will have a '***'
  714.             displayed meaning that country includes multiple time
  715.             zones.
  716.  
  717.     Quit        Returns to the main directory display window.
  718.  
  719.  
  720.  
  721. For all alphabetic entries, the first few letters of the name can be entered.
  722. All names that begin with the string of characters entered will be displayed.
  723. If too many matches are found (more than 19 matches), a longer string can be
  724. entered to return fewer matches.  For example if 'Ne' is entered and the
  725. number of matches cannot fit in the window, entering 'New' will return a
  726. smaller number of matches that can be displayed.
  727.  
  728. The name searches are case sensitive.  When entering a name for a search, the
  729. first letter in automatically set to upper-case.
  730.  
  731.  
  732.  
  733.  
  734.  
  735. Sample Area Code Screens
  736. ────────────────────────
  737.  
  738. ╔════════════════════════════════ [ Museum ] ════════════════════════════════╗
  739. ║ Computer Museum        300 Congress St., Boston       >>> 423-6758         ║
  740. ║ Museum of Fine Arts    465 Huntington Ave., Boston    >>> 267-9300         ║
  741. ║ Museum of Science      Boston                         >>> 723-2500         ║
  742. ║ Om╓──────────────────────────────╖um of Science       >>> 523-6664         ║
  743. ║   ║ City: New                    ║                                         ║
  744. ║   ╙─────────────────────╓────────────────────────────────────────────────╖ ║
  745. ║                         ║       City               State       Area Code ║ ║
  746. ║                         ╟────────────────────────────────────────────────╢ ║
  747. ║                         ║ New Amsterdam            Guyana         03     ║ ║
  748. ║                         ║ New Delhi                India          11     ║ ║
  749. ║                         ║ New Haven                Connecticut    203    ║ ║
  750. ║                         ║ New Hope                 Guyana         66     ║ ║
  751. ║                         ║ New London               Connecticut    203    ║ ║
  752. ║                         ║ New Plymouth             New Zealand    67     ║ ║
  753. ║                         ║ New York                 New York       212    ║ ║
  754. ║                         ║ Newcastle                NSW, Australia 49     ║ ║
  755. ║                         ╙────────────────────────────────────────────────╜ ║
  756. ║                                                                            ║
  757. ║                                                                            ║
  758. ║                                                                            ║
  759. ║                                                                            ║
  760. ║                                                                            ║
  761. ╚════════════════════════════════════════════════════════════════════════════╝
  762.  
  763.                        Display when a City is selected.
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773. ╔════════════════════════════════ [ Museum ] ════════════════════════════════╗
  774. ║ Computer Museum        300 Congress St., Boston       >>> 423-6758         ║
  775. ║ Museum of Fine Arts    465 Huntington Ave., Boston    >>> 267-9300         ║
  776. ║ Museum of Science      Boston                         >>> 723-2500         ║
  777. ║ Om╓───────────────────────╖on Museum of Science       >>> 523-6664         ║
  778. ║   ║ Country: New          ║                                                ║
  779. ║   ╙───────────────────────╜                                                ║
  780. ║                                                                            ║
  781. ║                                                                            ║
  782. ║                        ╓─────────────────────────────────────────────────╖ ║
  783. ║                        ║         Country                    A.Code  Time ║ ║
  784. ║                        ╟─────────────────────────────────────────────────╢ ║
  785. ║                        ║ New Caledonia                       687    16   ║ ║
  786. ║                        ║ New Zealand                         64     17   ║ ║
  787. ║                        ╙─────────────────────────────────────────────────╜ ║
  788. ║                                                                            ║
  789. ║                                                                            ║
  790. ║                                                                            ║
  791. ║                                                                            ║
  792. ║                                                                            ║
  793. ║                                                                            ║
  794. ║                                                                            ║
  795. ║                                                                            ║
  796. ╚════════════════════════════════════════════════════════════════════════════╝
  797.  
  798.                        Display when a Country is selected.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805. SOUND
  806. ─────
  807.  
  808. The program can be configured to make irritating noises at inappropriate
  809. times.  This feature can be enable/disabled by pressing <ALT><S>.
  810.  
  811.  
  812.  
  813.  
  814.  
  815. LOG FILE
  816. ────────
  817.  
  818. When the call logging feature is enabled, information about all calls are
  819. stored in a log file (as defined in the configuration utility).  Below is
  820. a sample log file.
  821.  
  822.  
  823.   Dialed:  Khan, Wally               December 17, 1989  9:41 AM
  824.   Dialed:  Andrew Square Pizza       January 5, 1989  2:32 AM
  825.   Dialed:  47th St. Computer         January 10, 1990  11:15 AM
  826. Redialed:  47th St. Computer         January 10, 1990  11:16 AM
  827. Redialed:  47th St. Computer         January 10, 1990  11:17 AM
  828.   Dialed:  Barcode Industries        January 10, 1990  3:46 PM
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835. MOUSE SUPPORT
  836. ─────────────
  837.  
  838. Basically, the left button of the mouse works the same was as the <ENTER>
  839. key on the keyboard and the right button works the same way as the <ESCAPE>
  840. key.
  841.  
  842. When a page of matches are displayed, the cursor can be moved up and down
  843. with the mouse.  Pressing the left button dials the selected number. Pressing
  844. the right button (or pressing the <ESCAPE> key) will display the mouse menu
  845. bar at the bottom of the screen over the status line.  The menu looks like:
  846.  
  847.  
  848. ───────────────────────────────────────────────────────────────────────────────
  849.  Dial    Config   Ar Code   Name    Sound   Log    Reg.   Help          Quit
  850. ───────────────────────────────────────────────────────────────────────────────
  851.  
  852.  
  853. One character of each function name on the menu is highlighted and the
  854. function can also be invoked by pressing that key.  The menu cursor can be
  855. moved to each function with the mouse or with the left and right arrow keys.
  856. Pressing the left button will execute the currently selected function.
  857. Pressing the right button (or <ESCAPE>) will return the cursor to the number
  858. selection window.
  859.  
  860.  
  861.     Dial        Allows you to enter a new search string.
  862.  
  863.     Config        Execute the configuration function.
  864.  
  865.     Area Code    Execute the area code search function.
  866.  
  867.     Name        Execute the function to add a new entry to the
  868.             directory.
  869.  
  870.     Sound        Toggle sound.
  871.  
  872.     Log        Toggle call logging.
  873.  
  874.     Reg.        Display the registration screen.
  875.  
  876.     Help        Display the general help window.
  877.  
  878.             Move to the previous page of matches.
  879.  
  880.             Move to the next page of matches.
  881.  
  882.     Quit        Exit the program.
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.                                Appendix A
  891.                                ----------
  892.  
  893.  
  894. SELECTION KEYS
  895. ──────────────
  896.  
  897. The following keystrokes can be used when the numbers are displayed:
  898.  
  899.     <ESC>        Escape.  Invoke the menu bar at the bottom of the
  900.             screen.  Pressing the highlighted letter of the menu
  901.             item (usually the first character) executes that
  902.             particular function.  For a description of the menu
  903.             bar, see the section on mouse support.
  904.  
  905.     <ENTER>        Enter of function key F1.  Dial the number currently
  906.     or <F1>        highlighted by the cursor.
  907.  
  908.     <>         Up arrow.  Move the cursor up one line to the previous
  909.             number.
  910.  
  911.     <>        Down arrow.  Move the cursor down one line to the next
  912.             number.
  913.  
  914.     <HOME>        Home.  Move the cursor to the last page if more than
  915.             one page of entries were found.
  916.  
  917.     <CTRL><HOME>    Top of page.  Move the cursor to the top of the
  918.             current page.
  919.  
  920.     <END>        End.  Move the cursor to the last page if more than
  921.             one page of entries were found.
  922.  
  923.     <CTRL><END>    Bottom.  Move the cursor to the bottom of the current
  924.             page.
  925.  
  926.     <F5>        Help.  Display the help window.  Generally, pressing
  927.             <F5> at any time in the program will display a help
  928.             message on the currently selected function.
  929.  
  930.     <PgUp>        Page up. Move to the previous page of entries.
  931.  
  932.     <PgDn>        Page down.  Move to the next page of entries.
  933.  
  934.     <ALT><S>    Toggles sound.
  935.  
  936.     <ALT><R>    Displays a screen containing a registration form which
  937.             can the be printed.
  938.  
  939.     <ALT><A>    Invoke the area code search function.
  940.  
  941.     <ALT><L>    Toggles the call logging function.
  942.  
  943.     <DELETE>    Delete the current entry.
  944.  
  945.     <ALT><D>    Allows the entry of a new search string.
  946.  
  947.     <ALT><N>    Add a new entry to the directory.
  948.  
  949.     <ALT><E>    Edit an existing entry.
  950.  
  951.     <ALT><C>    Run the configuration function.
  952.  
  953.     <ALT><X>    Exit the program.
  954.     or <F10>
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.                                Appendix B
  962.                                ----------
  963.  
  964. EDIT KEYS
  965. ─────────
  966.  
  967. When entering text in the configuration or new name entry windows, the
  968. following keys can be used:
  969.  
  970.  
  971.     ESC           Clear line and home cursor.
  972.  
  973.     Left Arrow    Move cursor one character to left.
  974.  
  975.      Right Arrow   Move cursor one character to right.
  976.  
  977.     Cntl-Left     Move cursor to start of word on left.
  978.  
  979.      Cntl-Right    Move cursor to start of word on right.
  980.  
  981.     HOME          Move cursor to start of line.
  982.  
  983.      END           Move cursor to end of line.
  984.  
  985.      INSERT        Toggle insert / overwrite mode.
  986.  
  987.      DELETE        Delete current character under cursor.
  988.  
  989.  
  990.  
  991.                       DIAL Telephone Dialer Version 1.0
  992.                       _________________________________
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999. To: Hasmatallie A. Khan                    From: _____________________________
  1000.     15 Southpoint Dr., # 307
  1001.     Dorchester, MA 02125                         _____________________________
  1002.  
  1003.                                                  _____________________________
  1004.                                                  
  1005.                                                  _____________________________
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.     ___ Copies of DIAL @ $50.00 each ............................ ____________
  1014.  
  1015.     (Includes full support, program disk, updates)
  1016.     
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.                                                      Total of ... ____________
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.           Enclose check or money order payable to Hasmatallie A. Khan
  1041.  
  1042.