ADDRESS v2.20e January 1998 ========================================================================== Quick start ADDRESS manual An easy to use GEM based Address manager for all TOS based computers Programmed by Carsten Setje-Eilers -------------------------------------------------------------------------- Important! ---------- This publication is protected by international Copyright law. No part of this publication or the registered ADDRESS software may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into another language or computer language, in any form or by any means without the prior written consent of both Carsten Setje-Eilers and Joe Connor. Legal stuff -------------------------------------------------------------------------- Disclaimer ---------- Whilst we make every endeavour to resolve any problems you may experience using ADDRESS the liability of Carsten Setje-Eilers, Joe Connor and their agents for any loss, or consequential loss, you may suffer due to the use of ADDRESS is strictly limited to refunding your Shareware fee. All trademarks used are recognised and acknowledged. About this documentation ------------------------ + Original German manual by Carsten Setje-Eilers, Kronshagen, 1993 Copyright 1993 - 1995 Carsten Setje-Eilers, all rights reserved + English translation and adaptation by Joe Connor Copyright 1994-1998 Joe Connor, all rights reserved ADDRESS is Shareware -------------------- This means you may test ADDRESS before you buy the to decide whether it meets your needs. Unregistered versions can manage up to 40 addresses. On registering your copy a user key removes this limit which is then only limited by the available memory. So far a test database is up and running with over 18000 addresses running on a TT with 4Mb. Registered users also receive comprehensive on-line help in ST-Guide format which includes the ability to printout help pages if required. Distribution ------------ The Unregistered version of ADDRESS can be freely copied and distributed via BBSs and Mailboxes but may NOT be distributed by PD libraries, Magazine Cover disks, Magazine subscriber disks or CD-ROM collections without my prior written permission. So far the following libraries have permission to distribute ADDRESS: Goodman's Public Domain & Shareware library: Tel: 01782 335650 FaST Club: Tel: 0115 945 5250 Important! ---------- If you're using a registered copy of ADDRESS be sure to delete ADDRESS.INF and other *.INF files before passing copies on to other users. UK support and registration --------------------------- UK users can take register locally using Joe Connor's supported Shareware scheme. The Shareware fee is set to cover the stationary, media and postage costs incurred in mailing out master disks. Refer to SUPPORT.TXT for more details. General -------------------------------------------------------------------------- ADDRESS is designed to manage names and addresses. ADDRESS runs as either an application APP or accessory ACC and is programmed in GEM for maximum compatibility. ADDRESS has been tested on Atari TT030 with TOS 3.06 and MultiTOS 1.08 Beta and also on a Falcon 030 with TOS 4.04 and using the Tkr and SANG Graphic cards. Installation ------------ Simply copy all files into a folder reserved for Address on your hard disk. To run ADDRESS as an accessory, rename ADDRESS.APP to ADDRESS.ACC and copy it to your Boot drive or partition (usually C). ADDRESS can also be run from floppy disk if desired. ADDRESS List window -------------------------------------------------------------------------- On starting ADDRESS the Address list window is displayed. The Icons down the left hand side have the following meanings, from top to bottom: Icon 1: Load [Control]+O ------------------------ Select this icon to load address data files, alternatively use the 'Load' drop down menu option from the 'File' menu. Icon 2: Save [Control]+S ------------------------ Select this icon to save address data files, alternatively use the 'Save' drop down menu option from the 'File' menu. Because it's easy to load and save address files most users tend to store several seperate files, eg one file for personal contacts, another for business contacts etc. Icon 3: Clipboard [Alternate]+K ------------------------------- Selecting this icon displays a dialog with the following options: Selected: Selected (highlighted) records are copied to the Clipboard All: All listed records are copied to the Clipboard Cancel: The operation is cancelled, no action is taken Address supports the Atari Clipboard. If no clipboard exists one will be created on drive 'A' if running from floppy or partition 'C' if running from hard disk. Icon 4: Editor [Control]+E -------------------------- Select this icon to open the address editor. The first selected address in the list is automatically loaded into the editor. Icon 5: Import/export [Alternate]+X ----------------------------------- Select the two arrows icon to open the Import/Export dialog. Using this dialog address lists can be formatted and imported/exported in many different pre-defined database formats. Refer to 'File import/export' for more details. Icon 6: Select -------------- These three small adjacent symbols are used to select records. Left icon: [Alternate]+T ------------------------ A single click on this icon displays a 'Select by Class' pop-up menu. Select the desired class to highlight matching entries in the address list. Middle icon: [Control]+[Shift]+T ---------------------------------- A single click on this icon displays a 'Select by Status' pop-up menu. Select the desired status to highlight matching entries in the address list. A double click on the symbol opens a dialog where the status labels can be configured. Right icon: [Alternate]+U ------------------------- De-selects all records in the list. Icon 7: Dial number [Alternate]+W --------------------------------- Select this icon to display a popup from which any active telephone numbers can be selected and dialled without opening the 'Edit' window. Icon 8: Sort list [Alternate]+[Shift]+S --------------------------------------- Select the folders icon to display the sort dialog which offers the following options: Sort by: Up to three search criteria can be activated and a sort proceeds as follows: The list is sorted according to the first selected field. If more than one record is found these records are sorted again using the second selected field. If there are still more than one matching record these records are sorted a final time using the third selected field. Forwards (increasing): Records are sorted in alphabetical order. Backwards (decreasing): Records are sorted in reverse alphabetical order. Birthday, omit year: Select this option to sort birthdays without taking into account peoples ages. De-select this option if you want to take the year of birth into account during a sort. Icon 9: Print [Control]+P ------------------------- Output an address list. A dialog box appears offering the following options: Print: If no records are highlighted the entire address list is output. File: If no records are highlighted the entire address list is saved. The file selector appears ready to enter the desired filename. Abort/Cancel: Output is cancelled and the address list dialog is topped. Address uses 1st-Word compatible printer drivers which provides access to a wide range of printer drivers, refer to on-line help for more details. Icon 10: Wastebasket [Control]+D -------------------------------- This icon is used to delete any highlighted records. Unless 'Warnings' is de-selected in the 'Configuration' dialog, a dialog appears offering a last chance to change your mind. Find ---- This area is used to isolate a specific group of records. Select a field in the pop-up menu to search a specific field or select the 'All fields' option for a wider search. Often typing the first few characters you think are in the record you're searching for will be enough to isolate the desired record and highlight it ready for selection. In word: If this option is de-selected ADDRESS only tries to match the search string from the start of each record (NOT each word). De-select this option to search for matches inside each record. The buttons along the bottom of the window have the following meaning: Next: The next record containing a matching string is searched for and highlighted if found. All: All matching records are highlighted. OK: Select this option to open the address editor and display the first highlighted record. Abort: The ADDRESS list window is closed. Drag&drop support ----------------- Internal options: In the address list records can be drag & dropped onto the 'Edit' window and other icons. General options: Under a multitasking Operating System addresses can be dragged from the address list onto windows of other applications, which support this feature. ========================================================================== ADDRESS editor window -------------------------------------------------------------------------- The Icons down the left hand side have the following meanings, from top to bottom: Icon 1: To address list [Control]+N ----------------------------------- The displayed record is merged/sorted into the address list. Icon 2: Address list [Control]+A -------------------------------- The address list window is topped. Icon 3: Search using mask [Control]+F ------------------------------------- Searches for matching data in other records. Click on 'New' to open an empty record and fill in any fields you wish to search for then click on the icon. ADDRESS uses the record as a search mask and displays the first record which matches the fields you entered. Continue clicking to display other matching records, if any. To re-display the mask for another try or to delete it hold down the [Alternate] key and select the icon. Icon 4: Duplicate record [Alternate]+C -------------------------------------- Duplicates the current record which appears in the 'List' window. Icon 5: Dialler [Alternate]+W ----------------------------- Dials the selected telephone number in the current record via the serial port and attached modem. Icon 6: Clipboard [Alternate]+K ------------------------------- Selecting this icon copies the current record to the Clipboard Address supports the Atari Clipboard. If no clipboard exists one will be created on drive 'A' if running from floppy or partition 'C' if running from hard disk. Icon 7: Print [Control]+P ------------------------- Outputs the current record using the current export format. It's a good idea to check the output before committing to hard copy using the 'Report' option. Icon 8: Wastebasket [Control]+D ------------------------------- Delete the displayed record. Unless 'Warnings' is active in the 'Configuration' dialog, a dialog appears offering a last chance to change your mind. File import/export ------------------ Using this powerful option nearly any ASCII format data file from another application can be processed for use in ADDRESS and ADDRESS can export its address list data in any format for use by other applications. Examples: 1) Conversion of existing name and address databases for use in ADDRESS. 2) Export of address list data to generate form letters. 3) Preparation of a group file for QFax other similar application. The import/export format from ADDRESS can also be accessed via an XAcc link and via the GEM Clipboard. Some examples are contained in the 'Formats' folder. For more details refer to the on-line help available to registered users. XAcc windows ------------ The XAcc protocol offers a convienient method of exchanging data between Accessories and programs. ADDRESS can send to any program, which supports the XAcc protocol, addresses which are then inserted by the program into the text. COMPO's That's Write, for example, supports the XAcc protocol. For more details refer to the on-line help available to registered users. Printer support ---------------- In this dialog a 1st Word compatible printer driver can be loaded. On-line Help ------------ ADDRESS now supports ST-Guide format hypertext online help ========================================================================== Programming details for ADDRESS -------------------------------------------------------------------------- ADDRESS was compiled using Pure C, which was prepared using the Interface Resource construction set and bound directly into the program. The Alerts and pop-up menu code originate from Olaf Meisiek's Mydials. The colour icons are also created using Interface. For the monochrome version I used C_RSC by Holger Weets, this program (in contrast to Interface!) generates optimised Sorce code which means that icons used more than once are only contained once not once for each usage! Particular thanks go: -------------------------------------------------------------------------- Harald Sommerfeldt: Who always seems able to correctly answer any programming problems I encountered. Peter West: For the initial English translation of the ADDRESS executable. Richard Evans: Creation of English hypertext in ST-Guide format from Joe's manual. Mick Lock: Adaption of English hypetext to colour and maintainence of the current version. Joe Connor: For the manual translation, assistance fine-tuning the English version and running the UK support scheme. Finally I wish everyone success using ADDRESS! Carsten Setje-Eilers -------------------------------------------------------------------------- EOF