Family Tree
===========
	
A genealogical database

	By Ian and Mark Baker

	v2.20, 16 September 1995


Chapter 1 : Family Tree - Introduction
======================================

Family tree is a genealogy program (as if you could not tell from the 
name...) for the Atari ST. It uses the GEM graphical user interface, so 
is fairly easy to use.

My father and brother were both involved in tracing their family 
history. They wanted to transfer their data to the computer, but could 
not find a suitable program for the Atari ST. None of the programs in 
the public domain at the time were suitable. One of them, which 
otherwise seemed quite good, deliberately avoided using GEM. It even 
boasted that you would not need to use the mouse! It was very difficult 
to use, and you wonder why the author bought an ST and not a PC clone.

So this program was written. It uses GEM as much as possible, so should 
be easy to pick up. It should work with all operating system versions, 
including MultiTOS, use all available memory and the whole of the screen 
area (if you have Overscan, a TT or a large screen monitor).

The program will print details of the people you have entered and their 
family trees on any standard printer that you would use for word 
processing. It can also produce better presented printouts and family 
trees using GDOS if you have this installed. If you have read in 
magazines how difficult GDOS is and are a little bit apprehensive about 
this, don't be. Read Appendix A instead!

1.1 Installation

This is very simple. If you are using floppies it will work as it is 
distributed - but please make a backup rather than using the original. 
On a hard disc, create a folder for it (you can call it anything you 
like) and copy the program GEN.PRG and the resource files into it.

There are two resource files included. GEN_8X8.RSC is used on 
systems with an 8x8 screen font, such as ST medium res, and GEN.RSC 
on all others. It doesn't look quite as good, but will work on all current 
and future display modes because it does not rely on the text size. You 
do not have to rename the files as was necessary with earlier versions of 
Family Tree. It loads the appropriate one for you.

1.2 Online help

The on-line help requires the ST-Guide desk accessory to be active. This 
means that ST-GUIDE.ACC is included in the root directory of your boot 
disc. ST-Guide is described by its author, Holger Weets, as Fairware. If 
you make regular use of it you should send him a donation to ensure the 
continued development of the system.

In the UK, if you wish to send a donation, send stlg6 or more to

	Joe Connor, 65 Mill Road, Colchester, Essex  CO4 5LJ

Joe Connor is handling registration in the UK for a number of shareware 
programs.

Elsewhere, send donations to

	Holger Weets, Tangastrasse 45, 26121 Oldenburg, Germany

	email: Holger Weets@ol.maus.de

	Bank details:
		Landessparkasse zu Oldenburg
		KTO.(Account No): 023-182 041
		BLZ.(Sort code) : 280 501 00

Chapter 2 : Basic concepts - What you must know
===============================================

You must read and understand this chapter if you are to use Family Tree 
effectively. While it may seem intuitive, a few things are not quite so 
obvious, at least, not until you have been told!

First of all, when loading your family tree data, because the database 
consists of several files, you do not select a file in the file 
selector. Simply select the folder containing your data (which will have 
names like P0000010.GEN) and click OK. The exception is when you are 
starting a new database. The file name you type here will be used to 
create a new folder in which to store your data.

The other thing you must remember is that you do not type in, and the 
program does not store, the names of father, mother, spouses, children 
and siblings. Instead it stores a reference to them, which you enter by 
selecting them from a list. This means of course that these people must 
be in the database.

In fact it is simpler than this. All you have to do is couple people 
together and assign children to them by selecting from a list of people 
in the database. The program will then automatically fill in Mother, 
Father, Children and Sibling fields for you.

Obviously all this means less typing for you, less chance of mistakes, 
and people will not have different names in different places. But if you 
are used to most databases, or even a lot of other genealogy programs, 
this will take a bit of getting used to.

In the course of tracing a family tree you will normally be working back 
through time. This program is written with that in mind. Accordingly, it 
is more efficient to enter the members of later generations before 
earlier ones. An implication of this is that when you enter a person's 
data you assign children to them from the people already entered.

This program is not a commercial offering. We believe it to be 
reasonably robust and do not know of any faults which will cause it to 
crash. However, there is always a possibility of a bug which we have not 
yet found. For this reason it is essential that you keep a backup copy 
of your family tree data. We would recommend that if your tree is on a 
floppy you copy the entire disc by using a fast copying program, such as 
Fastcopy 3, or via a RAM disc. If your tree is on hard disc then copy 
the tree folder onto a floppy.

It is good practice to quit from the program when you finish, do not 
just switch off the computer. In this way you will be prompted to save 
your data if you have changed it since the last save.

You can call up help for the top window by pressing Help, selecting Top 
Window from the help menu or clicking on the help button in most 
dialogues. The contents or index of the help can also be accessed from 
the help menu.

Chapter 3 : File operations - Loading and Saving trees
======================================================

When the program starts you will be presented with an alert box. From 
here you can start a new tree, open an existing one, or press cancel to 
remove the alert and allow you to use the menu bar.

3.1 Starting a new tree

If you wish to keep your tree data on a floppy disc, format two discs, 
one ready for your backup. If you are going to keep your data on a hard 
disc format a floppy for the backup.

Use the mouse to drop down the File menu. Click on New tree. 
Alternatively you may press Ctrl-N. The file selector will come up 
initialised to drive A with the filename Treedata. If you click on OK 
the program will create a folder called Treedata on the floppy disc in 
drive A and your data files will be stored in that folder.

You may select other drives and folders, in which case you must type in 
a file name which the program will use as a folder name. Do not select 
any of the files within the folder. The program remembers the name you 
use and saves it as the default in future.

3.2 Saving a tree

After spending time entering data into the program you will clearly want 
to save it to disc. To do this, select Save from the File menu or press 
Ctrl-S. This will make sure all the information you have entered is on 
the disc.

This cannot be used for making backups of your data, since it only saves 
changes made since the last save.

3.2.1 Timed save

When you are entering or altering information in your tree you will be 
prompted at regular intervals by an alert box asking if you wish to save 
the changes you have made. Selecting Save saves to disc exactly as 
clicking on the menu item. If you select Ignore you will be prompted 
again after another time interval. It will not interrupt when you are 
working, but waits until you have left the keyboard or mouse button for 
a second. You will not be prompted if you have made no changes since 
loading or the last save.

The time interval can be altered from 1 to 99 minutes by selecting Set 
preferences from the Preferences menu. Simply select the Save time 
interval field and edit to the time you require. Then click on OK.

3.2.2 Save as

To save the tree as a different name select Save tree as from the File 
menu. This will bring up a file selector where you should select the 
folder you want. As for new tree, if you want a new folder to be created 
enter the name in the selection field. Save as loads in all the data and 
saves it in a different place. The program will need to read from the 
disc containing the original data and write to the one containing the 
new copy. If your data is on one floppy and you are copying onto another 
then one floppy must be in drive A:, the other in drive B:. The computer 
will prompt you to swap the discs as required if you only have one 
floppy disc drive.

This can be used for backups, although we would recommend using Fastcopy 3 
for floppies or just using the desktop for hard disc users as these 
would be much quicker.

3.3 Loading a tree

Selecting Load from the File menu, or pressing Ctrl-O, allows you to 
load in a tree. A file selector will appear, with the last used name 
selected. If you want to load this tree, just click on OK to load it, 
assuming you have the right disc in of course. But if you want to load a 
different tree then you will have to select the drive and select the 
folder before clicking on OK. Do not select any of the files within the 
folder.

3.4 Checking a tree

If you have problems running Family Tree with your data it may be as a 
result of your data becoming corrupted. This may have been caused by a 
computer crash or failure to save on a disc which was full.

To check for data inconsistencies, after first loading your tree select 
Check tree from the File menu. The data will then be checked to ensure 
that the indexes contain data which matches that in people's individual 
files and that parent/child and spouse/spouse relationships are 
consistent. This should be sufficient to ensure that the program will 
run correctly. It cannot check that your data is correct.

If the program finds errors in the data it will warn you, and advise you 
to use a backup copy of your data. If you do not have a backup it is 
possible to correct the data using a text editor and the information in 
Appendix C. The file error.gen will contain a list of the 
inconsistencies. Be sure to make a copy before attempting to correct the 
data in case mistakes make it worse. If you are unable to put things 
right and you particularly need your data restored, send a copy to us 
including return postage and we will attempt to restore the data to a 
state where you can re-enter any lost data using Family tree.

Chapter 4 : Entering People - Person Entry form
===============================================

In order to enter data for a new person click on New person in the 
Display menu or press Alt-N. You will then be presented with a window 
containing a form to fill in with personal details. When you have 
entered all the information you wish to, click on OK and you will be 
returned to the previous screen. If you click on Cancel the data entered 
will be discarded. If you display a tree or descendants whilst editing a 
person's information any changes will automatically be saved, so they 
cannot then be cancelled.

When entering a new person into the tree there is an additional button 
labelled Next. Clicking on this or pressing Alt-N, will store the data 
you have just entered and clear the Person Entry form ready for another 
person. The family name will be initialised to the name from the 
previous form. If this is wrong use the Esc key to clear the field.

If you wish to edit data for a previously entered person, see chapter 
below, Editing People.

4.1 The main Person Entry form

Use the keyboard to enter the names, place of birth, dates of birth, 
baptism and death and occupation. You can select these fields using the 
mouse, or cycle round them with the tab key or the up and down cursor 
keys. These are the only fields which allow direct data entry.

The fields showing parents, children, siblings and marriage details are 
filled in by the program and are for information only. They do enable 
you to move around the family tree though, see Moving Around in the 
Editing People chapter. See next section, Marriages, for use of the 
Spouse field. Note that half siblings are not displayed, you must read 
the parents records to find these.

Entry uses the standard Atari GEM routines, the Esc key clears the field 
completely, Delete removes the character after the cursor, Backspace the 
one before it and the left and right cursor keys move the cursor along 
the string of characters.

The names and place of birth can contain any characters you can type, 
but the dates have to be in the correct format. This is ddMmmyyyy where 
dd are two digits for the day in the month, Mmm are three letters for 
the month and yyyy four digits for the year. If the day is less than 10 
you may pad with a trailing space or a leading zero. The month must be 
the first three letters of the month. If you know the year but not the 
month or day you may space across the day and month. The program will 
treat this as the 0th day of the 0th month but will still be able to use 
the year in order to sort people by date of birth.

Where you do not know the exact date you may qualify what you enter as 
after, before or circa the entered date. When the date is unqualified 
there is a +-' before the date. Clicking on this will bring up a popup 
menu from which you can select the appropriate qualifier. Your choice 
will be shown as an +a', +b' or +c' before the date, both displayed and 
printed. You may change the qualifier by clicking on it again.

If you know which quarter of a year you may enter the day as 0x and the 
month as Qtr, where x is the quarter.

4.1.1 Sex

Immediately to the right of the family name there is a button with a +?' 
on it. Click on this to get a popup menu which allows you to choose male 
or female. The button will then show +m' or +f'. If you make a mistake 
and wish to change this you may simply click on the button again.

Alternatively you may press Alt-M or Alt-F to set male or female 
respectively. You cannot change the sex this way once set.

You must always set this up before attempting to enter marriage details. 
See Marriages below.

4.1.2 Source

Immediately to the left of the birth date there is a button with Birth 
on it. Click on this to get a form in which to enter the source of 
information concerning the birth, for example the number of the birth 
certificate or reference to parish records.

You may enter any characters you can type. If there is insufficient 
space for what you wish to write see Further Notes below.

You may wish to close this window to avoid cluttering the screen or 
because you have run out of windows, but otherwise you do not need to. 
Closing this window will not lose any of the information in it. There is 
no OK button on the form and the data on it is saved when that on the 
main person form is.

4.1.3 Baptism

Immediately to the left of the baptism date is a button labelled 
Baptism. Click on this to obtain a form on which you can enter the place 
of baptism and source of information concerning the baptism.

