Geneal is a system for outputing family tree information
on a PostScript printer.  Geneal accepts family descendent trees
as a text file, and draws the names and descent lines by executing
within the printer itself, unlike most other programs that execute
on a PC or some other computer.  The family tree is output on standard 
computer paper as separate sheets for each family or group of families.

Geneal allows unstructured comments to be placed close to a person's
name in a tree, and also accepts text anecdotes of any length that
will be placed beneath the tree on the page.  In this way, family history
can be included directly with the ancestry detail.  Text can contain
visible layout marks for italic, bold, font, sizing or other text formating
instructions.  Being written in PostScript, Geneal can also accept embedded
PostScript instructions, so document layout can be flexibly and precisely
controlled.  Digitized photographs can be embedded in the document.

The family tree document can be assembled using a word processor or editor.
Alternatively, any database program capable of generating a GEDCOM format
file can be used.  In the latter case, a C program is provided to convert
from GEDCOM format to Geneal format.  A C program is also provided to 
generate an index to the pages of different branches of a family tree.


Files:

   geneal         A PostScript program to produce family trees
   ftindex.c      A program to generate an index to a multi-page family
                  tree, suitable for printing using "geneal".
   gedc2ft.c      A program to convert a GEDCOM file into Geneal format,
                  suitable fpr printing with "geneal".
   gedcom.tag     A file used by "gedc2ft.c"
   border.qs      A fragment of PostScript to place a border around each page
   userdoc.txt    A manual exlaining how to use the programs.
   spec.qs        A report giving the rationale in the design and showing
                  briefly how to use it, suitable for printing using 
                  "geneal".

Usage:

   The instructions on using Geneal are given in "userdoc.txt", a simple
   text file that can be viewed on the screen or printed as raw ASCII.

   To print the document that describes the program and discusses its
   design, send "geneal" and "spec.qs" together to a PostScript printer 
   or interpreter.

   To print a family tree, prepare one of more files containing the
   keywords "<ancestry>", "<generation>", "<comment>", "<pagetitle>",
   "<children>", "<nomorechildren>", and "<>" at the start of lines as 
   per the instructions.  Then send "geneal" and your file to the 
   PostScript printer.

   To prepare an index of family tree names, compile the "ftindex.c"
   program
      cc ftindex.c -o ftindex
   and then run the program with all the family tree files on the command
   line, eg
      ftindex  treefile.1  treefile.2  treefile.3
   This will create a file "index.qs", which may be printed by sending
   "geneal" and "index.qs" together to a PostScript printer.

   To convert a GEDCOM file to Geneal format, compile "gedc2ft.c"
      cc gedc2ft.c -o gedc2ft
   Copy the tag file "gedcom.tag" to the directory you are using,
   possibly editing it.  Then run the program 
      ged2ft yourfile.ged >yourfile.ft
   This will create the a file "yourfile.ft" which may be printed by
   sending "geneal" and that file together to a PostScript printer.

GENEAL is written by Graham Freeman and is copyright.  It may be used
freely for non-commercial purposes, and may be transmitted provided no
copyright notice attributing authorship and ownership within the file 
is modified.

The GENEAL distribution is available by anonymous ftp from
"ftp.adfa.oz.au" in the directory "pub/postscript".

                                Graham Freeman
                                gfreeman@cs.adfa.oz.au
