home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 118.lha / PhoneMate_3.027 / pmate.doc < prev    next >
Text File  |  1986-11-20  |  17KB  |  406 lines
  1.                  
  2.                    BRENDALLSON SOFTWARE WOULD LIKE TO THANK :-
  3.  
  4.  
  5.             Duane Wandless, Davey Utter, Kevin Murphy, Mark Elmore,
  6.       and Snow Lynn Bain, in order of importance to program developement.
  7.  
  8.  
  9.                        BRENDALLSON SOFTWARE PRESENTS :
  10.  
  11.  
  12. ;                                                                           ;
  13. ;---------------------------------------------------------------------------;
  14. ; Name       :- Phonemate v3.027                                            ;
  15. ; Author     :- Gregory A. Kendall ( Percy )                                ;
  16. ; Date       :- 19 March 1988 ( Mundania )                                  ;
  17. ; Spefs      :- 1. Full release of 3.000-BETA                               ;
  18. ;               2. Last release using Manx C v3.20A                         ;
  19. ; Comments   :- Amigabasic is a thing of the past for me!!! heehee          ;
  20. ;---------------------------------------------------------------------------;
  21. ;                                                                           ;
  22.  
  23.  
  24. TERMS :-
  25.  
  26.    P1       :- MENU.USR format for Phonemate v3.000-BETA
  27.    P2       :- MENU.USR format for Phonemate v3.027
  28.  
  29.  
  30.    Ok, here it is!  The promised full-release version of Phonemate in C.
  31. This version ( 3.027 ) is officially the first REAL Phonemate from
  32. Brendallson Software and myself.  As a matter of origin, this program
  33. written by Gregory A. Kendall, Member AUGU ( Athens GA Amiga Users Group ),
  34. Brendallson Software in the first half of 1988 in Athens Georgia.
  35.  
  36.    Hey, guess what?????  I added plenty of nifty things in this version over
  37. the BETA release.  Some of these include counting calls instead of rings,
  38. animated gadgets, MORE menus, a better STORE gadget, faster... sort,
  39. smaller menu.usr file, color, and a hidden special mode for those who
  40. contribute Shareware money to Brendallson Software.
  41.  
  42.  
  43.  
  44.                        AND NOW A WORD FROM OUR SPONSOR...   
  45.  
  46. \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  47.  
  48.    THIS PROGRAM IS SHAREWARE. I DONOT AUTHORIZE BLIND DISTRIBUTION OF
  49. PHONEMATE V3.027 EXCEPT IN THE FOLLOWING CASES:
  50.  
  51.    The Athens Georgia Amiga Users Group ( AUGU ) is authorized to distribute
  52.       Phonemate v3.027 on it's Public Domain Disks at NO charge.
  53.    The New Orleans Amiga Users Group is also similarly authorized.
  54.    John Foutty of Pennsylvania, a registered user, is authorized to
  55.       distribute Phonemate without making a profit.
  56.    Anyone sending a contribution will become a registered Phonemate user and
  57.       will be authorized to distrubute Phonemate v3.027 freely as they see
  58.       fit without making a profit.  Also, registered users are also included
  59.       the list for FREE future updates, not including hardware.
  60.  
  61. NOTE, BLIND DISTRIBUTION IN THIS CONTEXT MEANS THAT DISTRIBUTING PHONEMATE ON
  62. A PUBLIC DOMAIN OR OTHER DISK FOR A PROFIT IS PROHIBITED.  THIS DOES NOT
  63. INCLUDE ROUTINE UPLOADING OF PHONEMATE TO LOCAL AND NATIONAL FORUMS AND
  64. BBS SIGS, THAT IS, ALL ROUTINE UPLOADS FOR NON-PROFIT DISTRIBUTION ARE NOT
  65. ONLY AUTHORIZED BUT ENCOURAGED.
  66.  
  67. I OFFER NO WARRENTY, WRITTEN OR IMPLIED, FOR THIS PROGRAM OTHER THAN FOR BUG
  68. UPDATES, AND FREE FUTURE UPDATES TO REGISTERED USERS ONLY.  AT MY DISCRETION,
  69. COMMENTS AND HELP CONCERNING PROGRAM DEVELOPMENT WILL CONSTITUTE A WAIVE OF
  70. MY SHAREWARE POLICY AND A REGISTRATION OF THAT USER.
  71.  
  72. MY SHAREWARE POLICY :-
  73.  
  74.    Most people think that Shareware is a place for them to get good money
  75. for a program without going through all of the trouble of releasing their
  76. programs with flashy packages and going through dealers.  I, on the other
  77. hand, am not a greedy hacker ( I am not calling anyone a greedy hacker ) and
  78. I am only asking for a little.  PLEASE take a second to drop me a line and if you
  79. would like to send a contribution to the Brendallson Cause, please limit
  80. this to only $3 to $7.  $8 and up is right off!!!!  I would not like nor
  81. will I feel comfortable in accepting more than $8 at this time, although
  82. I have done it in the past.
  83. I will probably just send a large contribution back unless you insist.
  84. I am not in programming to make money, yet...  I am in it for the fun!!!! So,
  85. as you can see, I am interested in your comments about my program!!!  I only
  86. ask for money to help cover development costs.
  87.  
  88.  
  89.     Keep in mind!!!!  For all those who send me a contribution, I will send
  90. back an explaination of how to invoke the SPECIAL hidden mode! 
  91.  
  92.  
  93.    Again, please take the time to drop me a line with comments concerning my
  94. program and possibly a contribution.  Send all mail to the following
  95. address:
  96.  
  97.                         Gregory A. Kendall
  98.                         ATN/ Brendallson Software
  99.                         522 Neese Road
  100.                         Woodstock, Georgia  30188
  101.  
  102.            Thanks for the time and you will hear from me back....
  103.  
  104. \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  105.  
  106.  
  107.                 AND NOW BACK TO OUR PROGRAM ( HEEHEEHEE )    
  108.  
  109.  
  110.  
  111.  
  112.   Table of Contents  :-
  113.  
  114.       I. Getting Started
  115.      II. Command Parameters
  116.       B. Storing/Editing Numbers
  117.       C. Trashing Numbers
  118.       D. Moving Numbers Around
  119.       E. Dialing Numbers via Menus
  120.       F. Dialing Numbers via Gadgets
  121.       G. Sorting Menus
  122.       H. Clearing the Output Window
  123.       I. Counting Calls
  124.       J. Alternate Ringer Volume
  125.  
  126.  
  127.  
  128.   I. Getting Started
  129.  
  130.  
  131.    You have obviously de-ARCed this file so I won't go through all of the
  132. trouble of telling you to de-ARC the file.  You should now have the following
  133. files :
  134.  
  135.    *   pmate        : main file
  136.        pmate.doc    : this doc file
  137.        pmate.info   : icon for pmate
  138.        Format       : p1 menu.usr file fixer.
  139.  
  140. PMATE ( marked with an '*' above ) is the only file necessary for running
  141. Phonmate v3.027.  Notice that the menu.usr file is conspicuously missing
  142. from the above list and the ARC file.  This is not a mistake.  Phonemate now
  143. has a pretty sophisticated file-error handling section.  "What does this
  144. mean," you ask????  Well, upon startup, Phonemate looks for MENU.USR in the
  145. directory it was booted from.  It then decides which of the following
  146. conditions the MENU.USR file meets:
  147.  
  148.    1. It exists...
  149.       x Phonemate loads the file in and no error condition exists.
  150.    2. The file exists but is mangled or in P1 format...
  151.       x Phonemate informs you of this problem and then exits.
  152.    3. The file does not exist...
  153.       x Phonemate informs you of this problem and then creates a NEW
  154.         MENU.USR in memory only!  Phonemate now only saves changes made to
  155.         the menus as the program exits, so this NEW file will NOT be on disk
  156.         unless you save the file when you exit Phonemate.
  157.  
  158.    Condition 3 above opens up a new aspect of Phonemate that I am 
  159. pointing out here.  You can now create brand-new files, thus the reason
  160. for not including a pre-initialized MENU.USR file.  Just run the program and
  161. a MENU.USR file will be created for you, but remember, if you don't save
  162. the file on exit from the program, you will loose your new file.  Don't
  163. worry, Phonemate will ask you if you want to save the file when you hit the
  164. CLOSEWINDOW gadget.
  165.  
  166.  
  167.   NOTE :- See the discussion of PARAMETERS for more information of multiple
  168.           MENU.USR files.
  169.  
  170.  
  171.  
  172. FORMAT:-
  173.  
  174.    Please Note!!!!!!!  Phonemate v3.027 has been modified for better file
  175. management, so it DOES NOT support the P1 format of Phonemate v3.000-BETA.
  176. Phonemate's MENU.USR files are now P2 type; however, don't dispair yet!!!
  177. One of MY biggest complaints about the Phonemate Series is that none of the
  178. versions have supported the MENU.USR format of the previous version, that is
  179. until now!
  180.    I have included FORMAT in the ARC file.  This is a utility that will
  181. convert a P1 format MENU.USR file into a P2 format MENU.USR file.  For an
  182. explanation of how it works, just type the following from CLI:
  183.  
  184.    FORMAT ?
  185.  
  186. The utility will give you the format for the parameters to pass it for its
  187. work.
  188.  
  189. II. Command Parameters :-
  190.  
  191.    Phonemate now supports a number of command-line parameters to handle some
  192. new aspects of Phonemate's abilities.
  193.  
  194.    Pmate [-s -p -iFILENAME]
  195.  
  196.    -s : Suppress ATS0=0.
  197.  
  198.          Some Hayes compatable modems out there do not support the ATS0=0
  199.             command for suppressing AUTO-ANSWER.  That is all that this
  200.             command that pops up in window on boot up does.  Using the -s
  201.             command ( lotsa commands huh?? ) keeps Phonemate from issuing
  202.             that command.  Use this option only if issuing ATS0=0 results in
  203.             an error condition.
  204.  
  205.    -p : Enable Pulse Dialing.
  206.  
  207.          Some areas out there donot yet support TONE dialing and some modems
  208.             only work in PULSE mode.  So, I have included this option of
  209.             dialing by PULSE instead of TONE.  If you wish to use PULSE
  210.             dialing instead of TONE,  use this option.
  211.  
  212.                ( pmate -p )
  213.  
  214.  
  215.    -iFILENAME : Include file FILENAME as the MENU.USR file.
  216.  
  217.          This command tells Phonemate to use FILENAME as the name of a
  218.             valid MENU.USR file.  This allows you to keep different MENU.USR
  219.             files around in the same directory and boot them up as needed.
  220.             For example, if I have to menu files in a directory with Pmate
  221.             one called MENU.USR and the other called... say... Junk, then
  222.  
  223.             Pmate
  224.  
  225.             would boot up Phonemate and Phonemate would load in the default
  226.             filename... MENU.USR and
  227.  
  228.             Pmate -iJunk
  229.  
  230.             would boot up Phonemate and Phonemate would load in the
  231.             alternate MENU.USR file named "Junk."
  232.  
  233.  
  234.   B. Storing/Editing Numbers 
  235.  
  236.  
  237.    This is probably the first thing that you will want to do once you get
  238. Pmate up and running.
  239.  
  240.    To STORE a number, do the following steps :-
  241.  
  242.       1. Click on the STORE gadget.
  243.       2. Choose the menu which you wish to STORE into.
  244.     ***  A requester pops up
  245.       3. Click in the NAME field.
  246.     ***  The NAME field is cleared.
  247.       4. Type in the NAME you wish to go there and move on.
  248.       5. Do the same for the rest of the fields in the requester.
  249.  
  250.     NOTE :- the COMM field is optional.  This allows you to enter a
  251. RIGHT-AMIGA key sequence for the NAME/NUMBER as well.
  252.  
  253.    EDIT : - in order to edit, you just click on the STORE gadget, choose the
  254. menu you wish to edit and edit away!!!!  You'll see what I mean!  And you'll
  255. think that I was a bit goofy calling the above section STORE at all since
  256. all you were doing was editing a null-menu entry.
  257.  
  258.  
  259.   C. Trashing Numbers :- 
  260.  
  261.  
  262.    To delete a number, just click on the TRASH gadget, choose the menu you
  263. want trashed, and the program does the rest.
  264.  
  265.  
  266.  
  267.   D. Moving Numbers :- 
  268.  
  269.  
  270.    I have included a MOVE facility in this version series.  This allows you
  271. to move menus from one place to another to suit your fancy.  Just click on
  272. the MOVE gadget, choose the FROM menu, then choose the TO menu.  The program
  273. then moves the menu entry.
  274.  
  275.  
  276.  
  277.   E. Dialing Via Menus :- 
  278.  
  279.  
  280.    To dial a number from the menus, just choose the menu you with Pmate to
  281. dial for you and the program does the rest.  Remember, if you modem is not
  282. normaly on, you must turn it on before dialing.
  283.  
  284.  
  285.   F. Dialing Via Gadgets :- 
  286.  
  287.  
  288.    Follow the following steps to dial a number from the key-gadgets :-
  289.  
  290.       1. Click on the DIAL gadget.
  291.       2. Enter the number using the KEYPAD gadgets on the screen.
  292.       3. When you are done entering, click on the DIAL gadget again
  293.    ***   Pmate dials the number for you.
  294.  
  295.  
  296.   G. Sorting Menus :- 
  297.  
  298.  
  299.    I have included a SORT utility in the program for this version.  I
  300. promise that this version of the SORT ( due to the manner and speed of C)
  301. will run VERY MUCH FASTER than its BASIC counterpart.  All of the menus are
  302. sorted into alpha-beta order separately.  Each menu will be alphabetized
  303. within itself.  This SORT utility ran in 10 seconds in v3.000-BETA.  That
  304. was ok but I have been demonic in code tuning this section and have trimmed
  305. it down to operating in less than 3 seconds.  I think that it is now much
  306. more pleasant to sort the menus than ever before.
  307.  
  308.  
  309.   H. Clearing The Output Window :- 
  310.  
  311.  
  312.    To clear the output window, just click on the TITLE gadget at the top of
  313. the screen.  You know, the one that says "BRENDALLSON SOFTWARE'S..." etc...
  314. You'll see what I mean.
  315.  
  316.  
  317.   I. Counting Calls :-
  318.  
  319.    Due to problems with timing and code sync-ups, v3.000-BETA did not do
  320. more than count the number of rings that had occured since the count had
  321. been cleared.  However, I have now fixed this little problem and Phonemate
  322. gives a very nearly perfect count of the number of calls that have come in
  323. since the count was cleared.  This is useful for when you leave for a while
  324. and want to know how many calls you would have had if you had been there.
  325.    Yeah, you say, but it only tells me how many I might have had.  Why can't
  326. someone come up with a way to get it to answer and take messages?  Well, my
  327. dear friend, that is exactly why this feature is available now.  It is a
  328. precursor routine being developed to make way for the _Answer() routine
  329. and hardware that is currently on the Brendallson Drawing Board.  Hopefully,
  330. this will allow Phonemate to answer the phone and take a message just like
  331. an answering machine using no more memory than a 512k Amiga has available.
  332.  
  333.    To get the number of calls just click on the CALLS gadget.  The
  334. number of calls will be displayed on the status line at the top of the
  335. screen.
  336.  
  337.    To CLEAR the count, just clear the output window.  The
  338. clear-the-output-window routine also clear the _calls count.  See, it's
  339. easy!
  340.  
  341.  
  342.  
  343.   J. Alternate Ringer Volume :- 
  344.  
  345.  
  346.    This version also contains the famous alternate ringer.  When the program
  347. is run, it comes up with the volume set to zero.  There is an un-marked
  348. proportional gadget on the right hand side of the window that sets the
  349. volume.  Now that you know what it is, I think it is intuitive how to set
  350. it.
  351.  
  352.  
  353.  
  354.   AFTERWORD :- 
  355.  
  356.  
  357.    Well, I am finally to the end of another DOC file and Version of
  358. Phonemate.  I would like to take this time to thank all of you who have sent
  359. in contributions and suggestions for Phonemate.  Your support is what keeps
  360. this Phonemate project on the drawing boards and for the time-being, in the
  361. ShareWare end of the business.  I cannot guarantee that Brendallson will
  362. release an Amiga answering machine Phonemate, nor can I guarantee that
  363. Phonemate will remain ShareWare when this comes about.  Sorry, I hate to be
  364. vague but I feel bad if I lead on users when a decision has not been made
  365. concerning whether or not Phonemate should be developed into an answering
  366. maching for the Amiga.  I can say, however, that ShareWare registered users
  367. of this program will only be required to pay for the hardware requirements
  368. of Phonemate, the Amiga Answering Machine.  This gives registered Phonemate
  369. users a nifty opportunity to save bucks on Phonemate if it is determined
  370. profitable enough to continue developing it to the answering stage.
  371.  
  372.    I hope that you enjoy this program as much as I have enjoyed writing it
  373. yet again....  I regret that this version is still being compiled on Manx
  374. 3.20A compiler.  As soon as I am done releasing this version to the public
  375. and finished with PERI ( a VideoScape3d geometry file utility ), I will
  376. begin work on Phonemate v3.100++.  This next version is projected to
  377. include, IFF sound file support for the alternate ringer, a message system
  378. akin to the message system provided in earlier BASIC versions of Phonemate,
  379. an alarm clock with either a spoken message or an IFF sound file alarm, and
  380. will be compiled with the latest version of the Manx Compiler.  It may
  381. include the beginnings of a terminal program and/or support for a 1000 entry
  382. disk based phonenumber list.
  383.  
  384.    My only complaint about this version of Phonemate is that since it has
  385. been compiled with an old version of the Manx Compiler, the animated gadgets
  386. have a bit of trouble with rendering in WorkBench/Kiskstart 1.2.  When my new
  387. compiler arrives, you may see the release of Phonemate v3.030 which will be
  388. the same as v3.027 but will be fixed to render better in WorkBench 1.2.
  389.  
  390.    Have fun with Phonemate v3.027 and PLEASE, write to me if you have a
  391. contribution or just a comment/question concerning the program or docs.
  392. Feedback and contributions will be a deciding factor in the future of
  393. Phonemate.  I think you'll agree that it is as easy as 1-2-3 should be!!!!
  394. ( Lotus that is)... heeheehee
  395.  
  396.  
  397.  
  398.  Thank you,
  399.  
  400.  Gregory A. Kendall,
  401.  
  402.  and Brendallson Software.... 
  403.  
  404.  
  405.  
  406.