The GENEAL Program				 1.Mar.88
Written by Jim McBeath (jimmc) at SCI

This is version 3.5 of GENEAL.

GENEAL is a genealogy program which can browse data, make individual
and family pages, make birthday and anniversary lists, and (with
the help of the TREEPAR program) make various flavors of family tree plots.

This file describes what other files exist and what you will have to
do in order to make geneal useful to you.

NOTE: Geneal uses the SPIN package (Simple Programmable INterface).  If you
don't have it, you won't be able to build geneal.

Files of interest:
    *.[ch]	The source files for geneal.
    Makefile	Exactly that.
    README	What you are looking at right now.
    History	A Brief history of geneal.
    geneal.n	Source for man page.  Describes (briefly) what
		geneal is all about.  Gives list of switches.
		Use "make man" to create geneal man file (geneal.man).
    PGMR.DOC	Programmer's documentation.  Gives more detail about some
		of the source files.  Read this if you are going to make
		any changes to the program or if you need to look for bugs.
    sample.dat  The data file.  This is a sample file for you to use
		as a template for creating your own data file.

What to do (after unpacking):
1. Use "make man" to create geneal.man from geneal.n.  Read it.
2. Edit the Makefile and set SPINDIR to point to the directory containing
   the spin files (xalloc.h, spin.h, spin.a, llib-lspin.a.ln).
   By default this is ../spin.
3. If you are running on something other than sun or bsd, you may have
   trouble with vsprintf.  You should put -DUSG in the CFLAGS in the
   Makefile in this case.
4. Make the program.  You should be able to simply issue a "make" command.
   If you wish, you can test it out at this point on the sample data file
   and make sure that it works.  (You will have to do a
   "setenv GENEALDAT sample.dat" to do this.)
5. Make your own data file.  Delete all of the supplied data file except
   record 0 (the description of the data format).  Add your own data in
   the same format.
6. Run geneal and execute the GConsist command to check for data consistency
   errors.  After correcting all errors uncovered here, you should
   be able to run the other portions of the program without errors.
7. If you want to make changes, read PGMR.DOC first.
8. Send me your comments, wishes, and improvements.

Geneal was originally written to run on a VAX under BSD4.2.  It has
since been moved to run on a SUN3 under Sun OS3.4.  If you have
problems running on other systems, please let me know.

		-Jim McBeath  {decwrl|oliveb|weitek|auspyr}!sci!jimmc
		  1.Mar.1988
