home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / misc / dial.lzh / Dial.doc < prev    next >
Text File  |  1991-10-02  |  7KB  |  181 lines
  1.  
  2.                          S H A R E W A R E
  3.  
  4.  
  5. This program is a shareware product.  You may use it for some time to
  6. see if it meets your needs and whether you want to start using it
  7. regularly or not.  If you don't like this program, just throw it away
  8. and forget about it.  But if you do like it and want to see it getting
  9. even better, please send a donation of ten U.S. dollars (U.S.D. 10) to
  10. the address listed in the end of this file.  Later, you will be sent
  11. the latest version of this program and possibly some other interesting
  12. shareware/public domain programs.
  13.  
  14. If you don't want to pay, please think twice.  It takes lots of time to
  15. develop versatile and reliable programs - programs that you want to use.
  16. The people who write such programs often like programming but that does
  17. not mean that they didn't have to eat anything.  The shareware fees are
  18. usually very tolerable and much less than what you would have to pay
  19. for the same programs if they were 'real' commercial products.  And
  20. besides, with your little donation you encourage the programmers to
  21. create even better shareware products - from which we all will benefit.
  22.  
  23. Thanks for your time.  Now let us get to the real stuff...
  24.  
  25. -----------------------------------------------------------------------
  26.  
  27.                            Dial v0.27
  28.  
  29.  
  30.          Dial -- a smart but simple phone dialer program
  31.                   by Supervisor Software ⌐ 1991
  32.  
  33.  
  34.  
  35. Dial uses a Hayes(TM) compatible modem to dial a phone number given on
  36. the command line or in a phone catalog file.  It also understands the
  37. phone numbers given in ASCII form (like 415 32-AMIGA for Radical Eye
  38. Software).
  39.  
  40.  
  41. Command line syntax (lower case letters are optional)
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43. dial [options] #number|name
  44.  
  45. where options is any combination of
  46.  
  47.      [-CATalog=<filename>] [-INTernational=<string>]
  48.      [-COUntry=<string>] [-AREa=<string>] [-PArea=<string>]
  49.      [-DEVice=<name>] [-Unit=n] [-Baud=n] [-Quiet] [-Show]
  50.  
  51. Phone number or person's name must be the last item on the command line
  52. (all options must be specified before the number).  If a # character is
  53. placed before the string the number is considered to be an actual phone
  54. number.  If no # is found, the string will be searched in the phone
  55. catalog file and the corresponding number will be dialed.
  56.  
  57. Options:
  58.  
  59. -Show only shows the requested phone number without dialing it using
  60.  the modem.
  61.  
  62. -CATalog sets the phone catalog file name (default is s:phone_catalog).
  63.  
  64. -INTernational sets the international prefix code for dialing.  This
  65.  code is needed when calling numbers abroad.  When this code is given,
  66.  Dial inserts it before any phone number beginning with '+'.
  67.  
  68. -COUntry sets the local country code.  Dial uses this to determine
  69.  whether the international prefix code and country code have to be
  70.  dialed (whether the number being called is in the current country).
  71.  
  72. -AREa sets the local area code.  Dial uses this to determine whether
  73.  the are code has to be dialed before the actual phone number (whether
  74.  the number being called is located in the current area).  Area code
  75.  must NOT contain the area prefix code used in some countries (like
  76.  Finland).  See -PArea below.
  77.  
  78. -PArea sets the area prefix code.  This code must be left out of the
  79.  area code in some countries when calling from abroad.
  80.  
  81. -DEVice sets the modem device name (default is serial.device).
  82.  
  83. -Unit sets the unit number for modem device (default is 0).
  84.  
  85. -Baud sets the baud rate for modem device (default is 2400 bps).
  86.  
  87. -Quiet suppresses the dialing message.
  88.  
  89. number is the number to be dialed.  If number is preceded with '#'
  90.  the number will be used as the actual phone number.  Otherwise, number
  91.  will be interpreted as a name and the actual phone number will be gotten
  92.  from the phone catalog.
  93.  
  94.  
  95. Environment variable
  96. ~~~~~~~~~~~~~~~~~~~~
  97. Dial uses an environment variable PhoneDialer to store its default
  98. parameters.  This way the local environment (prefix and area codes and
  99. device parameters) can be set at boot time.  Command line parameters
  100. override those specified in the environment variable.
  101.  
  102. Format of the environment variable is the same as that of command line.
  103.  
  104.  
  105. Phone catalog
  106. ~~~~~~~~~~~~~
  107. If a person's name was given instead of a phone number (no # sign was
  108. found in front of the string), that name will be searched in a phone
  109. catalog file.  Default file name for phone catalog is s:phone_catalog
  110. but any name can be given with the option -CATalog.
  111.  
  112. The phone catalog must have a certain format.  Each phone number must
  113. have its own line, terminated by LF character.  Each line starts with
  114. the person's name, which is followed by two or more white spaces (this
  115. is important!!).  Everything after the white spaces (TABs or SPACEs) is
  116. considered to belong to the phone number.  An example line might look
  117. as follows:
  118.  
  119. Supervisor Software            +358 (71) 232 793
  120.  
  121. First there is a name (Supervisor Software in this case) followed by
  122. the white spaces.  Then there is a + sign meaning that the international
  123. prefix must be added here to call this number from abroad.  Immediately
  124. following the + sign is the country code and then the area code in
  125. parentheses.  Last but not least is the actual phone number.
  126.  
  127. The country and area codes are not necessary but they make tho phone
  128. catalog fully portable.  Dial is smart enough to strip off the country
  129. code when calling within the same country and the are code if a short
  130. distance call is made.  So, if the call was made from Kuopio (the town
  131. where Supervisor Software is located), only the "232 793" part of the
  132. phone number would be used.
  133.  
  134. For the intelligent number parsing to work you must set the local
  135. country and area codes using -COUntry and -AREa options.  If a area
  136. prefix code is used in your country you must set it with -PArea option.
  137. For convenient use, these parameters can be set in the PhoneDialer
  138. environment variable.
  139.  
  140. Use the -Show option to see the phone numbers without dialing them.
  141. Experiment with different phone numbers and local data and you will
  142. get familiar with the system.  Of course, if there's no need for the
  143. intelligence, you are free to specify the plain phone numbers with
  144. no local data and Dial will act like a stupid dialer for you.
  145.  
  146.  
  147. Phone numbers and names
  148. ~~~~~~~~~~~~~~~~~~~~~~~
  149. Phone numbers can be specified directly on the command line in which
  150. case they must begin with # sign.  If no # was found, Dial will look
  151. for the given name in the phone catalog.  Note that the name does NOT
  152. have to be enclosed in quotes ("") even if it contains commas or white
  153. space characters (as everything after the options is considered to be
  154. part of the phone number).
  155.  
  156. The standard characted substitutes for numbers are recognized.  So,
  157. #Amiga gives the number 26442 and #ILikeThis gives 454538447.  Numbers
  158. and alphabets can be freely mixed.
  159.  
  160. The standard ARP/AmigaDOS 2.0 wildcards can be used to search phone
  161. numbers from the catalog file.  With the -Show option you can view
  162. the persons in phone catalog, e.g. Dial "Mike*" -show will list all
  163. persons named Mike.
  164.  
  165.  
  166. Shareware fees, bug reports, enhancement requests
  167. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  168. Shareware fees and any comments may be sent to
  169.  
  170.   Supervisor Software
  171.   Jukka Marin
  172.   Metsurintie 17 B 8
  173.   70150 Kuopio
  174.   FINLAND
  175.  
  176. Comments and questions can also be e-mailed to
  177.  
  178.   jmarin@uku.fi
  179.  
  180.  
  181.