See the notes in the previous section about closing the window.

4.1.4 Death

Immediately to the left of the death date is a button labelled Death. 
Click on this to obtain a form on which you can enter details concerning 
the death of the person.

The standard Atari GEM routines are used for all the fields. In 
particular the names of witnesses, executors, the solicitor and 
beneficiaries are typed in from the keyboard, they are not people from 
the family tree. Of course one of these people may be included in your 
family tree, but the program will not recognise the connection. The date 
must be in standard format.

The various fields concerning the will may not often be used but the 
information can help if you are having difficulties tracing ancestors.

See the notes about closing the window in section 4.1.2

4.2 Further Notes

Clicking on Further Notes brings up an empty window entitled "Further 
notes for" followed by the person's name. You may now enter any notes 
concerning the person using the keyboard. This is a very simple editor, 
not a word processor, and is intended for short notes only. If you wish 
to write their life history use First Word Plus or another word 
processor.

Text word wraps automatically as you type so only use Return between 
paragraphs. The Backspace, Delete, Cursor keys and mouse all act 
conventionally. The vertical scroll bar allows you to move up and down 
through the text. Horizontal scrolling is not used as the text is always 
adjusted to fit the window.

The window may be moved or resized as a normal GEM window. It may be 
closed by clicking on the close box at the top left corner of the 
window. If the window is moved or resized so as to show the person form 
underneath it you may move between the person form and the Further Notes 
window simply by mouse clicking. The window is closed when you select OK 
or Cancel on the person form. If you move or resize the window this will 
be remembered until you quit from the program, so opening Further Notes 
on another person will give you a window as and where you have chosen.

You may wish to close this window to avoid cluttering the screen or 
because you have run out of windows, but otherwise you do not need to. 
Closing this window will not lose any of the information in it. The data 
in it is saved when that on the main person form is.

4.2.1 Text size

You may select one of three sizes of system font for the display of the 
further notes. The larger fonts are easier to read, especially if you 
are using a television as a monitor, but smaller fonts will allow more 
of the text to be displayed.To alter the size used select Set 
preferences from the Preferences menu. Then click on the required size. 
Select OK to exit.

4.2.2 Block operations

You can mark a block by dragging with the mouse or using the menu 
commands Block Start and Block End from the Edit menu, or using Ctrl-B 
and Ctrl-E. Moving the cursor or entering any text unmarks the block.

Selecting Delete from the Edit menu or pressing Delete will delete the 
marked block. Selecting Copy from the Edit menu or pressing Ctrl-C 
copies the selected text to the clipboard. Selecting Cut from the Edit 
menu or pressing Ctrl-X is equivalent to copying and then deleting. Cut 
and copy will work even if there is no block selected, in which case 
they will copy all the text. To paste text in from the clipboard select 
Paste from the Edit menu or press Ctrl-V, this inserts the text at the 
cursor position.

These functions use the standard GEM clipboard. Because this is disc 
based it is slower than using a buffer in RAM, but allows you to cut and 
paste between different applications. If it is too slow, using a RAM 
disc will speed it up a bit.

4.3 Flags

If you click on the Flags button you will be presented with a form to 
fill in. It consists of eight short lines of text adjacent to each of 
which are three buttons, Yes, No and Not set. Initially the lines of 
text will be blank. They cannot be edited here. To edit them select Name 
flags from the Preferences menu, see Set preferences later in the 
manual.

These are provided to allow you to store simple information of your 
choice. For example you may wish to mark those people who are directly 
related to you, not just by marriage. In this case you would set one of 
the lines of text to say Direct Relative. Then for each person who was 
related you would click on Yes adjacent to that line of text. For other 
people you would click on No. New people will have all their flags 
initialised to Not set.

These flags can be useful when selecting people from the database, see 
the Person selector below.

4.4 Marriages

Marriages are used to cover any form of relationship which might produce 
children. The fields are there to record wedding details but the concept 
of legitimacy has no place in this program.

To enter details of a marriage you must first get to the main Person 
Entry form for one of the two people involved. If you then click on the 
Spouse field you will be presented with a window containing the Marriage 
form. If you click on an existing spouse you may update details of an 
existing marriage.

The top two spaces on the left of the form are for the couple, the man 
at the top. The person whose data you were entering will have been 
entered in the appropriate space. If you click on the other space you 
will be presented with the Person Selector form, see below for details. 
The person you choose will be entered as the spouse.

Within the marriage form the date and place of wedding are handled as 
dates and text on the Person Entry form. When you have completed the 
form click on OK to store the data and return to the Person Entry form, 
where you will see the Spouse and Children fields updated. Click on 
Cancel if you wish to discard the information you have entered. If you 
display a tree or descendants whilst editing a couple's information any 
changes will automatically be saved, so they cannot then be cancelled.

If you click on Delete you may remove a marriage completely providing 
that there are no children. If there are any you will be asked to remove 
them first.

4.4.1 Adding children

The Marriage form allows space for ten children. When it is full you may 
use the scroll bar to move down through the listed children. There is a 
maximum of forty children. If this is ever insufficient write to me to 
complain and I will allow for more.

To enter a child click on one of the empty spaces. You will then be 
presented with the Person Selector form. If the father's family name has 
been entered the Person Selector will already have this entered, on the 
assumption that children are normally named after their father. The 
people with that family name will be automatically listed. If this is 
not the case you can clear or change that field.

The selected child will appear in the list in the space on which you 
clicked. If you return to this screen later the children will have been 
sorted into order of birth date so you can enter them at random.

If you click on a child who has already been entered you will be given 
the opportunity of removing them from the list.

4.4.2 Divorce

Divorce has no significance to the tree program but this allows you to 
record details of any divorces. Click on the Divorce button and you will 
be presented with the Divorce form with space for date and source of 
information.

You may wish to close this window to avoid cluttering the screen or 
because you have run out of windows, but otherwise you do not need to. 
Closing this window will not lose any of the information in it. There is 
no OK button on the form and the data on it is saved when that on the 
couple form is.

4.4.3 Multiple Spouses

If a person is already married then the right arrow button to the right 
of the date of marriage in the Person Entry form will be enabled. Click 
on this and the previous spouse will disappear leaving the field blank. 
You may now click on this to enable entering of a second marriage. This 
may be repeated to a maximum of twenty spouses.

4.5 Person selector

The person selector appears when you have to select a person to edit, 
children or a spouse for a marriage, or a person or people to print.

When it comes up there is a normally empty list box in the middle. At 
the top are editable text fields for forename, family name, place of 
birth and before and after for the date of birth. There is also a button 
labelled Flags.

These can be set up as a filter so there are less names to choose from. 
When any information required is entered, pressing the List button 
lists, in the scrollable box, all people who match these filters. For 
example if the family name is set to "Smith" then all people with the 
surname Smith will be listed.

You may select autolisting, in which case the scroll box will be filled 
as soon as you enter the person selector without waiting for you to 
press List. This is convenient for small trees but could slow down 
operations where there are many people in the tree. Select Set 
preferences from the Preferences menu and click on the Auto list 
selection box to select or deselect this.

You may also select the re-use of the family name, so that when you 
enter the person selector the family name is already initialised to the 
last used name. Select Set preferences from the Preferences menu and 
click on the Re-use family name box to select or deselect this.

You may enter multiple forenames in the person selector and only people 
whose names match all those entered will be listed. If you only enter 
one forename then anyone with that name first will be listed. You may 
include numbers in forenames, e.g. "Mary(1)" or "Jane(2)", where more 
than one child had the same name. If you enter "Mary" in the person 
selector all Mary's will be listed, but "Mary(1)" will only list those 
with a "(1)" after their name.

The logic for this allows any character to be used, not just numbers and 
brackets. If the name entered in the person selector only includes 
letters then the matching will ignore other characters. If it includes 
other characters then full matching will occur. For this purpose "'" and 
"-" are treated as letters.

The only characters which cannot be used are "*" and "?", because these 
are used as wildcards. The question mark matches any one character, and 
the asterisk matches zero or more arbitrary characters. For example 
"a*d?" will match all names that start with an "a", then have any number 
of other letters, and end in "d" then some other character.

Selecting someone highlights them and their reference number appears in 
the reference field of the form. Clicking on OK or pressing return exits 
the person selector with that person selected. As a short cut you can 
also double click on someone, as in the file selector, to exit with them 
selected.

Normally, if the names, dates and place of birth do not uniquely define 
a person, and you have not selected a person, clicking on OK will cause 
an error message, and then list the matching people. However, when 
printing people or a partial index, see chapter 8, it will cause all 
matching people to be printed.

4.5.1 Dates

There are two fields for date of birth, before and after. If only one 
date is entered then people with no date of birth will be included in 
the list as well as those whose date meets the requirements.

4.5.2 Place of birth

For the place of birth, the text entered is split into separate words, 
up to a maximum of four words. The words can be separated by spaces or 
commas. Only people are listed whose place of birth includes all the 
words entered, but the order of words does not matter. The case of the 
letters is ignored. For example, if you enter "epsom hospital" you will 
list people born in "Surrey, Epsom District Hospital", "District 
hospital, Epsom" and so on, but not people simply born in "Epsom". 

Unlike names and date of birth, the place of birth is not kept in 
memory. This means that the information may have to be loaded off disc. 
If you use this field only every person will be loaded off disc, which 
may take a long time. If you enter data into any of the other fields 
this will be checked first to avoid unnecessary disc accesses.

4.5.3 Flags

If you click on the Flags button you will be presented with a form 
containing the eight flag lines of text. For each flag you can select 
Yes, No or Ignore. If you select Yes or No only those people who have 
the corresponding flags set accordingly will be listed. As flag data is 
stored with the index it will not slow down listing. Therefore if you 
will often wish to select only people born in a particular place it is 
better to use a flag to mark them as born in that place.

Each time you use the Person selector the flags will all have been 
initialised to Ignore.

4.5.4 Extra information

If there is more than one person with the same name it can be difficult 
to decide which to select. If you click on the Details button when 
someone is highlighted a form will appear giving more information on 
them. The baptism and death dates, occupation and the mother and 
father's names can be seen as well as all the information displayed in 
the person selector normally. Clicking on OK will select the person, 
clicking on Reselect will return you to the person selector to choose 
someone else.

Chapter 5 : Editing People - changes and relationships
======================================================

In order to edit data for a person already in the tree click on Edit 
Person in the Display menu, or press Alt-E. You will then be presented 
with the Person Selector, see section 4.4. Having selected the person 
you will then be presented with the Person Entry form complete with your 
previous entries.

5.1 Moving around

On the Person Entry form are fields for the spouse and the parents, and 
scrolling lists of children and siblings - note that this does not 
include half-siblings. You may go and look at these people by double 
clicking on the appropriate field. Single clicking on the spouse brings 
up the marriage for editing, whereas double clicking brings up the 
spouse's person form.

If the birth, baptism, death, or further notes windows are open, they 
will be updated to show the person you change to. On a large screen, you 
can leave them all open to show all the information at once.

5.1.1 The job list

If you select Edit Person from the menu again when you are in the middle 
of editing someone it lets you look at them, and/or edit them, but it 
remembers where you were and will return when you click on OK or 
Cancel.

The program stores a list of people you are editing, so you can go 
through a series of people in this way, and come back through them, but 
the number of people you can go down through, though high, is finite,

Closing the window clears the list, providing a short cut out if you 
have selected many people from the menu. This is the only way in which 
it differs from clicking on OK.

5.2 Editing Marriages

The arrows either side of the wedding date select which marriage is 
displayed if there are several. Where the marriages are dated they will 
be sorted so that clicking on the right arrow moves to later marriages, 
the left arrow to earlier ones. There will always be a blank space if 
you continue going right, this is for adding a new marriage. The list of 
children is changed when you do this, since it only shows the children 
from a particular marriage.

