Club Amiga de Montreal

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 >

Wrap

Text File | 1986-11-20 | 16.1 KB | 406 lines

BRENDALLSON SOFTWARE WOULD LIKE TO THANK :- Duane Wandless, Davey Utter, Kevin Murphy, Mark Elmore, and Snow Lynn Bain, in order of importance to program developement. BRENDALLSON SOFTWARE PRESENTS : ; ; ;---------------------------------------------------------------------------; ; Name :- Phonemate v3.027 ; ; Author :- Gregory A. Kendall ( Percy ) ; ; Date :- 19 March 1988 ( Mundania ) ; ; Spefs :- 1. Full release of 3.000-BETA ; ; 2. Last release using Manx C v3.20A ; ; Comments :- Amigabasic is a thing of the past for me!!! heehee ; ;---------------------------------------------------------------------------; ; ; TERMS :- P1 :- MENU.USR format for Phonemate v3.000-BETA P2 :- MENU.USR format for Phonemate v3.027 Ok, here it is! The promised full-release version of Phonemate in C. This version ( 3.027 ) is officially the first REAL Phonemate from Brendallson Software and myself. As a matter of origin, this program written by Gregory A. Kendall, Member AUGU ( Athens GA Amiga Users Group ), Brendallson Software in the first half of 1988 in Athens Georgia. Hey, guess what????? I added plenty of nifty things in this version over the BETA release. Some of these include counting calls instead of rings, animated gadgets, MORE menus, a better STORE gadget, faster... sort, smaller menu.usr file, color, and a hidden special mode for those who contribute Shareware money to Brendallson Software. AND NOW A WORD FROM OUR SPONSOR... \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/ THIS PROGRAM IS SHAREWARE. I DONOT AUTHORIZE BLIND DISTRIBUTION OF PHONEMATE V3.027 EXCEPT IN THE FOLLOWING CASES: The Athens Georgia Amiga Users Group ( AUGU ) is authorized to distribute Phonemate v3.027 on it's Public Domain Disks at NO charge. The New Orleans Amiga Users Group is also similarly authorized. John Foutty of Pennsylvania, a registered user, is authorized to distribute Phonemate without making a profit. Anyone sending a contribution will become a registered Phonemate user and will be authorized to distrubute Phonemate v3.027 freely as they see fit without making a profit. Also, registered users are also included the list for FREE future updates, not including hardware. NOTE, BLIND DISTRIBUTION IN THIS CONTEXT MEANS THAT DISTRIBUTING PHONEMATE ON A PUBLIC DOMAIN OR OTHER DISK FOR A PROFIT IS PROHIBITED. THIS DOES NOT INCLUDE ROUTINE UPLOADING OF PHONEMATE TO LOCAL AND NATIONAL FORUMS AND BBS SIGS, THAT IS, ALL ROUTINE UPLOADS FOR NON-PROFIT DISTRIBUTION ARE NOT ONLY AUTHORIZED BUT ENCOURAGED. I OFFER NO WARRENTY, WRITTEN OR IMPLIED, FOR THIS PROGRAM OTHER THAN FOR BUG UPDATES, AND FREE FUTURE UPDATES TO REGISTERED USERS ONLY. AT MY DISCRETION, COMMENTS AND HELP CONCERNING PROGRAM DEVELOPMENT WILL CONSTITUTE A WAIVE OF MY SHAREWARE POLICY AND A REGISTRATION OF THAT USER. MY SHAREWARE POLICY :- Most people think that Shareware is a place for them to get good money for a program without going through all of the trouble of releasing their programs with flashy packages and going through dealers. I, on the other hand, am not a greedy hacker ( I am not calling anyone a greedy hacker ) and I am only asking for a little. PLEASE take a second to drop me a line and if you would like to send a contribution to the Brendallson Cause, please limit this to only $3 to $7. $8 and up is right off!!!! I would not like nor will I feel comfortable in accepting more than $8 at this time, although I have done it in the past. I will probably just send a large contribution back unless you insist. I am not in programming to make money, yet... I am in it for the fun!!!! So, as you can see, I am interested in your comments about my program!!! I only ask for money to help cover development costs. Keep in mind!!!! For all those who send me a contribution, I will send back an explaination of how to invoke the SPECIAL hidden mode! Again, please take the time to drop me a line with comments concerning my program and possibly a contribution. Send all mail to the following address: Gregory A. Kendall ATN/ Brendallson Software 522 Neese Road Woodstock, Georgia 30188 Thanks for the time and you will hear from me back.... \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/ AND NOW BACK TO OUR PROGRAM ( HEEHEEHEE ) Table of Contents :- I. Getting Started II. Command Parameters B. Storing/Editing Numbers C. Trashing Numbers D. Moving Numbers Around E. Dialing Numbers via Menus F. Dialing Numbers via Gadgets G. Sorting Menus H. Clearing the Output Window I. Counting Calls J. Alternate Ringer Volume I. Getting Started You have obviously de-ARCed this file so I won't go through all of the trouble of telling you to de-ARC the file. You should now have the following files : * pmate : main file pmate.doc : this doc file pmate.info : icon for pmate Format : p1 menu.usr file fixer. PMATE ( marked with an '*' above ) is the only file necessary for running Phonmate v3.027. Notice that the menu.usr file is conspicuously missing from the above list and the ARC file. This is not a mistake. Phonemate now has a pretty sophisticated file-error handling section. "What does this mean," you ask???? Well, upon startup, Phonemate looks for MENU.USR in the directory it was booted from. It then decides which of the following conditions the MENU.USR file meets: 1. It exists... x Phonemate loads the file in and no error condition exists. 2. The file exists but is mangled or in P1 format... x Phonemate informs you of this problem and then exits. 3. The file does not exist... x Phonemate informs you of this problem and then creates a NEW MENU.USR in memory only! Phonemate now only saves changes made to the menus as the program exits, so this NEW file will NOT be on disk unless you save the file when you exit Phonemate. Condition 3 above opens up a new aspect of Phonemate that I am pointing out here. You can now create brand-new files, thus the reason for not including a pre-initialized MENU.USR file. Just run the program and a MENU.USR file will be created for you, but remember, if you don't save the file on exit from the program, you will loose your new file. Don't worry, Phonemate will ask you if you want to save the file when you hit the CLOSEWINDOW gadget. NOTE :- See the discussion of PARAMETERS for more information of multiple MENU.USR files. FORMAT:- Please Note!!!!!!! Phonemate v3.027 has been modified for better file management, so it DOES NOT support the P1 format of Phonemate v3.000-BETA. Phonemate's MENU.USR files are now P2 type; however, don't dispair yet!!! One of MY biggest complaints about the Phonemate Series is that none of the versions have supported the MENU.USR format of the previous version, that is until now! I have included FORMAT in the ARC file. This is a utility that will convert a P1 format MENU.USR file into a P2 format MENU.USR file. For an explanation of how it works, just type the following from CLI: FORMAT ? The utility will give you the format for the parameters to pass it for its work. II. Command Parameters :- Phonemate now supports a number of command-line parameters to handle some new aspects of Phonemate's abilities. Pmate [-s -p -iFILENAME] -s : Suppress ATS0=0. Some Hayes compatable modems out there do not support the ATS0=0 command for suppressing AUTO-ANSWER. That is all that this command that pops up in window on boot up does. Using the -s command ( lotsa commands huh?? ) keeps Phonemate from issuing that command. Use this option only if issuing ATS0=0 results in an error condition. -p : Enable Pulse Dialing. Some areas out there donot yet support TONE dialing and some modems only work in PULSE mode. So, I have included this option of dialing by PULSE instead of TONE. If you wish to use PULSE dialing instead of TONE, use this option. ( pmate -p ) -iFILENAME : Include file FILENAME as the MENU.USR file. This command tells Phonemate to use FILENAME as the name of a valid MENU.USR file. This allows you to keep different MENU.USR files around in the same directory and boot them up as needed. For example, if I have to menu files in a directory with Pmate one called MENU.USR and the other called... say... Junk, then Pmate would boot up Phonemate and Phonemate would load in the default filename... MENU.USR and Pmate -iJunk would boot up Phonemate and Phonemate would load in the alternate MENU.USR file named "Junk." B. Storing/Editing Numbers This is probably the first thing that you will want to do once you get Pmate up and running. To STORE a number, do the following steps :- 1. Click on the STORE gadget. 2. Choose the menu which you wish to STORE into. *** A requester pops up 3. Click in the NAME field. *** The NAME field is cleared. 4. Type in the NAME you wish to go there and move on. 5. Do the same for the rest of the fields in the requester. NOTE :- the COMM field is optional. This allows you to enter a RIGHT-AMIGA key sequence for the NAME/NUMBER as well. EDIT : - in order to edit, you just click on the STORE gadget, choose the menu you wish to edit and edit away!!!! You'll see what I mean! And you'll think that I was a bit goofy calling the above section STORE at all since all you were doing was editing a null-menu entry. C. Trashing Numbers :- To delete a number, just click on the TRASH gadget, choose the menu you want trashed, and the program does the rest. D. Moving Numbers :- I have included a MOVE facility in this version series. This allows you to move menus from one place to another to suit your fancy. Just click on the MOVE gadget, choose the FROM menu, then choose the TO menu. The program then moves the menu entry. E. Dialing Via Menus :- To dial a number from the menus, just choose the menu you with Pmate to dial for you and the program does the rest. Remember, if you modem is not normaly on, you must turn it on before dialing. F. Dialing Via Gadgets :- Follow the following steps to dial a number from the key-gadgets :- 1. Click on the DIAL gadget. 2. Enter the number using the KEYPAD gadgets on the screen. 3. When you are done entering, click on the DIAL gadget again *** Pmate dials the number for you. G. Sorting Menus :- I have included a SORT utility in the program for this version. I promise that this version of the SORT ( due to the manner and speed of C) will run VERY MUCH FASTER than its BASIC counterpart. All of the menus are sorted into alpha-beta order separately. Each menu will be alphabetized within itself. This SORT utility ran in 10 seconds in v3.000-BETA. That was ok but I have been demonic in code tuning this section and have trimmed it down to operating in less than 3 seconds. I think that it is now much more pleasant to sort the menus than ever before. H. Clearing The Output Window :- To clear the output window, just click on the TITLE gadget at the top of the screen. You know, the one that says "BRENDALLSON SOFTWARE'S..." etc... You'll see what I mean. I. Counting Calls :- Due to problems with timing and code sync-ups, v3.000-BETA did not do more than count the number of rings that had occured since the count had been cleared. However, I have now fixed this little problem and Phonemate gives a very nearly perfect count of the number of calls that have come in since the count was cleared. This is useful for when you leave for a while and want to know how many calls you would have had if you had been there. Yeah, you say, but it only tells me how many I might have had. Why can't someone come up with a way to get it to answer and take messages? Well, my dear friend, that is exactly why this feature is available now. It is a precursor routine being developed to make way for the _Answer() routine and hardware that is currently on the Brendallson Drawing Board. Hopefully, this will allow Phonemate to answer the phone and take a message just like an answering machine using no more memory than a 512k Amiga has available. To get the number of calls just click on the CALLS gadget. The number of calls will be displayed on the status line at the top of the screen. To CLEAR the count, just clear the output window. The clear-the-output-window routine also clear the _calls count. See, it's easy! J. Alternate Ringer Volume :- This version also contains the famous alternate ringer. When the program is run, it comes up with the volume set to zero. There is an un-marked proportional gadget on the right hand side of the window that sets the volume. Now that you know what it is, I think it is intuitive how to set it. AFTERWORD :- Well, I am finally to the end of another DOC file and Version of Phonemate. I would like to take this time to thank all of you who have sent in contributions and suggestions for Phonemate. Your support is what keeps this Phonemate project on the drawing boards and for the time-being, in the ShareWare end of the business. I cannot guarantee that Brendallson will release an Amiga answering machine Phonemate, nor can I guarantee that Phonemate will remain ShareWare when this comes about. Sorry, I hate to be vague but I feel bad if I lead on users when a decision has not been made concerning whether or not Phonemate should be developed into an answering maching for the Amiga. I can say, however, that ShareWare registered users of this program will only be required to pay for the hardware requirements of Phonemate, the Amiga Answering Machine. This gives registered Phonemate users a nifty opportunity to save bucks on Phonemate if it is determined profitable enough to continue developing it to the answering stage. I hope that you enjoy this program as much as I have enjoyed writing it yet again.... I regret that this version is still being compiled on Manx 3.20A compiler. As soon as I am done releasing this version to the public and finished with PERI ( a VideoScape3d geometry file utility ), I will begin work on Phonemate v3.100++. This next version is projected to include, IFF sound file support for the alternate ringer, a message system akin to the message system provided in earlier BASIC versions of Phonemate, an alarm clock with either a spoken message or an IFF sound file alarm, and will be compiled with the latest version of the Manx Compiler. It may include the beginnings of a terminal program and/or support for a 1000 entry disk based phonenumber list. My only complaint about this version of Phonemate is that since it has been compiled with an old version of the Manx Compiler, the animated gadgets have a bit of trouble with rendering in WorkBench/Kiskstart 1.2. When my new compiler arrives, you may see the release of Phonemate v3.030 which will be the same as v3.027 but will be fixed to render better in WorkBench 1.2. Have fun with Phonemate v3.027 and PLEASE, write to me if you have a contribution or just a comment/question concerning the program or docs. Feedback and contributions will be a deciding factor in the future of Phonemate. I think you'll agree that it is as easy as 1-2-3 should be!!!! ( Lotus that is)... heeheehee Thank you, Gregory A. Kendall, and Brendallson Software....