============================================================================

                  ADDRESS Atari ST Review Special edition

       An easy to use GEM based Address manager for all Atari models

                            Version   1.8e
                            22nd July 1994


                  Programmed by Carsten Setje-Eilers

============================================================================

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, 
electronic, mechanical, magnetic, optical, chemical, manual or otherwise 
without 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 and 1994 Carsten Setje-Eilers, all rights reserved
+ English translation and adaptation by Joe Connor
  Copyright 1994 Joe Connor, all rights reserved

This version of ADDRESS is exclusive to Atari ST Review
-------------------------------------------------------
This means you may test ADDRESS before you buy the to decide whether it 
meets your needs. The only difference between this version and the 
registered version is the Shareware reminder screen on starting ADDRESS.
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
------------
This special edition of ADDRESS may only be distributed on the Cover disk 
of Atari ST Review. Copying and distibution of the Cover disk version is 
prohibited and a breach of copyright under International law.

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.

The Shareware fees, valid from 30.11.1993 until further notice, are:
13.00 for a key, personal users only
21.00 All commercial organisations.

Send Cheque or Postal Order to:

Joe Connor
65 Mill Road
Colchester
Essex
CO4 5LJ.

Joe can also be contacted by Email: jconnor@cix.compulink.co.uk

UK Update Service
-----------------
The latest English version of ADDRESS can be obtained from Joe Connor free 
of charge (unless the Shareware fee for ADDRESS has increased or the rights 
sold commercially) by sending a Stamped Addressed Envelope enclosing an 
unlabelled floppy disk.

============================================================================
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: Export/Import [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: [Alternate]+[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: 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 critieria. 
If more than one record matches the first criterea these records are sorted 
according to the second criteria. If there are still more than one matching 
record these records are sorted according to the third criteria.

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. Deselect this option if you want to take the 
year of birth into account during a sort.

Icon 8: 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 9: 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 quickly and efficiently locate a specific or group of 
records. Click on the pop-up menu to display the field list or click on the 
cyclic arrows to cycle through the fields. Using this pop-up menu the 
search can be restricted to an individual field or all fields using the 
'All fields' option.

If the 'All fields' option is selected the first record matching the search 
string as entered is automatically highlighted ready for selection. Usually 
entering the first few characters is enough to select the desired record.

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
-------------------------
For details refer to the on-line help available to registered users.

Icon 4: Print [Control]+p
-------------------------
The current record is output using the current export format.

Icon 5: Wastebasket [Control]+d
-------------------------------
Delete the displayed record. Unless 'Warnings' is de-selected in the 
'Configuration' dialog, a dialog appears offering a last chance to change 
your mind.

File import and 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, only available to registered users!

============================================================================
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.
Joe Connor, for his translation of this manual and assistance fine-tuning 
the English version and running the UK support scheme.

============================================================================
Finally I wish everyone success using ADDRESS!  Carsten Setje-Eilers
----------------------------------------------------------------------------
22nd July 1994