There is a Delete button on the marriage form, which deletes the 
marriage, that is, it makes the program forget about the marriage 
details. All children must be removed from the marriage first by 
clicking on them and selecting OK.

It does not free the reference number, so if you do this a lot you will 
have a lot of unused, unusable gaps. These will slow it down slightly, 
but it is storing of strings such as names and places which take up 
space so deleted couples do not make the files significantly larger.

5.3 Deleting people

People can also be deleted. On the person entry form is a Delete button. 
Clicking on this will bring up an alert box asking if you are sure you 
want to delete the person. You cannot delete people who are related to 
others, so remove them from their parents list of children and remove 
any marriages they have first. This should not be too much of a 
restriction since normally people to be deleted are those entered by 
mistake.

The comments about deleting couples above apply here also: the reference 
number is not freed, but it still does not use too much disc storage to 
have deleted people in the tree. It is possible to re-use a number by 
selecting Edit person and entering the number in the Reference number 
field, but normally the potential confusion would make this unwise.

Chapter 6 : Tree Display - Ancestors

If you click on Tree on the Display menu you will be presented with the 
Person Selector. When you select a person a window will open to display 
that person on the left with a number of generations of their parents 
spreading out across the page. Each person will be displayed complete 
with their dates of birth and death. The number of generations displayed 
depends on the window size and the font size.

6.1 Editing a person on a tree

If you wish to edit any person on the tree double click on their name 
and you will be presented with the main Person Entry form for them. The 
tree window will remain open.

6.2 Moving around the tree

In order to move back through further generations you may click on any 
person in the tree. They will then move to the left side of the window 
with their ancestors spread out across the window. You may repeat this 
indefinitely until you run out of ancestors.

6.2.1 Back arrows

Once you click on anyone in the tree, other than the original person, a 
set of <<< will appear at the bottom left of the window. If you click on 
this you will move back a generation, i.e. forward in time. You may 
repeat this until you get back to the original person, when the <<< will 
disappear.

6.3 Tree text size

You may select one of three sizes of system font for the display of the 
tree. The larger fonts are easier to read, especially if you are using a 
television as a monitor, but the smaller fonts will normally allow an 
extra generation, depending on the window size. To alter the size used 
select Set preferences from the Preferences menu. Then click on the 
required size. Select OK to exit.

If you are displaying a tree it will be redrawn at the new size. This 
option also affects descendants.

6.4 Extended forenames

The program normally fetches people's names from the index, and limits 
them to 32 characters. If you wish to include complete names, select Set 
preferences from the Preferences menu and click on the tick box for 
Longer names.

6.5 Copy to clipboard

Selecting Copy from the Edit menu will copy the tree to the system 
clipboard for pasting into other programs. It is saved as a bitmap and 
as a metafile.

Chapter 7 : Displaying Descendants
==================================

If you click on Descendants in the Display menu you will be presented 
with the Person Selector. When you select a person a window will open 
showing that person at the top and their descendants below them as 
follows.

Each spouse of the person selected is printed slightly indented with an 
equals sign to indicate a marriage, and their children are printed 
beneath them, indented and with lines drawn to show how they are 
related. Underneath each child are the child's spouses and children and 
so on. This sounds confusing, so the best way to find out what it is 
like is to try using it!

If there are too many people to fit in the window it can be scrolled 
vertically in the usual way. The number of generations will be limited 
to a number that will fit on the screen horizontally.

7.1 Editing a person in the descendants list

If you wish to edit any person in the descendants list double click on 
their name and you will be presented with the main Person Entry form for 
them. The descendants window will remain open.

7.2 Text size

You may select one of three sizes of system font for the display of the 
descendants. The larger fonts are easier to read, especially if you are 
using a television as a monitor, but smaller fonts will allow more 
people to be shown. To alter the size used select Set preferences from 
the Preferences menu. Then click on the required size. Select OK to 
exit.

If you are displaying a tree or descendants they will be redrawn at the 
new size.

7.3 Including date of death

Each person is listed with their date of birth, if known. If you wish 
the program will also append their date of death. To select or deselect 
this option select Set preferences from the Preferences menu, then click 
on the tick box for Descendant's death date. Including the death date 
will reduce the number of generations that can be fitted within the 
width of the screen.

7.4 Extended forenames

The program normally fetches people's names from the index, and limits 
them to 32 characters. If you wish to include complete names, select Set 
preferences from the Preferences menu and click on the tick box for 
Longer names.

7.5 Copy to clipboard

Selecting Copy from the Edit menu will copy the descendants to the 
system clipboard for pasting into other programs. It is saved as a 
bitmap and as a metafile.

Chapter 8 : Custom trees - for presentation
===========================================

This chapter has to start with a warning. Custom trees are only 
available with GDOS installed. They will work with any version of GDOS 
but are best with SpeedoGDOS.

The previous displays have been automatically formatted by the program, 
and have attempted to make efficient use of the screen area without 
considering the presentation. Custom trees allow the user to control the 
display, and also to select which people are to be displayed. People can 
be moved anywhere around a virtual page in excess of 60m by 60m. Links 
between families are automatically maintained when the people are moved. 
The fonts used can be selected overall for the tree and individually for 
each person. The Custom tree is drawn within a standard resizeable GEM 
window, and can be scaled and scrolled to allow viewing of trees much 
larger than the screen display area.

As in the other windows, double clicking on anyone will bring up their 
Person form.

The tree may be printed on one or more pages, see Printing people, 
Custom trees.

