@database 003515a0-0
@master HeddleyCreation
@$VER: 1.0
@author "Ron Goertz, 223 Clay Court, Pullman, WA 99163"
@(c) "1995"
@wordwrap
@remark Created with Heddley v1.1 (c) Edd Dumbill 1994

@node "Main" "No title"
PedigreeGuide.rexx v 1.0 for Scion Genealogist v 4.07

This ARexx program will create an AmigaGuide document containing:

A pedigree chart for the current person (i.e., the current IRN) for a selectable
number of generations; the current person is the "root" of the pedigree.

Records (all information entered on the personal details screen, parents, siblings,
spouses, all information entered on the family details screen (for each spouse, as
applicable), and children) for each person  contained in the pedigree chart.

Records containing all the above information for each person referenced by someone
in the pedigree chart.

Records will only be generated for referenced people falling between the generation
of the root person and the highest generation selected.

Links to individual and family notes and pictures.

An alphabetized (by both family name and given name) list of all individuals with
records in the guide, including birth and death years when available.

  @{" Generating a PedigreeGuide  " link "Generate" 0}
  @{" Navigating a PedigreeGuide  " link "Navigate" 0}
  @{" PedigreeGuide.rexx variables" link "Variables" 0}

  @{" History                     " link "History"}
  @{" Author                      " link "Author" 0}
@endnode

@node "Generate" "Generating a PedigreeGuide"
How to generate a PedigreeGuide:

With Scion v 4.07 running, select the person who will serve as the "root" of the
pedigree.

Run PedigreeGuide.rexx from Scion (assigning it to a function key) or from a shell.
PedigreeGuide will use both RexxReqTools.library and RexxArpLib.library if they are
available. If these libraries are not available,  PedigreeGuide will send all
messages to, and take all input from, a shell. You can force all input/output to
be shell based by adding the NOGUI option to the command line
(i.e., "rx PedigreeGuide.rexx NOGUI").

When prompted, enter the path and filename where the generated guide is to be saved.
PedigreeGuide will now count the number of generations available for the current
person (my A500 takes  about 20 seconds to count the 15 generations available). When
prompted, enter the highest generation  to use for this guide.

Sit back and wait. My A500 takes about 2-3 seconds per record generated, plus a
little extra time generating the alphabetized list of names. Note that generating
the list of names requires the AmigaDOS "sort"  command to be available in your path.

You will be notified when the guide is complete.
@endnode

@node "Navigate" "Navigating a PedigreeGuide"
How to navigate a PedigreeGuide:

The guide will open showing the pedigree. The "Names" link will get you to the
alphabetized list of names; the other links will get you to individual records.

Within a record, the "Names" link will get you to the alphabetized list of names;
the "Pedigree" link will return you to the pedigree (if the person who's record
you're viewing is actually in the pedigree, that person will  be at the top of the
window if possible; otherwise, the top of the pedigree will be shown); the "Personal
 Note," "Individual Picture," "Family Note," and "Family Picture" links will display
 the appropriate items; the  name links will take you to the individual records. Note
 that links to other individuals will only be created if  the other individual's
 generation is between the "root" generation and the highest selected generation.

Within the alphabetized list, the "Pedigree" link will return you to the top of the
pedigree, while the name links will take you to the individual records.
@endnode

@node "Variables" "PedigreeGuide.rexx variables"
PedigreeGuide.rexx variables:

The following variables can be changed in PedigreeGuide.rexx depending on your desires
and environment:

Viewer - the name of the IFF viewer you want used in the links to IFF images.

TempFile - the path and filename used for the temporarily-generated list of names.

MaxLen.1 - the length of the visible link used in the list of names (allows uniform
link size).

MaxLen.3 - the length of the visible link used for the pedigree and in records.

EndReason.X - X=0-5; the reasons for a marriage being terminated.
@endnode

@node "Author" "Author"

Send questions or comments to:

Ron Goertz
223 Clay Court
Pullman, WA  99163
@endnode

@node "History" "History"

PedigreeGuide Version History

Version 1.01   Took advantage of Scion v4.09's GETVIEWER ARexx command
@endnode