home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / p / pd7.zip / PD.TXT < prev    next >
Text File  |  1992-01-21  |  16KB  |  437 lines
  1.         -------------------------------------------
  2.                Advanced Phone Dialer Version 7
  3.                 (C)1987-92 Turgut Kalfaoglu
  4.         -------------------------------------------
  5.  
  6.  
  7. ShareWare Version
  8. -----------------
  9.  
  10. This program is licensed to the user for a period of TWO WEEKS and must
  11. be registered if the user intends to keep this package. The registration
  12. entitles the user to receive the advanced version which includes such
  13. options as password protection and data encryption. Complete the form
  14. provided at the end of the document to receive the registered version.
  15.  
  16. Please distribute  this program  in unmodified  state. It is
  17. user-supported as of September 1986.
  18.  
  19.  
  20. Abstract
  21. --------
  22.  
  23. Phone Dialer  is designed  to provide the most comfort while dialing
  24. your  voice calls. It not only eliminates the search for a  number, it
  25. also keeps your phone book and comes with full set of editing features.
  26. To dial someone's phone number, all you need to do is to type a few
  27. letters within his/her name (not necessarily the first few letters) to
  28. make the computer dial.
  29.  
  30.  
  31. Disclaimer:
  32. -----------
  33.  
  34.         This program is distributed as-is. I do not guarantee its
  35. usefulness, or correctness. Although I have tried to check it as much as
  36. possible before distributing it, it may still contain bugs. If you
  37. encounter any, I would like to learn about them, so that they can be
  38. eliminated on the next releases.
  39.  
  40.  
  41. If you have the data file from an older version:
  42. ------------------------------------------------
  43.  
  44.         You must run the supplied program called "6To7". The Phone
  45. Dialer no longer contains the code for automatic conversion. Note that
  46. you only need to run this conversion program once.
  47.  
  48.  
  49. New to This Version:
  50. --------------------
  51.  
  52.  
  53. * Full Pull-Down menus with mouse support
  54.  
  55. * EDIT option
  56.  
  57. * Various corrections and code restructuring
  58.  
  59.  
  60. Invoking (starting) the phone dialer:
  61. -------------------------------------
  62.  
  63. PD [?] [S] [M] [/] [C0] [C2] [L2] [L3]
  64.  
  65.      The above  line  describes all  possible invoking functions
  66. provided  by the  phone dialer.  The brackets just show  that   the item
  67. is  optional. You may enter the command line either with  or without
  68. brackets.
  69.  
  70. Usage Example:
  71.  
  72. PD M/  -- Disables modem access and uses the monochrome color setting.
  73.  
  74.  
  75. Option:   Means:
  76. -------   ------
  77.  
  78.   ?       Display the option list. (This list)
  79.   S       Sound Off option.
  80.   M       Use Black and White instead of Black and Yellow.
  81.   /       Disable modem access.
  82.   C0      Same as above.
  83.   C2      Use COM2: (second asynch serial port) instead of
  84.           the default COM1: for modem access.
  85.   L2      The printer is connected to LPT2, instead of LPT1:
  86.   L3      The printer is at LPT3:, not LPT1:
  87.  
  88.  
  89. PD.SET file
  90. -----------
  91.  
  92.      After you start the phone dialer a couple of times with hard to
  93. remember options, you realize the need to automate this process.
  94. Fortunately, there is a way.
  95.  
  96.      If you ever enter PD with an option, or any combination of options,
  97. the program remembers them, and as you exit, it writes them  down to  a
  98. file  called 'PD.SET' on the same directory as your phone data file
  99. (PHONE.DAT), and your address data file (ADDRESS.DAT). This file can be
  100. edited manually if desired, and it contains explanatory lines.
  101.  
  102.      The  program  will automatically load this file and its parameters
  103. if you start the Phone Dialer without any options.
  104.  
  105. "Printer  Interrupt rate."  in this file indicates how  often  the
  106. printer should be 'fed'  while the printing is in progress. The default
  107. value that you see there can be changed easily using any  text editor.
  108. The range is from 1 (a line is sent once in  a great  while), to  10
  109. (lines  are sent without a delay in  between.) You  will have  to
  110. experiment  with this number, since  every printer has a different
  111. printing speed. The idea is that  the printer  should sit idle very
  112. briefly between lines. However, if  you raise this number too high, you
  113. will  lose the  ability to  perform any  tasks with  the phone dialer
  114. while it  is printing your directory, since it will be too busy with the
  115. printer.
  116.  
  117.  
  118. How to change back an option to default:
  119. ----------------------------------------
  120.  
  121.      Consider the  case where  you decide  that you now want the Phone
  122. Dialer to  use COM1:  after you  have been  using COM2: to dial your
  123. phone numbers. Or the case where you want the Phone Dialer to use the
  124. sound effects. Here is how:
  125.  
  126. 1) Delete the PD.SET file.
  127. 2) Start  the Phone  Dialer using any options that you wish. Upon exit,
  128.   it will  create a  new PD.SET which will contain the necessary
  129.   information.
  130.  
  131.  
  132.  
  133. HOT key
  134. -------
  135.  
  136.         <ESC> key is used to interrupt a function. This function can be
  137. anything from LIST to LOG. To interrupt background printing, you must
  138. hit F7, not <ESC>.
  139.  
  140.  
  141. Functions
  142. ---------
  143.  
  144. LIST --- Displays all the names, numbers, and addresses in your data
  145.    file.
  146.  
  147. SHOW --- Will ask you for something to search for. Either enter a
  148.    partial name, or a partial number. It will display the entries which
  149.    contain the entered number. Note that no searches are conducted on
  150.    the ADDRESS field.
  151.  
  152. ADD --- Adds new names, phone numbers and addresses to your phone list.
  153.  
  154. EDIT -- Edits or changes an already entered entry. Specify a part of the
  155.    name to select among your phonebook.
  156.  
  157. KILL --- Will ask for something to search for. If you give it a whole
  158.    name, and if that name exists in the data file, it will be deleted
  159.    without confirmation. However, if you give it a partial name, it will
  160.    ask for confirmation before deleting.
  161.  
  162. SORT --- Re-ordering can be conducted on name and phone number in either
  163.    ascending (a->z) or descending order.
  164.  
  165. PRINT --- Will send your whole phone list to the printer. If the phone
  166.    dialer slows down considerably during this operation, edit PD.SET and
  167.    reduce the 'Printer Interrupt Rate'.
  168.  
  169. LOG --- Phone dialer will keep a log of all calls, unless this feature
  170.    is disabled. This command allows manipulations with the caller's log.
  171.  
  172. REDIAL --- It will re-submit your last 'dial' command.
  173.  
  174. QUIT --- Saves changes to the data files. Never exit phone dialer
  175.    without this option. You may end up with discrepencies in your data
  176.    files if you do.
  177.  
  178.  
  179.  
  180.  
  181. Error Recovery
  182. --------------
  183.  
  184.      Ever since  I started  using the  phone dialer,  I made sure that
  185. it was  SAFE. That  no one would lose information using this program.
  186. You might have noticed that it goes into an elaborate  task of  making
  187. backups, etc, when it is about to write out a modified phone list.
  188.  
  189.      Well, with this version, when an error occurs it will display you a
  190. prompt that is familiar to those who struggle with DOS a lot. (<I>gnore
  191. <A>bort <R>etry ) Of course, it's friendlier than the DOS' prompt.
  192.  
  193.  
  194. Printer Errors
  195. --------------
  196.  
  197. If,  while printing,  your paper jams, or for any reason the printing
  198. stops, the Phone Dialer will  appear   to  be  'frozen.'  It will  not
  199. answer  any keystrokes. However, this situation is temporary. If  you
  200. wait  about  thirty  seconds,  the Phone Dialer will realize that  the
  201. printer is off-line, and will offer you  the choice of canceling  the
  202. printing.  At  this point you should hit <A> for abort.
  203.  
  204.  
  205. Shell Command
  206. -------------
  207.  
  208.      A new  command has been added. The SHELL command allows you to drop
  209. to DOS and perform any DOS functions, and return back to  the phone
  210. dialer as  if you had never left it. For SHELL to work, you must have
  211. enough available memory to hold a second  copy of  the command
  212. interpreter of  DOS. Another requirement is  that the  COMMAND.COM must
  213. either be in the current directory, or it must be in the search PATH...
  214.  
  215.      A word  of caution:  Make sure that you are back on the same drive
  216. and directory  before you  get back to the Phone Dialer with the EXIT
  217. command.
  218.  
  219.  
  220. Quick-Choose Utility
  221. ------------------
  222.  
  223.      When the program does not find an exact match  for the name to be
  224. dialed, it collects all the  occurrences of  semi-matches. If the total
  225. of these semi-matches are  less than  10, then  the collected list is
  226. displayed. You can then choose the right one by just hitting a digit.
  227.  
  228.  
  229. ADDRESS.DAT file
  230. ----------------
  231.  
  232.         This is where the address information is kept. This file should
  233. not be edited using a regular text editor. Modifications should be done
  234. through the phone dialer, or with a Sector Editor, if you feel
  235. confortable using a such tool.
  236.  
  237.  
  238. Development History
  239. -------------------
  240.  
  241.      The 'history'  of this program began when I read my new modem's
  242. manual  a couple of years ago. It showed me a way to dial numbers, and
  243. still have the control of the modem. So, I wrote a  crude, but
  244. functioning program  based on  the idea that it  should be  easy  and
  245. fast  to  use.  (I  get  very impatient with  welcoming logos,  and
  246. other things that slow me down.)
  247.  
  248.      Anyway, the  first  version  was  written  in  BASICA..
  249. Interpreted. Then,  I decided  to  invest  in  a  QuickBASIC compiler,
  250. and re-compiled the program.
  251.  
  252.      The major  'push' for  this program came when it was to be
  253. handed-in as a programming assignment. It suddenly became very
  254. structured,  and very  well documented.
  255.  
  256.      The program  improved,  and  after  joining  MCI,  (and talking to
  257. the users  of this  program) I  felt the need to include phone  prefixes
  258. so that someone can just include the sign '#'  on top  of a  phone
  259. number  instead  of  including '10288' at  the beginning of every number
  260. that is to use the AT&T line.
  261.  
  262.      Also, other  comments came about port assignments. Lots of people
  263. use COM2:  for their  modem, and  LPT2 and  3 for their printer. So, I
  264. made those optional parameters too.
  265.      
  266.      On the  summer of 1987, after doing major repairwork, I included
  267. pop-up  windows, and  all  these  enhancements  for version 5. 1988 is
  268. the year that I added the Address book keeper. In 1991, pull-down menus
  269. were added, along with SAVE and EDIT options.
  270.  
  271.  
  272. Shareware Package, Registration
  273. -----------------
  274.  
  275.      This package contains a code that is a subset of the
  276. commercial-quality package that is available for $30. You MUST register
  277. if you use this software longer than two weeks. To register, fill out
  278. the following form, and mail it in with a check for US $30 (or
  279. equivalent in your local currancy), made out to "Turgut Kalfaoglu". You
  280. will receive both source code, and the runtime version of the latest
  281. version, along with a subscription to the shareware products
  282. announcements.
  283.  
  284.  
  285.  
  286. Programmer:
  287. -----------
  288.  
  289.      I can be reached at:
  290.  
  291.           Turgut Kalfaoglu
  292.           1378 Sok. 8/10
  293.           Izmir 35210
  294.           Turkey
  295.  
  296.  
  297. If you have access to a computer network, that can access
  298. Bitnet, you may also reach me from this ID: TURGUT@TREARN.BITNET
  299.           
  300.  
  301.  
  302. Limitations:
  303. ------------
  304.  
  305. Built in limitations:
  306.     2000 names and 2000 addresses.
  307.  
  308. The program has an 'estimate' feature which measures the amount of free
  309. space left, and calculates it with respect to the average memory
  310. requirement of each entry in the phone book. (To see how many more
  311. entries you can have before it runs out of memory, just hit blank ENTER
  312. at the PD> prompt) Note that adding addresses do not steal away from the
  313. system's RAM. They are kept on disk.
  314.  
  315.  
  316. The structure of the data file:
  317. -------------------------------
  318.  
  319.      The data  file created  by this  program can  be edited using any
  320. ASCII text editor. Starting with version 5.10, the data file  is saved
  321. in a compressed, but readable format. Be careful editing this data, the
  322. de-compressing routine may have objections. If you experience  problems
  323. with  the program,  load  PHONE.DAT into your  text editor  and make
  324. sure that  your data  file corresponds to this format:
  325.  
  326.  
  327.             LINE #   SAMPLE DATA     NOTES
  328.             ------   ------ ----     -----
  329.               1       "1     "        The log activity flag.
  330.                          or
  331.                       "0     "        the amount of spaces   
  332.                                       may vary.
  333.  
  334.               2       "ATDT"          Modem dial string.
  335.                                       This line will vary    
  336.                                       depending on
  337.                                       what you enter at the
  338.                                       initialization.
  339.  
  340.              3-7      "!","12731"     Phone dial pre-fixes..
  341.                                       Five lines.
  342.  
  343.              7        SOMEONE        The name of the person (compressed)
  344.              8        0119152213819  The phone number of the person
  345.              9        0              Link-address to the address file.
  346.            
  347.              . The above three lines keep repeating from now on.
  348.              .
  349.              .
  350.            
  351. Note that lines 7 through the end of the file will appear as hex
  352. characters if you have the commercial version, and selected Data
  353. Encryption and Lockup option which provides safety against unauthorised
  354. access to your files.
  355.  
  356.  
  357. Mid-Version Update from 6.00 to 6.10:
  358. -------------------------------------
  359.  
  360. With this update, the program now searches your PATH to find its data
  361. files. So you may keep your PHONE.DAT, PD.SET, ADDRESS.DAT somewhere
  362. else, and the program will search the path to find them. Consult DOS
  363. manual on how to set up your PATH.
  364.  
  365. Mid-Version Update from 6.10 to 6.20:
  366. ----------------------------------------
  367.  
  368. * C0 is now parsed correctly. It wasn't working before.
  369.  
  370. * PD.SET, if it is updated, is placed in the same directory as the
  371.   ADDRESS.DAT and PHONE.DAT files. So, you can keep them elsewhere, and
  372.   PD will find them.
  373.  
  374. * To find the three files, PD now not only searches your PATH, but also
  375.   LIB, LIBRARY, and INIT environmental variables, if they are defined.
  376.   For example, to tell PD to find its data files in the G:\LIB
  377.   directory, you may either add G:\LIB to your PATH variable, or say
  378.       SET INIT=G:\LIB
  379.   to have the G:\LIB searched for the files.
  380.  
  381. * Problems with print option have been eliminated. It now works as it
  382.   should.
  383.  
  384.  
  385. ------------------------cut here and mail---------------------------
  386.  
  387. Order Form
  388. - - - - -
  389.  
  390.  
  391. To: Turgut Kalfaoglu
  392.     1378 Sok. 8/10
  393.     Izmir 35210
  394.     Turkey
  395.  
  396. [  ]YES! I register. Please send me the latest version on a diskette of
  397.      the size specified below. I also realize that I will receive free
  398.      update information. I enclose $30 for registration, shipping and
  399.      handling.
  400.  
  401.  
  402. [ ]NO!   I can't register yet - I have problems with the software. I am
  403.      describing them below. I am enclosing no money at this time.
  404.  
  405.  
  406.  Name  _________________________________________
  407.  
  408.  
  409.  Mailing address  ___________________________________
  410.  
  411.  
  412. _________________________________________________________
  413.  
  414.  
  415. E-Mail address  ________________ @ _________________ (optional)
  416.  
  417.  
  418. Current PD version  ________._________
  419.  
  420.  
  421. Computer equipment consists of _______________________ (optional)
  422.  
  423.  
  424. _________________________________________________________
  425.  
  426.  
  427. My Diskette Drive type is  ___________ Kilobytes
  428.  
  429.                          [  ] 3 1/2     [  ] 5 1/4 inches
  430.  
  431. My Comments ____________________________________________ 
  432.  
  433.  
  434. ________________________________________________________
  435.  
  436.  
  437.