The custom tree is only a way of displaying the data already stored. 
Before `drawing' it you must first enter your data into your family 
tree.

8.1 Starting the tree

To start a new custom tree select New... from the Custom menu. The 
Person selector will appear allowing you to choose the first person in 
your Custom tree. Choose anyone whom you wish to be included. It does 
not matter who you choose as the first person except that the window in 
which the tree is drawn will be titled with their name.

The program will then open a full screen window with that person shown 
at the top left hand corner. Their name will be surrounded by a box 
drawn in dashed lines. If their parents are included in the tree there 
will be a small box drawn at the centre of the top of the box. If they 
are coupled there will be small boxes drawn half way up each side of the 
box.

This is the best time to set up the default attributes of the tree, 
which include the font used, whether dates are included and so on. 
However, if this is the first time you have used this feature it is 
probably worth experimenting with drawing the tree and trying out the 
different settings before deciding what defaults you want.

8.2 Opening and saving trees

Select Open... from the Custom menu to load a custom tree from disc. It 
is important that the tree is based on the data you have loaded. If you 
load a tree generated for a different family the program will not work.

Your Custom tree may be saved to disc by selecting Save or Save as... 
from the Custom menu. Save will copy your data over the old data if you 
are working on a tree which you loaded from disc. If you are working on 
a new tree, or select Save as... instead, you will be prompted for a 
file name.

8.3 Growing the tree

The tree grows in two ways. When a person is selected a box is drawn 
round. If the tree data includes their parents, but they have not yet 
been drawn, there will be a small box in the centre of the top of the 
box. Clicking on this box will cause their parents to be added to the 
tree above them and their siblings to be added alongside them, all 
linked by lines representing the relationships. Although the program 
will lay them out neatly relative to the original person, they may all 
be drawn over the top of other people already part of the Custom tree. 
For this reason they will all be selected ready for convenient movement 
to an open space.

The second way of growing applies to people who are married, but whose 
marriage has not yet been drawn. When selected they will have small 
boxes at each side of the selection box. Clicking on either of these 
will cause their spouse to be drawn on the corresponding side of them, 
linked with an +=', and any children will be added below. As before, all 
the newly added people will be selected ready for moving.

8.4 Selecting people

As has been said above, when people are first added to the Custom tree 
they are selected ready for further operations. However, normally, if 
you wish to perform any operations on them you will have to select them 
first.

To select a single person, simply click on them with the mouse. To 
select further people without deselecting those already selected, hold 
down the Shift button whilst clicking. A selected person can be 
deselected by the same method.

If you move the mouse to an empty part of the window, hold down the left 
mouse button and drag the mouse across the window you will draw an 
expanding box on the screen. When you release the mouse all people fully 
within the box will be selected.

Where a number of people are overlapping, repeated clicking with the 
mouse will select them in turn.

8.5 Moving people

When people are added to the tree the program attempts to place them in 
a sensible group including the person from whom they have +grown'. 
However, once the tree extends beyond a few people this will almost 
certainly not be the best arrangement and you will want to move them. In 
order to move a person or group of people first select those people you 
wish to move. Then pick up the group by positioning the mouse pointer 
over one of them and holding down the left mouse button. You may then 
move them with the mouse to the desired position. Releasing the left 
mouse button will place them, but leave them selected in case you wish 
to make further movements. The program does not allow automatic 
scrolling so if you wish to move them large distances you may prefer to 
scale the display first. Scaling is described below.

8.6 Moving lines

When people are moved the various lines connecting them to their 
relations are automatically adjusted to maintain the relationships. 
However, on a crowded tree this may easily result in lines crossing over 
other people or overlapping each other.

Where a line already consists of a number of segments the mouse may be 
used to pick up and move one of the central segments. The end segment 
can only be moved by moving the person to whom it is attached. If a line 
is under a person's name and mouse clicking selects the person, not the 
line, holding down the Alternate key whilst using the mouse will allow 
the line to be selected.

In order to add segments to a line, double click on the line. In 
general, double clicking near the centre of a segment will split the 
segment into three parts, the central one of which will be moved out of 
line with the other two. Double clicking near a corner will cause that 
corner to be inverted.

8.7 Setting attributes

Select Attributes... from the Custom menu in order to control the 
appearance of the tree. You will then be presented with a dialogue box 
containing the options described below.

8.7.1 Default and individual attributes

If you select people within the tree before selecting Attributes... you 
can then set up their individual font, name and date display and so on. 
If you do not select anyone first any settings will apply as defaults 
and determine the display of those people who have no individual 
settings.

Some attributes are only appropriate for individuals, such as being 
+hidden'; others such as automatic spacing only make sense as defaults. 
For this reason the dialogue box will look different depending on 
whether you have made a selection first.

8.7.2 Font

Clicking on the Font... button will bring up the Font selector dialogue 
box. There are no restrictions on the font chosen, nor on the number of 
different fonts used within the tree (except for good taste). Changing 
the font size will probably mean that you will have to adjust the 
spacing between people. It is therefore wise to choose your fonts when 
you first start.

8.7.3 Name and date display

There are a number of different options for the name and date display. 
The number of forenames can be restricted to one, or the total length of 
the name limited which will result in a reduction of the number of 
forenames displayed in order to keep the total name below a set limit. 
This may be done to save space.

The family name may be omitted or included, or more usefully normally 
set to Automatic. When set to Automatic the family name is omitted if 
the person's father is included in the tree. This is based on the 
assumption that they will have the same family name as their father and 
their name can be read from his entry, or his father's and so on. This 
works well on a normal English tree, or perhaps a Scandinavian one where 
the last name is based on the father's forename, but should be turned 
off for different cultures. Where the tree mostly conforms to the 
assumption of naming after the father the default can be set to 
Automatic and any exceptions can be set individually to include the 
family name.

The dates of birth and death can be individually included in the tree as 
required. They will be drawn below the name if included.

8.7.4 Hidden

People are added in complete families as it is assumed that this will 
normally be required. Once added they cannot be removed, but they can be 
hidden. Whilst hidden they will not be selected by clicking or rubber 
banding, so will not be moved. However, the program keeps track of them 
and if they are unhidden later they will still be connected to their 
relations.

This option is not available as a default as a totally hidden tree would 
seem pointless.

8.7.5 Spacing

When adding people to the Custom tree they are automatically spaced at 
set distances. These can be adjusted within the attributes dialogue box. 
They are not available if anyone is selected as they are meaningless for 
an individual.

The three spacings are Generation spacing which controls the vertical 
distance between children and their parents, Couple spacing which 
controls the distance between a marriage partner and the +=' sign and 
Sibling spacing which controls the horizontal spacing between siblings.

The Couple spacing is also applied when a married person is moved. If 
they are not moved to the current Couple spacing from the +=' they will 
be joined to it by a line. However, changing the couple spacing will not 
affect people who are already drawn until they are moved.

8.7.6 Default attributes

When people are added they are drawn using the default attributes. Any 
change to the default font or the names and date drawn will affect them. 
However, once an attribute is set for them individually they will no 
longer be affected. If you wish to cancel their settings and let them 
revert to the defaults, select the Clear attributes button.

8.8 Reverse couple

Select Reverse couple from the Custom menu to left/right swap any 
selected couples. This is best done to couples whose parents are not yet 
drawn as this will minimise the scrambling of relation lines.

8.9 Update Children

If children are added to marriages after the marriages have been added 
to the custom tree they will not appear. To add them, select both 
partners of the marriage, or the only parent, and select Update children 
from the Custom menu. Any additional children will be added below the 
+='. They will then need manually positioning.

8.10 Show hidden

Show hidden is an entry on the Custom menu. A tick next to the entry 
indicates that hidden people will be shown. This allows them to be 
selected and possibly unhidden. Clicking on Show hidden will enable it 
if it is disabled, and vice versa.

8.11 Show pages

If Show pages is enabled the Custom tree will be drawn with a background 
grid showing where the page breaks will be in a multi-page printout. The 
lines correspond to the page size set in Printer configuration. This is 
intended to allow you to position people so that their names are not 
split across page breaks. This will only work if a GDOS printer is 
selected.

8.12 Scaling or zooming

The tree is initially drawn at nominally real size. (On the Atari the 
medium or high res screens are assumed to be 178mm across by 111mm 
high.)

The screen display may be resized by selecting Scaling from the Custom 
menu. You will be presented with a range of scalings from 10% to 400%. 
These do not affect the printout.

Alternatively, the scaling can be changed from the keyboard. Holding 
down the Control key and pressing the ++' key (on the numeric pad) will 
increase the scaling, the +-' key will reduce it. This has the advantage 
that the display will expand or shrink around the mouse pointer, making 
it easy to choose which portion of the display you zoom into.

Chapter 9 : Printing People - a crash-proof record
==================================================

A printed output is easier to carry around in the field, and can be sent 
to anyone who is interested in your tree but lacks an Atari on which to 
view it at its best.

As a programming exercise the display of the complete family tree on 
half an acre of paper has a lot to recommend it. However, with only a 
standard printer on which to output there is a limit to what can be 
done. The display of ancestors has the advantage that nobody has more 
than two parents, whereas some people have dozens of children. You may 
therefore print out as many ancestors as will fit on a sheet of your 
paper, up to a limit of six generations. Descendants are printed in a 
fairly uninteresting way. An index of people can be printed in a totally 
uninteresting way.

If GDOS is installed a Custom tree can be drawn and printed. This will 
produce an excellent presentation if care is taken on its layout.

9.1 People

Click on Person from the Print menu or press Ctrl-P. If you are editing 
a person they will be printed, otherwise the person selector will appear 
for you to select someone. However, this is used slightly differently 
from normal. If you click on OK when you have not selected anyone, it 
will print all those which fit the specifications you have entered at 
the top of the form. An alert box will appear to give you the chance to 
change your mind, since pressing OK could otherwise mean a very long 
wait as it printed hundreds of people!

For each person, their name and reference number are printed in the top 
right of the sheet of paper. Below this is all the information about the 
person, including information about each marriage in turn. It is laid 
out so that it is obvious which things are related to each other, shown 
by the indentation.

For example, Died appears at the left of the page with the date of 
death. Other details of the death are then indented, Place of death, 
Source of information and Will. Details of the will are further indented 
below it.

Died    6Mar2050
  Place of Death  Not yet known
  Source of information The Delphic Oracle
  Will   6Mar2000
    Witness  Bill Bloggs
    Witness  And his mate
    Executor  John Major
    Executor  Tony Blair
    Beneficiaries The world

All the names of people are listed as forenames and surname. The 
forenames are limited to a maximum of twenty characters. These will be 
followed by the index or reference number if the Index number option 
is selected. See Set preferences, Chapter 11, for setting this option.

9.1.1 Siblings

After the Mother and Father are the siblings, the word Siblings being 
printed indented. As on the Person Entry form, this does not include 
half siblings.

9.1.2 Spouses

For each spouse there is first the name, then all wedding information is 
printed indented. The divorce date is printed and all divorce 
information underneath this, further indented.

Children also are listed under each spouse for which there are any. This 
makes it easy to see from which marriage any children come.

9.1.3 Further Notes

At the bottom of the page are the further notes. They are printed to 
almost the full width (there is a margin of roughly an inch using GDOS), 
and are word wrapped. On GDOS printers they are justified, otherwise 
they are ragged right.

9.2 Index

You can also print a simple list of people with their name, date of 
birth and reference number. This lets you quickly see who you have in 
your database. To do this, you select Index from the Print menu or press 
Alt-I. An alert box appears asking whether you want a complete index or 
just a selection.

9.2.1 Printing a complete index

If you select a print of the complete index the program will print the 
names in reference number order. In order to allow partial printing, for 
example in order to print the last page after adding a few new people at 
the end of the list, a dialogue box pops up allowing you to choose the 
range of reference numbers you wish to print. The start and end values 
are preset to the first and last people in the tree, so just selecting 
OK, or pressing return, will give a complete printout.

9.2.2 Printing a selection

If Selection is pressed from the alert box, the person selector appears. 
You can select a person and click on OK as normal, but there is little 
point in printing a list of one person! If OK is selected without 
selecting anyone, all those people included by the filters at the top 
will be included in the index, in a similar way to selecting multiple 
people to print. Probably the most common use for printing a selection 
of the database is to print only one family, by setting the surname 
field. You might also wish to print a list of people for whom a 
particular flag was set.

If you leave the filters blank, thereby selecting everyone, you can 
print a complete index sorted in alphabetical order instead of reference 
number order.

9.3 Trees of ascendants

The program will display a tree showing all a person's ascendants. The 
person is printed at the middle left of the page, with their parents 
above and below them and further right, and their parents above and 
below each of them and even further right. This is the same as the 
screen display.

The number of generations displayed depends on the page length set for 
your printer and, with GDOS, on the font size selected. Note that height 
is normally the main restriction on the number of generations; the width 
is considered when calculating the indentation to use. If a very narrow 
page or, with GDOS, a very wide font, is used, it will be squashed up 
and look unattractive.

To print a tree, Tree on the Print menu should be selected, or press 
Alt-T. If you are currently viewing someone's tree in the top window on 
screen, it will start printing a tree with them as the root. Otherwise 
the person selector appears for you to select the person to be the root 
of the tree.

9.4 Descendants

As well as printing the ascendants, descendants can be printed. This is 
not a proper tree, since the potentially huge number of descendants 
makes such a tree difficult to program and of little use on normal 
printers. Instead, it prints it like the "tree" display of many desktop 
like programs for PC clones. This is the same as displaying descendants 
on the screen.

To print a tree, select Descendants on the Print menu or press Alt-D. If 
you are currently viewing someone's descendants in the top window on 
screen, it will start printing their descendants. Otherwise the person 
selector appears for you to select the person whose descendants are to 
be printed.

9.5 Custom tree

This facility is only available for printing with GDOS.

Provided that a Custom tree is loaded, selecting Custom tree from the 
Print menu will print it on as many sheets of paper as are required. The 
program determines the number of pages across required, and the number 
down. It will then print pages for the whole of that area, even if some 
of them are blank. The pages may then be pasted together to produce a 
single large drawing.

It will be much easier to paste the pages together if there are no names 
split between pages. To help avoid this, when drawing the tree select 
Show pages from the Custom menu. This will show you where the page 
breaks will be for the page size set for your (GDOS) printer.

Chapter 10 : Printer Configuration
==================================

Use the mouse to drop down the Print menu. Select Configure and you will 
be presented with a form to complete. Alternatively you may press 
Shift-Ctrl-P.

First select the type of output device you are using. The options are 
Standard printer, GDOS printer or File output. A "standard" printer is a 
printer which accepts ASCII and prints it out with a monospaced type 
style. Proportional fonts would spoil the formatting which is done with 
spaces, but not disastrously. Graphics modes are not used.

The GDOS printer can be any output device for which you have installed a 
GDOS driver, including a metafile for incorporation into another program 
which can handle .GEM metafiles. Typically it will produce better 
looking printouts but will take longer.

File output simply sends the output to a file, and is like the Standard 
printer output except that it has no page length and has person 
separators rather than page feeds.

10.1 Standard printer

The top left area of the form contains three tick boxes to select the 
printer output to be used. Use the mouse to click on the Standard 
printer box. The box will be ticked and the other two cleared. The 
Standard printer options in the top right area of the form will now be 
enabled, those below for GDOS and File output will be greyed out and 
disabled.

10.1.1 Pause between pages

If the Pause between pages tick box is ticked the program will stop at 
the end of a page and put up an alert box. It will not continue to 
output until you OK the alert box. This will allow you to put in a new 
sheet of paper. Clicking on the tick box with the mouse will toggle the 
function on and off.

10.1.2 Page size

You can specify the number of characters per line and the number of 
lines per page by editing the numbers on the form. They are standard 
Atari GEM strings expecting numeric entry. If the characters per line 
value exceeds the width of your printer the data formatting will come 
out wrong as some text is right justified.

10.1.3 Page offsets

These allow you to space the print away from the left margin or the top 
of page. A typical use would be to allow a left margin if the pages were 
to be put into a file.

The offset plus the width or height must still be within the capability 
of the printer. For example, if you have an 8" printer with 12 
characters per inch, the width plus the offset must be not more than 96.

10.1.4 Printer strings

You can set up the data sent to the printer at the start of a print and 
between pages. You will need your printer manual to tell you what data 
to send. The defaults are nothing for Initialisation and 0C for Form 
feed, which should work for most printers. Likely uses are character 
width and type style in the initialisation. For form feed using single 
sheet you might like to send a bell character to the printer when you 
get to the end of the page so that you know when to change the paper.

The strings will normally consist of a sequence of hexadecimal numbers 
in the range 0 to FF, separated by commas or spaces. You can also 
include an ASCII string, enclosed by "s, which will be sent to the 
printer. For example, if you set the Initialisation string to:-
	D,1B,4D"((F))0"
the printer will be sent 0D, the ASCII code for carriage return, to 
ensure that the print starts from the left margin. It will then receive 
1B followed by 4D which sets elite pitch on a Star LC10. It will then 
receive the ASCII string ((F))0 which is a way of selecting the Courier 
font on a Star LC10.

10.2 GDOS printer

If you select GDOS printer in the top left area you can then select Page 
size and offsets, Pause between pages on and off as for the Standard 
printer, the device number and the fonts used for your printouts.

10.2.1 Device number

This defaults to 21 which is the number normally used for a printer. If 
you have installed any other options when installing GDOS you can enter 
the numbers here. If you set the number to the metafile device, normally 
31, output will be to a .GEM metafile and you will be prompted for a 
file name when you print out anything. For more information see Appendix 
A, GDOS.

10.2.2 Page size

The page size is set in millimetres. It defaults to 0mm width and 
height. If you leave it at zero size the size used will be the maximum 
allowed with your printer driver. In many cases this will prove 
satisfactory and you need not set a value. However, some printer drivers 
assume US Legal paper which is wider than A4. If the printout is larger 
than the paper you are using, or you wish to restrict the size for any 
other reason, enter the size of the print area. Typically you would make 
this less than the actual paper size to allow for margins. If you are 
outputting to a metafile the default size is approximately A4.

10.2.3 Page offsets

These allow you to space the print away from the left margin or the top 
of page. A typical use would be to allow a left margin if the pages were 
to be put into a file.

The offset plus the width or height must still be within the capability 
of the printer. For example, if you have an A4 printer (210mm) the width 
plus the offset must be not more than 210mm.

10.2.4 Font selection

Printing of trees, indexes and descendants is all done using the Normal 
Font, printing a person uses the Title Font for their name. Click on 
Normal Font and you will be presented with the Font selector where you 
can choose any of the installed fonts at sizes up to 18 point. For Title 
font you can go up to 36 point.

10.3 The font selector

The font selector has two scrolling lists, one for the typeface and one 
for the sizes, and buttons for effects such as underlined.

10.3.1 Typefaces

All available GDOS fonts are listed, sorted by index number. The system 
font is not listed, since it is not available on the printer or on any 
device except the screen. The list contains all other screen fonts and 
assumes that the matching printer font is installed. This list can be 
scrolled, in the normal way that windows and file selectors etc. work, 
if you have more fonts than will fit normally.

10.3.2 Sizes

This lists all available sizes of the selected typeface5, up to the 
maximum size allowed, which is 18 point for the normal font or 36 point 
for titles. Note that GEM will double fonts making them twice the size 
but blockier looking, and it is impossible to tell from the font 
selector which sizes are real sizes and which are generated by GEM.

You can also enter a size directly, this is for use with SpeedoGDOS to 
select a size other than those normally available.

If a different typeface is selected, the size list is updated to show 
the sizes available in that typeface, and if the current size is 
available it will be highlighted.

10.3.3 Font effects

The buttons at the bottom of the font selector switch on and off effects 
such as underlining.

Thicken is a sort of bold, made by widening vertical strokes.

Skew is for slanted text. This is not a true italic, although  many 
other GEM programs call it italic. It slants the text at  an angle of 
27.5  If you need true italic you have to get a  separate font for it.

Outline and Shadow generally do not look very nice and are useless for 
most  things, but GEM allows you to do this so the options are available 
if you want them.

10.4 File print

If you select File print there are only three parameters to set. The 
number of characters per line would normally be chosen to allow easy 
viewing on a screen or correspond to the number on the printer on which 
you ultimately intend to output this file. The offset will add the set 
number of spaces at the start of each line. The Separator string takes 
the place of Form feed for a Standard printer and is used to separate 
pages within the file. It might be used for a number of carriage returns 
or linefeeds. The options are the same as for the Standard printer 
strings above so you are able to embed control codes and include 
printable strings.

Chapter 11 : Set preferences - Configuring Family Tree
======================================================

Certain options can be set from the preferences dialogue box. (Most of 
these are described in more detail elsewhere in the manual). Drop down 
the Preferences menu and select Set preferences and the form appears.

11.1 Save time interval

This is the amount of time, in minutes, between you making the first 
change and the alert box popping up asking whether you would like to 
save. This is covered in more detail in chapter 3.

11.2 Person selector options

Click on tick box to select or deselect Autolist. When selected, each 
time the person selector is used it will list all the people in the tree 
without your having to click on list. This would normally be the 
preferred option, but with a very large tree the time taken to do this 
may become a nuisance. It would be quicker to limit the number of people 
listed by preselecting a name, date or flags.

Click on tick box to select or deselect Reuse name. When selected this 
will cause the person selector to be initialised with the last used 
family name.

11.3 Longer names

Click on the tick box to select full names in the display of descendants 
and trees. When this is not selected the names are restricted to 32 
characters. In some situations this may be slower because the full names 
are not stored in the index.

11.4 Descendant's death date

Click on the tick box to select or deselect this option. When selected 
the death date will be appended after the date of birth when displaying 
or printing descendants. This will reduce the number of generations 
which can be fitted in within a given width, so is most useful when 
using small fonts or wide paper. In some situations this may be slower 
because the death date is not stored in the index.

11.5 Index number

Click on the tick box to select or deselect this option. When printing 
personal details, or exporting in CSV format, people's reference or 
index numbers will be appended to their names if this option is 
selected.

11.6 Text size

These determine the size of text used for screen display. They are not 
used for printing, where the font selector lets you change the size. The 
size used for further notes can be set independently, the tree display 
and descendants display share a common setting. The three sizes 
available are Tiny which is the six by six font used under icons on the 
desktop, Small, the eight by eight font normally used in medium 
resolution, and Normal, the eight by sixteen font normally used in 
higher resolutions.

11.7 Index sizes

By default a tree can be up to 1000 people. This can be increased if 
necessary. It can be decreased, but the memory saved is fairly small. 
Changes to this do not take effect until you reload the tree - you must 
save preferences first, see below.

11.8 Maximum number of people blocks/couple blocks

Only change this if you are short of memory, or have memory to spare and 
wish to speed up operations. Family Tree will only load data from the 
disc as it needs it. However, it will then keep that data in memory 
ready for future use. As a result Family Tree will progressively use up 
more of the computer's memory. If you are running MultiTOS you may need 
to restrict the amount of memory which Family Tree takes. The program 
will take a minimum of two blocks for people and two for data. You can 
determine the approximate amount of memory used for storing people and 
couple data by multiplying the block size in bytes by the number of 
blocks.

11.9 Block sizes

These are described in more detail in Appendix B. These determine the 
amount of data, in bytes, that can be stored on each person or each 
marriage, and in most cases can be left alone.

11.10 Edit buffer size

The text editor used for further notes uses a buffer to store the notes 
in, of the size set up here. It only gets the memory from the system 
when you start editing or looking at the notes, and releases it 
afterwards. You cannot change the size when it is in use.

The notes are only stored in the edit buffer when you are editing them, 
the rest of the time they are stored in the people block along with 
other information on the people. If you find you need to increase the 
edit buffer size, you may find the person block size needs changing as 
well. It is probably better to use a word processor to produce a 
separate document if you need to write a lot, and write a reminder of 
where it is in Further notes.

11.11 Saving preferences

Selecting Save from the Set preferences form, or the Save Preferences 
menu item (on the Preferences menu), saves the preferences to disc.

They are saved in the same folder as your data, and will be loaded 
whenever that tree is loaded. This means that you can ensure the block 
sizes are sufficiently large for a particular tree without being 
unnecessarily large for any other tree you may have.

Chapter 12 : Flags - Custom fields
==================================

The program allows eight user definable flags. These can be used to 
record personal details that are not otherwise covered, and can be used 
for person selection.

Select Name flags from the preferences menu and you will be presented 
with a dialogue box. There are eight editable lines of text in which you 
can enter your own name for the flags, e.g. "Born abroad" or "Direct 
ascendant". You can also select for each flag whether you want the 
information to be printed out with other details when you print person.

The dialogue box is the same one as is used when editing flags in the 
person form and setting flag conditions in the person selector. This is 
the only place where the text strings can be altered. If you wish the 
flag information to be printed with other person data click on the Yes 
button adjacent to the text string, otherwise No. If enabled the text 
string you have entered will be printed with Yes or No beside it.

Chapter 13 : Merging Trees - Import and Export
==============================================

Sometimes you will want to merge part of someone else's tree into yours. 
For example, if there are two people tracing the same family, one may 
discover and enter information on a branch of the family that the other 
has no information on. Entering all this information again could take 
ages and may allow errors to slip in.

Family Tree allows you to merge these two trees. It is a two step 
process. First you export the people you are interested in, then import 
them into the other tree. Direct relationships between exported people 
are kept intact, but not those between exported people and others. It is 
therefore a good idea to export as many people as possible at once, to 
save adding too many relationships later.

Family tree normally saves the information to be transferred in a file 
in its own format. However, it is also possible to transfer data to and 
from other genealogy programs by using GEDCOM format. This is a format 
specified by the Church of Jesus Christ of Latter Day Saints. It is a de 
facto standard for genealogy data and is supported to some extent by a 
large number of different programs.

Currently Family Tree will import and export all its information except 
the custom defined flags in GEDCOM format. However, to do this it 
defines some +schemas' of its own. These will almost certainly not be 
recognised by another program, but part of the GEDCOM specification 
deals with the correct handling of unrecognised data types. This will 
allow you to manually incorporate the data that the receiving program 
could not handle.

Similarly, if Family Tree comes across lines of data which it cannot 
handle, it will create a text file listing all the problematic 
information and also include a note in the Further notes page of the 
person involved. In this way no data should be lost.

Further information can probably be obtained from:-

	Society of Genealogists,
	14 Charterhouse Buildings,
	Goswell Road,
	London    EC1M 7BA,
	England

A further option is to transfer data using CSV data format. This 
may be useful for transferring data between Family Tree and 
non-genealogical programs.
	
13.1 Exporting

Select Export under the File menu. A dialogue box appears with a list of 
all the people in the tree. Clicking on one of these puts a tick by the 
name, clicking on them again removes the tick. When all the people to be 
exported are ticked, click on the OK button. A file selector appears 
where you can choose the name and path for the transfer path. The 
default is a:\transfer.gen, but it remembers the last one used.

13.1.1 Select all

Clicking on Select all obviously selects everyone. Similarly Deselect 
all deselects everyone.

13.1.2 Filter

Clicking on filter brings up a filter which resembles that at the top 
of the person selector and works in a similar way. When the fields are 
filled in correctly, click on Select to select everyone that matches 
the filter, or Deselect to deselect everyone that matches the filter. 
This is probably most useful for surnames, or to select everyone 
before a certain date.

13.1.3 Include ascendants/descendants

Selecting the Include descendants button and then clicking on someone 
will select them, their spouse and all direct descendants.

Similarly, selecting the Include ancestors button and then clicking on 
someone will select them and all direct ancestors.

If both buttons are selected, Family tree does not, as might be 
expected, include direct ancestors and direct descendants. It will 
select direct ancestors and all of their descendants that are not 
descendants of the selected person. This sounds complicated, but it is 
what people normally mean when they talk about someone's "side of the 
family" and can be useful.

13.1.4 GEDCOM

Click on the GEDCOM button to select **DB**pap it. Click on Fam Tree, or 
CSV, to deselect it. If it is selected, indicated by a cross drawn 
within the box, the data will be saved in a GEDCOM format file.

13.1.5 CSV

Click on the CSV button to select it. Click on Fam Tree, or GEDCOM, to 
deselect it. If it is selected, indicated by a cross drawn within the 
box, the data will be saved in a CSV format file.

CSV format is provided to allow transfer of data between Family Tree 
and other types of programs such as general purpose databases or word 
processors. It allows the export or import of names, dates etc. but 
does not record relationships. It should not therefore be used for 
transfers where Family Tree or GEDCOM format could be used.

Unlike the other export formats it is possible with CSV to select 
which data is to be exported. Click on Select CSV data... in the 
Preferences menu.

The format of CSV data differs between programs. The format can be 
adjusted to allow for these differences. Select Set CSV format... from 
the preferences menu.

13.2 Importing

Select Import from the File menu allows you to read the data previously 
written by the export option. A file selector appears for you to select 
the file to import. This remembers the last file used for import or 
export and this comes up as the default.

The program will import data in its own format. It will also 
automatically recognise a GEDCOM format file and import that. If 
any other file is imported it will be interpreted as CSV data. The 
data to be imported must have been selected and the format set before 
importation. See Select CSV data... and Set CSV format... in the 
Preferences menu.

13.2.1 Flags

Because flags are customisable they may not be the same in the two 
trees. When data is imported, for each of the flags used within the 
imported data you will be offered the choice of using an existing flag, 
keeping the name in your tree, or creating a new one, using the name 
from the imported data.

13.3 Configuring CSV data

When exporting CSV data it is possible to choose what information to 
export. It could be used simply to output a list of names or it could 
export almost all of the data in order to load the tree into another 
database. It does not export information about relationships.

Unlike Family Tree or GEDCOM format, the information in the file is 
not 'tagged' to say what it is. In order to import a file Family tree 
must be told what data is included in the file, and in what order. 
This is described below.

Although CSV is a standard format there are slight variations between 
programs. Although Family Trees default format should normally work, 
it is possible to alter the format to cope with other data.

13.3.1 Selecting CSV data

To select the data for import or export click on Select CSV data... in 
the Preferences menu. A dialogue box will open. This contains two 
scrolling list of data types. The left hand box contains a list of all 
possible types. The right hand box will contain a list of parameters 
previously selected. When first used it will be empty.

The data types in the left hand box can be selected as usual with the 
mouse. Clicking selects one, shift clicking selects or deselects 
without deselecting others already selected and rubber banding allows 
selection of a group. When the required types are selected, clicking 
on Add -> will copy them into the right hand box.

Alternatively, double clicking on an entry will copy it directly to 
the right hand box. Clicking on the all button to the right of the Add 
-> button will copy all the types across.

The program will refuse to copy across any data type which has already 
been added to the right hand box, as each type may occur only once.

Data types in the right hand box may be selected with the mouse as for 
the left hand box. Clicking on Remove will remove them from the list. 
Clicking on Up or Down will move them in the list. Clicking on the all 
button to the right of the Remove button will remove all of them.

Click on OK will accept the new list. Clicking on Save will save the 
list to disc from where it will automatically be loaded when the 
program is next run.

There is one further option which is set from Set preferences... in 
the Preferences menu. When the names of mothers, fathers and spouses 
is included, their index or reference numbers may be appended to their 
names if Index number is selected.

13.3.2 Setting CSV format

For details of the CSV format handled by Family Tree, see Appendix E.

Because CSV format is not completely standard Family Tree allows a few 
options. In order to set the format, click on Set CSV format... in the 
Preferences menu.

A dialogue box will appear with a number of editable fields. Click on 
the fields in order to select them. Four of them are single 
characters. The String character or its replacement can be left blank, 
the others must be set.

The data separator which is normally a ',' can be changed to any 
single character.

The new line character does not have a standard value. The default is 
'\' which allows multiline text to be imported into Calligrapher 
tables.

Any text data is normally enclosed between String characters. The 
default is a double quotation mark, '"'. For some programs text may 
not be enclosed. In these cases the String character should be left 
blank.

Where the text includes the String character it is necessary to 
replace it with some other character. The Replacement character should 
be set for this. The default is a single quotation mark to replace the 
default double quotation mark. If no replacement character is set, the 
String character will be replaced by two String characters.

Within Family Tree the notes only contain new line characters at the 
end of paragraphs. As a result a line of text can be hundreds of 
characters long. This may present problems to some programs, such as 
Calligrapher, which can only handle a limited length. If Max line 
length is set to a non zero value any text will be broken into 
separate lines not longer than that set. Although primarily intended 
for notes, this will also affect any other text, so setting a small 
number may split names, places and so on into several lines.

The date may be exported as a text string or as a number. Click on the 
check box to select or deselect the Date as text.

Where dates are unknown they are normally left as zero. This may 
confuse some programs which see such dates as invalid. The default 
year, month and day may be set to any values acceptable to the 
receiving program.

Click on the OK button to use the values set. Clicking on Save will 
save the values to disc from where they will automatically be loaded 
when the program is next run.

Appendix A : GDOS
=================

GDOS (Graphical Device Operating System) is a part of the operating 
system that Atari left out of the ROMs. It manages fonts and graphical 
output devices.

To draw a circle on a screen requires a completely different procedure 
from drawing one on the printer. Plotters are different again. This 
makes things difficult for the programmer, but using GDOS the program 
just asks the operating system to draw a circle, and a circle appears 
whatever device the output is on.

For the user the main advantage is that if you get a new printer or 
plotter, all you need is a GDOS device driver to use it with all your 
programs. The Apple Mac works like this, PC clones work like this using 
Windows, and so should the Atari. Unfortunately, a lot of programs do 
not use GDOS, making it less useful than it could be.

A.1 Obtaining GDOS

Unfortunately GDOS is not freely distributable. It is supplied with most 
commercial GDOS applications, but we cannot supply it since this program 
is PD. If you have Timeworks DTP, Word Up, Hyperdraw, Wordflair or any 
other program which uses GDOS for output, you can use it exactly as 
supplied. Otherwise, the ST Club can supply, for stlg2.95, GDOS with the 
standard fonts and a driver for either 9 pin Epson compatible printers 
or 24 pin ones - specify which when you order.

Compo now sell SpeedoGDOS. If you have SpeedoGDOS, you get vector fonts, 
and all the hassles of installation described in this appendix disappear 
instantly! It doesn't work with some GDOS programs, but it works with 
Family Tree and is excellent. It does require at least 1Mb of memory, 
2Mb or more is better.

A.2 Installing GDOS

If you have a GDOS based program working on your computer, all other 
GDOS programs, such as Family Tree, should work properly without any 
further installation. If you use a hard disc there is nothing else to 
do, otherwise you will have to copy certain files off the disc you use 
for your other GDOS application.

In the auto folder of either your hard disc or the floppy disc you use 
for Family tree should be the program gdos.prg. There should be a folder 
on this disc, normally called gemsys or gdos.sys, containing drivers for 
your printer (e.g. fx80.sys) and the metafile (meta.sys), and a 
collection of fonts for each device.

A.2.1 Fonts

GDOS requires separate fonts for each device, so you would need 
different fonts for screen and printer for example, although they would 
normally correspond.

The device for which fonts are intended is normally determined by the 
last two letters of the filename, although some programs use different 
naming systems for the fonts - they do not matter, it just makes it 
easier to identify fonts. Nothing is used for monochrome screen, CG is 
used for medium resolution screen, EP for Epson 9 pin printer and MF for 
the metafile device. Other letters will be used for other devices.

A.2.2 The assign.sys file

This is the worst thing about using GDOS. Although there are 
installation programs to do this for you, the standard Atari one does 
not seem to work very well, so we edit our assign.sys file using a word 
processor. Of course, if you already use a GDOS program you can use the 
supplied one without any problems.

The first line shows where the fonts and drivers are stored, for example 
ours is:-

	path = c:\gdos.sys\

Next, the first device is listed, followed by all the fonts for it, then 
this is repeated for each other device. For example

	4p screen.sys
	atss10.fnt
	atss12.fnt
	cent10.fnt
	21 fx80.sys
	atss10ep.fnt
	atss12ep.fnt
	cent10ep.fnt
	31 meta.sys
	atss10mf.fnt
	atss12mf.fnt
	cent10mf.fnt

A.2.3 Devices

As you can see in the extract above, each device is numbered. Devices 
1p, 2p and 4p should be screen.sys and use the monochrome fonts, device 
3p should also be screen.sys but this is for medium resolution and 
should use medium resolution fonts. Note that you do not need screen.sys 
on the disc as it is built in to the computer.

Apart from that it does not matter. Family tree does not mind what 
numbers are used for other devices such as printers, although some 
applications do, so be careful if you use other programs with it. 
Normally printers start at 21, with other printers as 22, 23 etc. if you 
have several installed. Number 31 is often used for the Metafile.

A.2.4 Device drivers**DB**pap

The Atari operating system and GDOS have to work with many different 
printers, some of which did not exist when the Atari operating system 
was written. This is made possible by the use of device drivers, special 
programs which accept standard commands from the Atari operating system 
and send printer specific commands to the printer. The assign.sys file 
specifies which driver is to be used for each device. The filename for 
these drivers ends in '.sys'.

Device drivers can also be used for any other hardware which needs 
controlling, such as scanners or plotters, but the main use in the Atari 
is for printing.

A.3 Alternatives to GDOS

There are several alternatives to the standard GDOS available. They are 
mostly faster (GDOS is notoriously slow) or better in some other way.

A.3.1 AMC GDOS

The main advantage of this is that it is PD, so can be freely 
distributed. It works correctly with Motorola format fonts but otherwise 
is fairly similar.

A.3.2 G+Plus

This is a commercial replacement for GDOS from Codehead Software, which 
is faster and allows you to use different assign.sys files for each 
application. The disadvantage is that it costs thirty pounds.

A.3.3 FontGDOS

This is an official Atari version. It is faster than the standard GDOS 
and is a bit easier to set up, with a CPX supplied.

A.3.4 FSM GDOS

This was an official Atari replacement for GDOS which would have used 
vector fonts, and been easier to set up using CPXs. It was unfortunately 
very slow and buggy, and has been superseded by the excellent SpeedoGDOS

A.3.5 SpeedoGDOS

SpeedoGDOS is a replacement for GDOS which uses Bitstream Speedo vector 
fonts. It is very easy to install and set up. It is programmed by Atari 
and Bitstream, and documented and distributed in the UK by Compo. Vector 
fonts are fonts stored as a list of lines and curves, which can be 
rendered at any size and on any device. Bitmap fonts are fonts stored as 
a pattern of black and white dots. They are designed for a particular 
size and device

The latest version will also support Truetype and Postscript fonts, but 
they are slower so the Speedo fonts are recommended.

If you have SpeedoGDOS you may get alert boxes telling you that there is 
no memory for scratch buffer for effects. These do not appear to matter 
if you are not using effects for the fonts. This is due to a bug that 
has been fixed in the latest version.

There are lots of PD, freeware and shareware fonts available. Suppliers 
include:-

Compo software, Unit 3 Green Farm, Abbots Ripton, Huntingdon PE17 2PF
Hisoft, The Old School, Greenfield, Bedford MK45 5DE, UK
The ST Club, 7 Musters Road, West Bridgford, Nottingham NG2 7PP, UK

A.3.6 NVDI

NVDI is a replacement for part of the Atari operating system which 
increases the speed of the computer. Version 2 included a replacement 
for GDOS. Version 3 includes an alternative to SpeedoGDOS in that it 
supports vector fonts. In some ways it is easier to use than SpeedoGDOS 
and is faster but it only works with Bitstream Speedo and Truetype 
fonts, not Postscript.
NVDI4 can also handle Postscript fonts if an additional module is 
bought.

Appendix B : How the data is stored
===================================

B.1 Blocks

As the family tree gets larger the total amount of information stored 
can soon exceed the memory capacity of the computer, particularly on a 
520ST with a number of desk accessories loaded. The way GEN.PRG handles 
the problem is to store the data in blocks of memory.

Each Person Block contains the data for ten people, each Couple Block 
contains the data for ten couples or marriages. When you start your tree 
and create the first person the program gets a block of memory from the 
computer operating system. The first nine people will be stored in this 
block, and will have reference numbers 1 to 9. This block is a special 
case having only nine people, the person with reference number 0 does 
not exist. When you create the tenth person the program will get another 
block from the operating system for people reference 10 to 19. This will 
continue until the operating system is unable to supply more memory or 
the user defined maximum number of blocks in memory is reached. At this 
point the program will store one of the blocks away to disc and re-use 
the block for another group of ten people.

Similarly, when editing or displaying people, if the information is not 
already in memory GEN.PRG will load data from disc, creating a new block 
if it can or re-using an old one otherwise.

Couple blocks are created and used in the same way.

When running MultiTOS you may find that Family Tree has taken up more 
memory than you currently wish it to. If you select Release memory from 
the File menu the program will return all but two people and two couple 
blocks to the operating system for use by other programs.

If you store large amounts of data on individual people you may get a 
warning message to say that your block has overflowed. The data will not 
have been lost, but you should immediately save to disc or you risk 
overflowing the overflow memory area. This may also occur if you do a 
large number of edits on the same block of people as the block can be 
very inefficiently used in this case. If this happens frequently you 
need to increase the block sizes.

B.2 Index data

In order to make listing of people and use of the person selector faster 
there is an index stored continuously in memory which contains people's 
names, where the list of forenames and the family name are each limited 
to 20 characters, together with their dates of birth and death and 
flags.

If you enter a large number of people you may run out of space. You will 
be warned when this is about to happen and should increase the Index 
Size.

B.3 Changing block sizes

The block sizes are defaulted to 10000 bytes for People Blocks, 2000 
bytes for Couple blocks. This will normally be enough for all the 
standard information about the people and a reasonable amount of Further 
Notes. However, if you wish to store more information per person you may 
change the block size. You must do this before you start editing your 
tree. Click on Set Preferences in the Preferences menu. In the normal 
manner change the People block size. If you click on OK this will take 
immediate effect. If you click on SAVE this information will be saved in 
a file GEN.INF in your tree directory. When you next load the tree the 
value will be loaded in for you. Similarly you may change the Couple 
block size, but as there is no scope for extensive notes you are 
unlikely to ever need to do this. If you are very short of memory and do 
not have a large amount of data on individual people you may reduce the 
block sizes.

B.4 Changing Index Size

This is changed as for Block Sizes above. The memory savings by reducing 
the index size are fairly small, the default size of 1000 only taking 
about 40 kbytes.

Appendix C : File Format
========================

The files are either stored with the program or the tree to which they 
apply. If you run the program from a floppy disc which is removed from 
the drive once the program is loaded, those files which are stored with 
the program will not be saved. You can explicitly save the printer 
configuration data if you insert the program floppy when you wish to 
save it.

The data in the files is all in a standard format, and can normally be 
read with any simple word processor. If you use long paragraphs in 
Further Notes the line length may be too long for First Word Plus and 
some other word processors. Each parameter is stored as a three 
character mnemonic followed by an Ascii string. The string may be the 
text as it appears on the screen or a conversion of a numerical value 
such as reference number or date.

C.1 Person files

Each person file contains one block, so there should be ten people in 
them, except for the last one. They are named P0000000.GEN for the first 
file, P0000010.GEN for the second, then P0000020.GEN, P0000030.GEN etc.

The mnemonics and strings are interpreted as follows.

ref1234					reference number, 1234

all following lines refer to that person until next ref string

famBaker				family name, Baker
forIan Kenneth			forenames, Ian Kenneth
sexm					sex: m male, f female, ? undefined
bid998502				birth date, 6Mar1950
						(998502 = 6 + 32*3 + 512*1950)
bipEpsom, Surrey		birth place
bisBirth certificate	source of birth information
occlabourer				occupation
bad						baptism date
bapEpsom				baptism place
bas						source of baptism information
ded						death date
dep						death place
bcp						burial place
bcd						burial date
dwd						will date
dw1Peter Piper			first will witness, Peter Piper
dw2						second will witness
ex1						first will executor
ex2						second will executor
sol						solicitor for will
benTom, Dick and Harry	beneficiaries
be2						further beneficiaries
be3						further beneficiaries
des						source of death information
notAnything you want	first paragraph of further notes
extand a bit more		second and subsequent paragraphs
flg67					flag information, see below
par1234					parents' couple reference
cou1234,5678,4321		marriage references
end						end of this person's data

For each flag there is an associated number, 0 for not set, 1 for Yes 
and 2 for No. The flag information is stored as a number consisting of 
flag1 plus 4 x flag2 plus 16 x flag3 and so on in increasing powers of 4

C.2 Couple files

Each couple file contains one couple block, so there should be ten 
people in them except for the last one. They are named C0000000.GEN etc, 
in a similar way to the people block files.

ref1234					reference number, 1234

all following lines refer to that couple until next ref string

mal1234					male reference
fem5678					female reference
wed						wedding date
wep						wedding place
wes						source of wedding information
ww1						first wedding witness
ww2						second wedding witness
did						divorce date
dis						source of divorce information
chi1234,5678			children's references
end						end of this couple's data

C.3 Person index files

This file, called P_INDEX.GEN is used to store the index - see Appendix 
B. The first line of the file is "People index for Gen.prg, Version 
X.xx."

The mnemonics and strings are interpreted as follows.

ref1234					reference number, 1234

all following lines refer to that person until next ref string

fam						family name
for						forenames
bid						birth date
flg						flag information, see person files above

C.4 Couple index files

This is called C_INDEX.GEN. The first line of the file is "Couple index 
for Gen.prg, Version X.xx."

The mnemonics and strings are interpreted as follows.

ref1234					reference number, 1234
mal						male reference
fem						female reference
wed						wedding date

C.5 Preference file

This stores the information set in the preferences dialogue box. It is 
stored with the data and is called GEN.INF

pbs						people block size
cbs						couple block size
pbm						maximum number of people blocks
cbm						maximum number of couple blocks
ebs						edit buffer size
pxs						max people in index
cxs						max couples in index
auly					autolist yes
rufn					re-use family name no
ftny					use longer names
iddy					include descendant's death date
sti						save time interval
fnt						tree text size
nft						notes text size

C.6 Printer configuration file

This stores all information set in the printer configuration box and the 
fonts set for GDOS printer output. It is saved with the program when you 
click on save from the configure printer dialogue box. It is called 
CONF.INF.

prn						printer type,  1 Standard, 2 GDOS, 3 To file
prl						lines per page on standard printer
prc						characters per line on standard printer
prx						x offset, characters, on standard printer
pry						y offset, lines, on standard printer
prpy					page pause yes on standard printer
prpn					page pause no on standard printer
prz1B,31"((F))1"		initialisation string on standard printer
prf						formfeed string on standard printer
fpc80					characters per line for File output
fpx						x offset, characters, on File output
fpf0D,0D				page separator for File output
prd21					GDOS device number
prw						GDOS page width in millimetres
prh						GDOS page height in millimetres
gdx						x offset, mm, on GDOS printer
gdy						y offset, mm, on GDOS printer
sfi3					normal GDOS font index
sfs12					normal GDOS font size
sfe5					normal GDOS font effects
tfi3					title GDOS font index
tfs24					title GDOS font size
tfe3					title GDOS font effects
gppy					page pause yes for GDOS
gppn					page pause no for GDOS

C.7 Customisation

Program customisation data for a particular tree is stored in 
GENCUST.INF. The Flags strings and whether to print them are stored 
here.

fl1Direct ascendants	flag string
fl2						flag string
fl3						flag string
fl4						flag string
fl5						flag string
fl6						flag string
fl7						flag string
fl8						flag string
flp17					flag print settings

The flag print settings number indicates which flags should be printed. 
For each flag there is a number assigned, 1 for Flag 1, 4 for Flag 2, 16 
for Flag 3 and so on in powers of 4. The settings number is the sum of 
the numbers associated with the flags to be printed. For example, 17 is 
the sum of 1 and 16, indicating that Flags 1 and 3 should be printed.

C.8 Program Configuration

This file stores the last used data directory and the default file for 
import and export. GEDCOM and CSV settings are also stored here. It is 
stored with the program. It is called GEN_DEF.INF.

pthC:\MYTREE.GEN		default data directory
trfA:\TRANSFER.GEN		default file for import/export
gtfF:\TRANSFER.GED		default file for GEDCOM import/export
ctfF:\TRANSFER.CSV      default file for CSV import/export
csvref,fam				CSV data selections, see below for list
css,                    CSV data separator character
csn\                    CSV new line character
csq"                    CSV string character
csr'                    CSV replacement for string character
csdy                    CSV date as text, y yes, n no
csl40                   CSV data max line length
csf17501020             CSV default date, 20 Oct 1750
sfmBaker				GEDCOM submitter's family name
sfrIan Kenneth			forename
sa1256 Lower Road		five lines of address
sa2Great Bookham
sa3Surrey  KT23 4DL
sa4England
sa5

The CSV data selections are all three character labels, separated by 
commas. Each selection may appear only once in the list. They may 
appear in any order. The possible entries are as follows.

ref   person's reference number as text
fam   family name
for   forenames
sex   sex
occ   occupation
bid   birth date
bip   birth place
bis   source of birth information
bad   baptism date
bap   baptism place
bas   source of baptism information
ded   death date
dep   death place
des   source of death information
bcp   burial or cremation place
bcd   burial or cremation date
dwd   date of will
dws   source of will information
exs   executors of will
sol   solicitor of will 
bes   beneficiaries of will
cou   spouses
not   further notes
nch   number of children
mot   name and reference of mother
fat   name and reference of father
fl1   fl1 to fl8, flag information

C.9 Custom tree

This file stores the structure of the tree, the attributes, the 
positions of the people and couples and the lines between them.

att363107				default attributes for the tree, the 
						number is the sum of the following 
						constants (sensible binary numbers)
							524288	exclude death date
							262144	include death date
							131072	exclude birth date
							 65536	include birth date
							 32768	auto format family name
							 16384	exclude family name
							  8192	include family name
							  4096	limit name length
							  2048	include all forenames
							  1024	one forename only
							   512	not hidden
							   256	hidden
							  1-99	max length of limited name
fnt123,name,12,0	font index number, font name, font size and effects.
org-25,-36			coordinates in mm of top left of custom tree
lim183,297			rightmost and lowest limits of tree
gap3,4,3			gap between siblings, couples and generations in mm

ppp					marker for start of people data

Then the following is repeated for each person drawn.

pln1				person's list number
ref3				person's reference number
pos5,18				position, x,y in mm
pst0				status, only 1 for selected person used
att					person's attributes, see above for values
fnt					person's font
box12,36,30,8		coordinates of box containing person, 
					top left x,y, width and height in mm
pld7,12,0			parent line data, 0 terminated list of segment
					lengths, alternately vertical and horizontal
par3				list number of parent's couple
cpl2,0				0 terminated list of coupling's list numbers
cou1				number of couplings
cdr1				number of couplings drawn

ccc	marker for start of couple data

Then the following is repeated for each couple drawn.

cln1				couple's list number
ref2				couple's reference number
pos29,135			coordinates of couple's position in mm
cst					couple's status, the sum of
						2	couple reversed (man on right)
						4	children hidden
hln25,47,138		coordinates of horizontal couple line, 
					left and right end x, y
vld4,9,0			vertical line data, 0 terminated list of segment 
					lengths, alternately vertical and horizontal
fld5,7,0			female line data, 0 terminated list of segment 
					lengths, alternately horizontal and vertical
mld2,9,17,3,0		male line data
cmn3				male list number
cfn4				female list number
chn1,2,0			0 terminated list of children numbers

Appendix D : GEDCOM File Format
===============================

The GEDCOM file format has unlimited capabilities. There are many types 
of data specified, plus a format for defining further data types.

Family tree saves all its data except for flags but creates two 
+schemas' of its own in order to do so. A +schema' is a structure which 
is specified within the file, examples below. In theory another program 
loading data saved from Family Tree could use the definition to 
interpret the data. More likely is that it would prompt the user that 
there was data it did not recognise and allow him to sort it out.

The full capabilities of Family Tree are shown below with a sample file. 
The indentation is added to make the format clearer, it is not part of 
the standard.

Note that any line starting with a 0 is a new item, the header, an 
individual persons data or a families data. Any line starting with a 1 
refers to the last line before it which started with a 0. So in the 
example below +SOUR ATARI_FAMILY_TREE' is part of the header, HEAD, 
information, as are +DEST ATARI_FAMILY_TREE', +DATE 29 JUL 1995' and so 
on. Similarly, any line starting with a 2 refers to the last preceding 
line starting with a 1. This continues infinitely in theory, but Family 
Tree never goes beyond lines starting with 5 refer to preceding lines 
starting with 4.

Some comments have been inserted to explain the use of tags; these are 
not part of the file.

0 HEAD
	1 SOUR ATARI_FAMILY_TREE
		2 VERS 2.20
		2 CORP Ian & Mark Baker
			3 ADDR 256 Lower Road
				4 CONT Great Bookham
				4 CONT Surrey  KT23 4DL
				4 CONT England
	1 DEST ATARI_FAMILY_TREE
	1 DATE 29 JUL 1995
	1 SUBM
		2 NAME Ian Kenneth /Baker/
		2 ADDR 256 Lower Road
			3 CONT Great Bookham
			3 CONT Surrey  KT23 4DL
			3 CONT England
	1 FILE E:\OUTPUT.GEN
	1 GEDC
		2 VERS 5.3
		2 FORM LINEAGE-LINKED

The following lines simply define the tag _SOLI as a label for a person 
(individual) who has a role connected with a will, and define that role. 
Although Family Tree outputs this schema it makes no attempt to 
interpret schemas when importing data.

	1 SCHEMA
		2 INDI
			3 WILL
				4 _SOLI
					5 LABL Solicitor
					5 DEFN Solicitor for the will.
					5 ISA ROLE
	1 SCHEMA
		2 INDI
			3 WILL
				4 _EXCUTR
					5 LABL Executor
					5 DEFN An executor of a will.
					5 ISA ROLE

GEDCOM combines the family name and forenames into one record. The 
family name can occur anywhere in the list of names and is indicated by 
enclosing it between '/'s.

0 @I1@ INDI
	1 NAME Ian Kenneth /Baker/
	1 SEX M
	1 BIRT
		2 DATE 6 MAR 1950
		2 PLAC Epsom, Surrey
		2 SOUR Birth certificate YA123456

Family tree outputs baptism records using the tag +BAPM'. It will import 
christening records using the tag +CHR' as if they were baptism records.

	1 BAPM
		2 DATE 1950
		2 PLAC St Martins, Epsom, Surrey
		2 SOUR Parents
	1 OCCU Electronics engineer
	1 DEAT

Dates can be qualified as before, after or about as in the next three 
dates.

		2 DATE BEF 6 MAR 2075
		2 PLACE	Not yet known
		2 SOUR	To be announced
	1 BURI
		2 DATE AFT 30 JUL 1995
		2 PLACE	Not yet known
	1 WILL
		2 DATE ABT 1 DEC 1995
		2 WITN First witness
		2 WITN Second witness
		2 _EXCUTR Executor of will
		2 _SOLI Solicitor who handled will
		2 LGTE Legatee or beneficiary data
		2 LGTE Second line of legatee data
		3 LGTE Third line of legatee data

NMR below refers to the number of couplings for this person, NCHI to the 
number of children, RFN to the reference number of the person in the 
original file. Although Family Tree outputs this information it makes no 
use of it when importing a file.

	1 NMR 1
	1 NCHI 2

The following line indicates that this person is a child in family F1.

	1 FAMC @F1@
	1 RFN 3
	1 NOTE Author of this software along with
		2 CONT his son Mark.
	1 NOTE Good structured code!
0 @I2@ INDI
	1 NAME David George /Baker/
	1 SEX M
	1 NMR 1
	1 NCHI 3
	1 FAMC @F1@
	1 RFN 5
0 @I3@ INDI
	1 NAME Kenneth George /Baker/
	1 SEX M
	1 NMR 1
	1 NCHI 2
	1 FAMS @F1@
	1 RFN 7
0 @I4@ INDI
	1 NAME Gladys Doreen Enid /Trimm/
	1 SEX F
	1 NMR 1
	1 NCHI 2
	1 FAMS @F1@
	1 RFN 9
0 @F1@ FAM
	1 HUSB @I3@
	1 WIFE @I4@
	1 CHIL @I2@
	1 CHIL @I1@
	1 RFN 3
	1 MARR
		2 DATE 22 SEP 1945
		2 PLAC St.Martin's, Epsom, Surrey
		2 SOUR Wedding invitation
		2 WITN George Baker
		2 WITN Leonard Trimm
	1 DIV
		2 DATE AFT 29 JUl 95
		2 SOUR	Court records
	1 NCHI 2
0 TRLR

Appendix E : CSV format
=======================

CSV is a simple format which allows data to be transferred between a 
number of different programs. Unlike Family Tree's format, or GEDCOM, 
the data is not tagged with its type. CSV relies on the data for each 
record being on a new line. The items of data within the line are 
normally separated by commas. They must be in a predefined order as 
they are only identified by their position.

The data is of only two types, a number or a text string. Text strings 
are enclosed between defined string characters, typically quotation 
marks. Because the text string is enclosed it may contain commas 
without these being misinterpreted as data separators. However, it 
must not normally contain the defined string character.

An exception to the last rule is that where there is no replacement 
character defined two successive string characters are interpreted as 
a single one.

A number such as a reference number has no numerical significance. For 
example, it would be meaningless to calculate the sum of two reference 
numbers. Such numbers are exported as strings of text.

A typical line might be

"3","Baker","Mark Nicholas",19770508,"Kingston upon Thames, Surrey"

Family Tree allows you to select which data to export, and in which 
order it will appear in the line.

The same selection can be used for importing data, but some of the 
data will be ignored. For example, it is possible to export the number 
of children a person has, which Family Tree calculates from its stored 
data. This is not however a value which Family Tree stores so is 
ignored on import.

The data which can be exported consists of the following.

  Reference                      number as text
I Family name                    text
I Forenames                      text
I Sex                            single character as text, m, f or ?
I Occupation                     text
i Date of birth                  date, number or text
I Place of birth                 text
I Source of birth information    text
i Date of baptism                date, number or text
I Place of baptism               text
I Source of baptism information  text
i Date of death                  date, number or text
I Place of death                 text
I Source of death information    text
I Burial/cremation place         text
i Burial/cremation date          date, number or text
i Date of will                   date, number or text
I Witness                        2 text strings
I Executor                       2 text strings
I Solicitor                      text
I Beneficiaries                  3 text strings
  Couple(s)                      text, a list of spouse's names
I Further notes                  text
  Number of children             number
  Mother                         text, name and reference number
  Father                         text, name and reference number
I Flag 1                         flag
I Flag 2
I Flag 3
I Flag 4
I Flag 5
I Flag 6
I Flag 7
I Flag 8

Dates can be exported as numbers or text. In number form they consist 
of an eight digit number, four digits for the year, two each for the 
month and day. In the example line above the number 19770508 would 
represent the 8th of May, 1977.

Flags are exported as an empty string, "", if the flag is set to 
unknown. Where the flag is set to Yes or No the user defined flag name 
is output followed by Yes or No, eg "Scottish born Yes".

Those items preceded by I can also be imported. The dates, preceded by 
i, can be imported if they are in the defined numeric form, not as 
text.

Appendix F : Changes for version 2.10
=====================================

The following are new or revised features since version 1.00. They do 
not include bug fixes. They are described in more detail in the 
appropriate parts of the manual.

Data entered under an earlier version of the program can be used with 
any later version. If you use an old version of the program with data 
created with a newer one then any data not recognised will be ignored, 
e.g. version 1.00 will ignore the occupation information. This will only 
become a problem if the data is then saved, as it will be saved without 
the new information.

F.1 Changes made in or before version 1.32

Keyboard short cuts have been added for a number of menu items. These 
will be enabled when the corresponding menu items are enabled. They are 
activated by holding down the Alternate key whilst pressing the 
appropriate letter. Also, when editing a person's information, if the 
sex has not been set Alt M can be used to set male, Alt F to set female. 
They cannot be used to alter the sex once set.

Previously you were advised to set the sex of a person before clicking 
on spouse in order to create a couple. The program will no longer let 
you create a couple if the sex is not set, instead you will get a 
message telling you to set the sex.

The program will now handle couples correctly where the other partner is 
not known. Previously these could be created but not then edited.

The person form now includes an extra space in which to enter the 
person's occupation. The form has also been re-arranged but the 
functions of the various fields remain unchanged.

The death form now includes a space for place of burial or cremation. 
There are also two extra spaces for beneficiaries of the will.

The index will now include up to 20 letters for a person's forenames.

If the date is entered with no day and the month set to "ccc" the year 
will be displayed and printed with a preceding c, e.g. c1950.

If before and after dates are specified in the person selector then 
people without a date of birth will be excluded from the list.

The program allows eight user definable flags. These can be used to 
record personal details that are not otherwise covered, and can be used 
for person selection.

The printer configuration now includes GDOS page size.

F.2 Changes for version 2.0

Person form, couple form and all their subforms such as birth, death, 
etc, in movable windows. The subforms may be left open and will update 
when a different person is displayed in the person selector. Tree 
display is now in a movable, resizable window, and can be on screen at 
the same time as the person form.

Descendants display added in a movable, resizable, scrollable window.

Release memory added to file menu to allow return of all but two people 
and two couple blocks to system memory. Maximum number of people and 
couple blocks to be in memory at once can be set in preferences dialogue 
box. These are so other applications can be run in a multitasking 
system.

Save as added to file menu.

Wild cards allowed in name fields of person selector.

Burial cremation date added to death form.

Option added to always list people on entering person selector. Another 
option added to keep the family name from the last use of the person 
selector.

Person, tree and descendant person will automatically print for 
displayed person if corresponding window is on top.

Export/import added.

Support for system clipboard added, with block marking in further notes. 
Also copy from tree and descendants as metafile and bitmap.

Text size can be set to the 8*16 font as well as the 8*8 and 6*6 fonts 
previously available.

The text size for further notes can be set independently.

Descendants death date can now be printed.

Arbitrary point sizes can be set under SpeedoGDOS.

F.3 Changes between 2.00 and 2.12

Longer names available for trees and descendants.

Windows can be iconified under MultiTOS

All dialogues are now application modal. This means that desk 
accessories and (under MultiTOS) other applications can be used, but 
other windows cannot be.

There is a sample of the current font in the font selector.

There is a preview option in the person selector so you can make sure it 
is the correct person.

On-line help is included.

F.4 Changes for 2.20

GEDCOM format files supported.

Dates can be qualified as after, before and circa using popup menu. 
Spaces may be used for unknown day and month instead of 00xxx.

Custom trees can be drawn and printed.

**DB**papF.5 Changes for 2.27

CSV Data format files supported

Appendix G - Distribution
=========================

If you find this program useful and are interested in any updates which 
may occur please write to let us know. Do not send any registration fee. 
If enough people ask for any particular feature we will attempt to 
incorporate it and send copies to those people who asked for it. At that 
point we would be grateful for a refund of the postage plus the cost of, 
or a replacement for, the floppy disc. We would like any comments and 
constructive criticism of the program. In particular, if anyone 
translates the resource file or this manual into another language we 
would like a copy.

Our thanks are due to those people who reported bugs in earlier versions 
of the program, and our apologies to those people who spent time 
re-entering data because they thought that they must be doing something 
wrong. If you have a repeatable problem please let us know, including as 
much information as possible, and preferably a copy of the data which 
gives the problem.

So long as it is distributed complete and unaltered (translation is 
allowed), you may give this to other people - in fact please do, we want 
it to be spread around. Public domain libraries and bulletin boards may 
charge their normal amounts for it.

G.1 This manual

This manual was originally produced for TEX output. It has now been 
converted for Papyrus which gives sufficient flexibility and quality 
without as much effort as TEX. If you do not have access to Papyrus and 
would like a copy of the formatted and illustrated manual, write and 
ask. If we are able to send it to you we would appreciate a refund of 
postage plus the cost of copying.

If you want to translate this manual please do, but send us a copy. If 
you want to translate the help file please write and ask for an editable 
version and the compiler.

G.2 The resource file

We have tried to put as much as possible in the resource file, so the 
program can be translated by anyone using a resource editor, such as 
WERCS from HiSoft. If you want to edit it to translate it or for some 
other reason, please do, although be careful because it is very easy to 
stop it working. Anything which changes the order of trees in the file, 
the order of objects in each tree or the tree structure will make it 
misbehave, and changing the length of an editable string will probably 
crash the program.

	Ian & Mark Baker
	256 Lower Road
	Great Bookham
	Surrey KT23 4DL
	England

email:	Ian:			ikb@zed-inst.demon.co.uk
		Mark(terms)		mnb20@cam.ac.uk
		Mark(vacations)	mbaker@mettav.demon.co.uk
