@database Conatct97.guide @author "Steve Boxall" @(c) "Giftware 1997" @$VER: Contact97 1.1 July 3rd 1997 @wordwrap @node Main "Contact97 Address Book" Contact97 =========== @{"Introduction" link Introduction} A brief explanation of Contact97 @{"Disclaimer" link "Disclaimer"} Disclaimer & Distribution @{"Author" link Author} Who is he? @{"Installation" link Installation} Installing Contact97 @{"Using Contact97" link Using} Using Contact97 @{"History" link History} Development History @{"Credits" link Credits} Credits @endnode @node Introduction @prev Main @next "Disclaimer" Introduction ============== Contact97 is my solution to the address book problem. I wanted a small address / telephone book program that did only what I needed. The result is Contact97. This program provides, using GadToolsBox & Dice 'C' ,data fields for the following: Name Company Name Address ( Address has a variable no' of lines ) E-mail Address ( currently max 30 characters ) Telephone No. Fax No. I have also provided a Search / Find function whereby you can select which fields you wish to search for the text entered. This was one function that I have always looked for in programs like this. ####### ####### This is only my Second Amiga program ####### ####### ( anything could happen - but I have tested it using Enforcer / Mungwall ) ####### ####### This AmigaGuide is also available in the program by pressing ####### I have a question to those that can answer : when the program executes it does not return some of its memory unless I AVAIL FLUSH twice, is this normal? Contact97 is Giftware, by which a gift could be programming hints / tips , registered shareware programs ( from the shareware author ), or even cash (UK £). You are, however, under no obligation to send anything as the program is not disabled in any way. The 'C' code and GadToolsBox GUI is included in the archive. ( DICE compatible ) @endnode @node "Disclaimer" "Disclaimer & Distribution" @prev Introduction @next Author Disclaimer ---------- The @{"author" link Author} is in no way liable for any changes made to any part of the program, or consequences thereof as he is in no way liable for damages or loss of data directly or indirectly caused by this software. Distribution ------------ Neither fees may be charged nor profits may be made by distributing this piece of software. Only a nominal fee for costs of magnetic media may be accepted, the amount of US $5 shouldn't be exceeded for a disk containing Contact97. CD Manufactures are specifically granted the right to include this program on CD collections, as long as they are for the Public Domain. Magazine Publications may use Contact97 on their cover disk / CD-ROM, providing a , preferably CD-ROM, copy of the magazine containing the program is supplied to the author free of charge. @endnode @node Author "The Author of this software" @prev "Disclaimer" @next Installation The Author ============ I am Steve Boxall of 12 Forstal Close, Snatchill, Corby, Northants, UK Like many others I have previously owned Commodore Vic 20's and C64's which I programmed in 6502 Assembler. However, despite owning an Amiga A1200 for over 3 years I had not until recently written any Amiga specific progams. Of course through work or college I had used languages such as BASIC, DBase IV/V, ANSI 'C' and some that are more obscure but the Amiga initially had me stumped. Then I acquired the Amiga Developer CD-ROM and I was at the same time learning to use DELPHI 1.0 on the ***dows PC, things began to become clearer on how to program using the excellent Amiga O/S. It is alot more work than in Delphi but the programs are very much smaller and you have more control. The Only other Amiga program that I have written is Hangman97, also included in this archive. This is also my first attempt at creating an AmigaGuide document and using it from within my own program. My Amiga System : Amiga A1200 Commodore Model Blizzard A1230 III Turbo 50mhz 8mb Fast Ram Seagate 290mb 3.5" Harddrive Power HD external Floppy 4x IDE CD-ROM All running on a Standard A1200 Power supply!! Eventually I want to add a POWERUP board, a tower case and a graphics card. @endnode @node Installation "Installing Contact97" @prev Author @next Using Installing ============ I have to appologise for not providing an install script, but I do not yet know how to create one. Contact97 requires the following libraries to be present: Asl.Library O/S 3.0+ Diskfont.Library O/S 3.0+ AmigaGuide.Library O/S 3.0+ GadTools.Library included It also requires the following (included) font: XHelvetica The Contact97 directory can be placed anywhere but the AmigaGuide file must be in the same directory or in the system Help: directory The data file created is written to the system S: directory as Contact97.Dat when you first choose to quit Contact97. @endnode @node Using "Using Contact97" @prev Installation @next MainW Contact97 =========== @{"Main Window" link MainW} The Main Window @{"Edit Window" link EditW} Editing Window @{"Find Window" link FindW} Find Window @{"Quiting" link QuitProg} Installing Contact97 @endnode @node MainW "Main Window" @prev Using @next AddB Main Window ============= @{"Add Button" link AddB} Adding New Names @{"Edit Button" link EditB} Editing Names @{"Find Button" link FindB} Finding Names @{"Delete Button" link DelB} Deleting Names @{"Quit Button" link QuitProg} Exiting Contact97 @{"Menu " link MenuProg} Contact97 Menu @endnode @node AddB "Adding Names" @prev MainW @next EditB Adding New Names ================ To add a NEW name simply type the name into the edit box on the Main Window and select Add using one of , Contacts Menu->Add, Add Button. If a duplicate Name is given then a requester will appear, click Ok and enter a different name. The name is then added and the @{"Edit" link EditW} window will appear. @endnode @node EditB "Edit Button" @prev AddB @next FindB Edit Button ============= To edit an existing name simply type the name into the edit box on the Main Window or double-click the name in the list on the Main Window. If the name exists the @{"Edit" link EditW} window will appear. Names can also be edited via the @{"Find Window" link FindW}. @endnode @node FindB "Find Button" @prev EditB @next DelB Find Button ============= This button takes you to the @{"Find Window" link FindW}. @endnode @node DelB "Delete Button" @prev FindB @next QuitProg Delete Button =============== To Delete an existing name simply type the name into the edit box on the Main Window or selecting the name in the list on the Main Window. If the name exists a requester will appear asking if you are sure that you want to delete the name. @endnode @node QuitProg "Quiting Contact97" @prev DelB @next MenuProg Quit Button ============= This button allows you to save your data and/or quit the program. It will first bring up a requester asking if you wish to save your data. Then it will ask if you wish to quit. (TIP : if you are adding names then select quit, save YES, Quit NO ) @endnode @node MenuProg "Contact97 Menu" @prev QuitProg @next Main Contact97 Menu ================ The Contact97 Menu is only available from the MAIN window and allows all of the same features as the main window. In addition and extra set of functions are available: Print->Print Names + Numbers - Prints ALL Names and telephone no's Print->Print Names + Addresses - Prints ALL Details for ALL Contacts @endnode @node EditW "Edit Window" @prev MainW @next NameB Edit Window ============= The Edit Window contains the following gadgets: @{"Name " link NameB} Name of Person* @{"Company Name " link CompanyN} Company Name @{"Company Address" link CompanyA} Company Address @{"Email " link EmailB} Email Address @{"Telephone " link TelB} Telephone Number @{"Fax " link FaxB} Fax Number @{"Ok " link EditOk} Accept Changes @{"Print " link PrintOk} Print Contact @{"Cancel " link EditCan} Cancel Changes @endnode @node NameB "Name of Person" @prev EditW @next CompanyN Name Of Person ================ ### ### ### NEVER change the contents given in this gadget. ### ### @endnode @node CompanyN "Name of Company" @prev EditW @next CompanyA Company Name ============== ### ### ### Company Name can be Max 30 characters - DO NOT use commas in name ### ### @endnode @node CompanyA "Address of Company" @prev EditW @next EmailB Company Address ================ ### ### ### Each Company Address Line can be Max 30 characters ### ### DO NOT use commas in name ### ### ### Use the '+' gadget to add another line to the bottom of the list ### ### Use the '-' gadget to delete the selected Address Line ### ### To change an address line SELECT it in the list then enter the ### changes in the edit box. ### ### @endnode @node EmailB "Email Address" @prev EditW @next TelB Email Address =============== ### ### ### Email Address can be Max 30 characters - DO NOT use commas ### ### @endnode @node TelB "Telephone Number" @prev EditW @next FaxB Telephone Number ================== ### ### ### Telephone Number can be Max 20 characters - DO NOT use commas ### ### @endnode @node FaxB "Fax Number" @prev EditW @next EditOk Fax Number ============ ### ### ### Fax Number can be Max 20 characters - DO NOT use commas ### ### @endnode @node EditOk "Accept Edit Changes" @prev EditW @next PrintOk Accept Changes ================ ### ### ### Accept the changes made ### ### @endnode @node PrintOk "Print the Contact Details" @prev EditW @next EditCan Print the Contact Details =========================== ### ### ### Print the Contact Details ### ### @endnode @node EditCan "Cancel Edit Changes" @prev EditW @next Main Cancel Changes ================ ### ### ### Cancel the changes made ### ### @endnode @node FindW "Find Window" @prev MainW @next FName Find Window ============= The Find Window contains the following gadgets: @{"Find Text " link FName} Text to Search for @{"Find Fields " link FField} Fields to Search @{"Find Result " link FResult} Search Result @{"Find " link FindOk} Search @{"Cancel " link FindCan} Return to Main Window @endnode @node FName "Text to Search For" @prev FindW @next FField Find Text =========== ### ### ### Text to search for, can be Max 30 characters - DO NOT use commas ### ### @endnode @node FField "Fields to Search" @prev FindW @next FResult Search Fields =============== ### ### ### Place a check mark ( a tick ) against each of the fields you wish ### to search for the text entered ### ### @endnode @node FResult "Search Result" @prev FindW @next FindOk Find Result ============= ### ### ### This displays the result of the search, double-click the item ### that you wish to view or edit ### ### Double-Clicking an Item brings up the @{"Edit Window" link EditW} ### @endnode @node FindOk "Accept Search" @prev FindW @next FindCan Accept Search =============== ### ### ### Do the search using the criteria entered ### ### @endnode @node FindCan "Cancel Search Window" @prev FindW @next Main Cancel Search ================ ### ### ### Returns to the @{"Main Window" link MainW} ### ### @endnode @node History "Development History" @prev Main @next Credits Development History ===================== 97-06-24 First Internal Release V1.0 - No Printing Functions - List of Names NOT sorted 97-07-01 Second Internal Release V1.1 - Printing Functions ADDed @endnode @node Credits "Development History" @prev History Credit where Credit due ========================= Credits in no particular order : Amiga Technologies For supporting the Amiga Schatztruhe For publishing the Developer CD Gateway 2000 For giving the Amiga another chance JABA Development For GadToolsBox Mat Dillon For DICE 'C' BSB Books For their Mastering Amiga series Reaper For EZPrinter.c @endnode