/usr/share/doc/lifelines-doc/ll-userguide.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>&#13;
LifeLines Documentation
</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="book"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="BOOK"
><A
NAME="docbook"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
><A
NAME="AEN2"
><SPAN
CLASS="application"
>LifeLines</SPAN
> Documentation</A
></H1
><H2
CLASS="subtitle"
><SPAN
CLASS="application"
>LifeLines</SPAN
> Version 3.0.61</H2
><H3
CLASS="author"
><A
NAME="AEN6"
></A
>Thomas T.  Wetmore , IV</H3
><HR></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
>1. <A
HREF="#AEN12"
>Users' Manual</A
></DT
><DD
><DL
><DT
>1.1. <A
HREF="#AEN14"
>INTRODUCTION</A
></DT
><DT
>1.2. <A
HREF="#AEN52"
>INSTALLATION</A
></DT
><DT
>1.3. <A
HREF="#AEN86"
>STARTING <SPAN
CLASS="application"
>LIFELINES</SPAN
> AND CREATING DATABASES</A
></DT
><DT
>1.4. <A
HREF="#AEN190"
>INTRODUCTION TO <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
></A
></DT
><DT
>1.5. <A
HREF="#AEN361"
>MAIN MENU</A
></DT
><DT
>1.6. <A
HREF="#AEN370"
>CODESET</A
></DT
><DT
>1.7. <A
HREF="#AEN380"
>ENTERING THE FIRST PERSON</A
></DT
><DT
>1.8. <A
HREF="#AEN424"
>SCREEN EDITORS AND ENVIRONMENT VARIABLES</A
></DT
><DT
>1.9. <A
HREF="#AEN480"
>BASICS OF BROWSING</A
></DT
><DT
>1.10. <A
HREF="#AEN491"
>IDENTIFYING A PERSON OR LIST OF PERSONS TO BROWSE</A
></DT
><DT
>1.11. <A
HREF="#AEN517"
>ZIP IDENTIFYING A NEW PERSON</A
></DT
><DT
>1.12. <A
HREF="#AEN532"
>BROWSE DISPLAY BASICS</A
></DT
><DT
>1.13. <A
HREF="#AEN535"
>PERSON BROWSE SCREEN</A
></DT
><DT
>1.14. <A
HREF="#AEN704"
>LIST BROWSE SCREEN</A
></DT
><DT
>1.15. <A
HREF="#AEN792"
>FAMILY BROWSE SCREEN</A
></DT
><DT
>1.16. <A
HREF="#AEN902"
>TANDEM PERSON BROWSE MODE</A
></DT
><DT
>1.17. <A
HREF="#AEN989"
>TANDEM FAMILY BROWSE MODE</A
></DT
><DT
>1.18. <A
HREF="#AEN1097"
>PEDIGREE BROWSE MODE</A
></DT
><DT
>1.19. <A
HREF="#AEN1160"
>SEARCH MENU</A
></DT
><DD
><DL
><DT
>1.19.1. <A
HREF="#AEN1172"
>Search Patterns</A
></DT
></DL
></DD
><DT
>1.20. <A
HREF="#AEN1212"
>ADD OPERATION</A
></DT
><DT
>1.21. <A
HREF="#AEN1219"
>DELETE OPERATION</A
></DT
><DT
>1.22. <A
HREF="#AEN1229"
>CODESET CONVERSION</A
></DT
><DT
>1.23. <A
HREF="#AEN1334"
>MISCELLANEOUS UTILITIES</A
></DT
><DT
>1.24. <A
HREF="#AEN1439"
>IMPORT ERRORS</A
></DT
><DT
>1.25. <A
HREF="#AEN1512"
>HANDLING SOURCE, EVENT AND USER-DEFINED RECORDS</A
></DT
><DT
>1.26. <A
HREF="#AEN1677"
>FAMILY STRUCTURE AND MERGING PERSONS AND FAMILIES</A
></DT
><DT
>1.27. <A
HREF="#AEN1686"
>LINKING RECORDS TOGETHER AND USING THE REFN FEATURE</A
></DT
><DT
>1.28. <A
HREF="#AEN1735"
>System and User Properties</A
></DT
><DT
>1.29. <A
HREF="#AEN2031"
>Other Executables</A
></DT
><DD
><DL
><DT
>1.29.1. <A
HREF="#AEN2033"
>dbverify</A
></DT
><DT
>1.29.2. <A
HREF="#AEN2086"
>btedit</A
></DT
><DT
>1.29.3. <A
HREF="#AEN2095"
>llexec</A
></DT
></DL
></DD
></DL
></DD
></DL
></DIV
><DIV
CLASS="LOT"
><DL
CLASS="LOT"
><DT
><B
>List of Examples</B
></DT
><DT
>1-1. <A
HREF="#AEN222"
><ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> person record</A
></DT
><DT
>1-2. <A
HREF="#AEN261"
>Example of NAME formats</A
></DT
><DT
>1-3. <A
HREF="#AEN268"
>Example of searching on NAMEs</A
></DT
><DT
>1-4. <A
HREF="#AEN321"
>Example family record</A
></DT
><DT
>1-5. <A
HREF="#AEN387"
>Default person record template</A
></DT
><DT
>1-6. <A
HREF="#AEN400"
>Example editing of template record</A
></DT
><DT
>1-7. <A
HREF="#AEN499"
>Example of entering a name</A
></DT
><DT
>1-8. <A
HREF="#AEN503"
>Example of using wildcard in browsing</A
></DT
><DT
>1-9. <A
HREF="#AEN1406"
>Example of using abbreviations</A
></DT
><DT
>1-10. <A
HREF="#AEN1423"
>Example of replacing the default person record template</A
></DT
><DT
>1-11. <A
HREF="#AEN1426"
>Example of replaced default person record template</A
></DT
><DT
>1-12. <A
HREF="#AEN1429"
>Example of replaced single line default person record template</A
></DT
><DT
>1-13. <A
HREF="#AEN1455"
>Example of bad NAME syntax (too many slashes in this case)</A
></DT
><DT
>1-14. <A
HREF="#AEN1466"
>Example of XREF XYZ being defined twice</A
></DT
><DT
>1-15. <A
HREF="#AEN1477"
>Example of person multiply defined</A
></DT
><DT
>1-16. <A
HREF="#AEN1484"
>Example of family record missing key</A
></DT
><DT
>1-17. <A
HREF="#AEN1495"
>Example of person record missing key</A
></DT
><DT
>1-18. <A
HREF="#AEN1502"
>Example of level number which is too high</A
></DT
><DT
>1-19. <A
HREF="#AEN1509"
>Example of lineage-linking line which is missing required value</A
></DT
><DT
>1-20. <A
HREF="#AEN1557"
>Example of a source record</A
></DT
><DT
>1-21. <A
HREF="#AEN1701"
>Example of referring events from a person record</A
></DT
><DT
>1-22. <A
HREF="#AEN1719"
>Example of adding a new person</A
></DT
></DL
></DIV
><DIV
CLASS="chapter"
><HR><H1
><A
NAME="AEN12"
></A
>Chapter 1. 

Users' Manual

</H1
><DIV
CLASS="sect1"
><H2
CLASS="sect1"
><A
NAME="AEN14"
>1.1. INTRODUCTION</A
></H2
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> is a genealogy program
     that runs on <ACRONYM
CLASS="acronym"
>UNIX</ACRONYM
> systems. It maintains
     genealogical records (persons, families, sources, events and
     others) in a database, and generates reports from those
     records. There are no practical limits on the number of
     records that can be stored in a
     <SPAN
CLASS="application"
>LifeLines</SPAN
> database, nor on the
     amounts or kinds of data that can be kept in the
     records. <SPAN
CLASS="application"
>LifeLines</SPAN
> does not contain
     built-in reports.  Instead it provides a programming subsystem
     that you use to program your own reports and charts. The
     programming subsystem also lets you query your databases and
     process your data in any
     way. <SPAN
CLASS="application"
>LifeLines</SPAN
> uses the terminal
     independent features of <ACRONYM
CLASS="acronym"
>UNIX</ACRONYM
> to provide a
     screen and menu based user interface.

</P
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> is a non-commercial,
     experimental system that is use at your own risk software. I
     developed <SPAN
CLASS="application"
>LifeLines</SPAN
> for personal
     use and shared it with friends. Enough of a demand arose
     through word of mouth and internet, that I have made the
     <SPAN
CLASS="application"
>LifeLines</SPAN
> source code and other
     information freely available under an MIT-style license
     reproduced below:

</P
><P
>&#13;     <SPAN
CLASS="QUOTE"
>"
Copyright (c) 1991-1999 Thomas T. Wetmore IV

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

     "</SPAN
>

</P
><P
>&#13;
     The source code, documentation and a collection of report
     scripts are located at <A
HREF="http://lifelines.sourceforge.net/"
TARGET="_top"
>&#13;     http://lifelines.sourceforge.net/</A
>.  You can also find
     binary kits for some platforms.  If you are a developer and
     wish to contribute enhancements, please sign up on sourceforge
     and contact <A
HREF="mailto:marc@nozell.com"
TARGET="_top"
> Marc
     Nozell</A
> who is currently managing the project.
     </P
><DIV
CLASS="note"
><P
></P
><TABLE
CLASS="note"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="../images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>&#13;     Prior to 1999, Lifelines was available on the ftp sites,
     <A
HREF="ftp://ftp.cac.psu.edu"
TARGET="_top"
>ftp.cac.psu.edu</A
> and
     <A
HREF="ftp://hoth.stsci.edu"
TARGET="_top"
>hoth.stsci.edu</A
>.
     Please use sourceforge instead.
     </P
></TD
></TR
></TABLE
></DIV
><P
>&#13;Other sources of information include:

<DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN37"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL><COL><TBODY
><TR
><TD
>lifelines homepage
</TD
><TD
>&#13;<A
HREF="http://lifelines.sourceforge.net/"
TARGET="_top"
>&#13;http://lifelines.sourceforge.net/</A
>.
</TD
></TR
><TR
><TD
>lifelines FAQ
</TD
><TD
>&#13;<A
HREF="http://lifelines.sourceforge.net/faq.html"
TARGET="_top"
>&#13;http://lifelines.sourceforge.net/faq.html</A
>.
</TD
></TR
><TR
><TD
>LINES-L mailing list
</TD
><TD
>&#13;<A
HREF="http://listserv.nodak.edu/cgi-bin/wa.exe?A0=lines-l"
TARGET="_top"
>&#13;http://listserv.nodak.edu/cgi-bin/wa.exe?A0=lines-l</A
>.
</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
>

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN52"
>1.2. INSTALLATION</A
></H2
><P
>&#13;You may be installing <SPAN
CLASS="application"
>LifeLines</SPAN
>
from a source distribution package or as an executable program
already prepared for your <ACRONYM
CLASS="acronym"
>UNIX</ACRONYM
>
(or <ACRONYM
CLASS="acronym"
>MS-Windows</ACRONYM
>) system. The
source distribution comes with the readme, build script and
make files necessary to build
<SPAN
CLASS="application"
>LifeLines</SPAN
>. Follow the instructions
in the readme file.  A number of executables are built
which can be put it in a
directory in your execution path. If you get the program in
executable form, follow whatever instructions came with it.
The following executables are included:
</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="command"
>btedit</B
></B
></DT
><DD
><P
>&#13;a low-level editor for advanced debugging of broken <SPAN
CLASS="application"
>LifeLines</SPAN
> databases.
</P
></DD
><DT
><B
><B
CLASS="command"
>dbverify</B
></B
></DT
><DD
><P
>&#13;a utility program to verify <SPAN
CLASS="application"
>LifeLines</SPAN
> databases.
</P
></DD
><DT
><B
><B
CLASS="command"
>llexec</B
></B
></DT
><DD
><P
>&#13;a stripped down version of the
<SPAN
CLASS="application"
>LifeLines</SPAN
> program, without the user interface
for non-interactive processing of report programs
</P
></DD
><DT
><B
><B
CLASS="command"
>llines</B
></B
></DT
><DD
><P
>&#13;the <SPAN
CLASS="application"
>LifeLines</SPAN
> program with full user interface
</P
></DD
></DL
></DIV
><P
>&#13;The source distribution package also contains documentation
and some <SPAN
CLASS="application"
>LifeLines</SPAN
> programs to demonstrate
the capabilities of the report language.
Included with these in the reports directory is a brief overview
of the reports in the file index.html.
</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN86"
>1.3. STARTING <SPAN
CLASS="application"
>LIFELINES</SPAN
> AND CREATING DATABASES</A
></H2
><P
>&#13;
     You normally start <SPAN
CLASS="application"
>LifeLines</SPAN
> with
     the command: <KBD
CLASS="userinput"
><B
CLASS="command"
>llines</B
> <TT
CLASS="replaceable"
><I
>database</I
></TT
></KBD
> where
     database is the name of a <SPAN
CLASS="application"
>LifeLines</SPAN
>
     database. If <SPAN
CLASS="application"
>LifeLines</SPAN
> finds the
     database, <SPAN
CLASS="application"
>LifeLines</SPAN
> opens the
     database and takes you to the program's main menu. If the
     database doesn't exist, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     asks whether it should create it, and if you answer yes, does
     so. You may create any number of databases, but only one can
     be accessed by <SPAN
CLASS="application"
>LifeLines</SPAN
> at a
     time. 

</P
><P
>&#13;
     The full command line interface to
     <SPAN
CLASS="application"
>LifeLines</SPAN
> is:

     <PRE
CLASS="synopsis"
>&#13;        <B
CLASS="command"
>llines</B
> <CODE
CLASS="option"
>[-acdfiklnortuwxzCFI]</CODE
><TT
CLASS="replaceable"
><I
>[database]</I
></TT
>
     </PRE
>

</P
><P
>&#13;
     The following options are supported:

</P
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN106"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL
WIDTH="48"><COL><TBODY
><TR
><TD
>-C</TD
><TD
>Specify configuration file location (e.g.
-C/home/bill/lifelines/.linesrc2 ) see the section on System and User Properties below</TD
></TR
><TR
><TD
>-F</TD
><TD
>Finnish option (only available if so compiled)
</TD
></TR
><TR
><TD
>-I</TD
><TD
>&#13;Specify a user property (e.g. -ILLEDITOR=gvim)
</TD
></TR
><TR
><TD
>-a</TD
><TD
>log dynamic memory operation (for debugging)</TD
></TR
><TR
><TD
>-c</TD
><TD
>supply cache values (eg, -ci400,4000f400,4000 sets direct indi &#38; fam
caches to 400, and indirect indi &#38; fam caches to 4000)
</TD
></TR
><TR
><TD
>-d</TD
><TD
>&#13;debug mode (signal protection disabled for convenience with breakpoints)
</TD
></TR
><TR
><TD
>-f</TD
><TD
>&#13;force open the database - use only in emergency
</TD
></TR
><TR
><TD
>-i</TD
><TD
>&#13;open database with immutable access (no protection against other
access -- for use on read-only media)
</TD
></TR
><TR
><TD
>-k</TD
><TD
>&#13;always show keys (normally keys are suppressed if REFN available)
</TD
></TR
><TR
><TD
>-l</TD
><TD
>&#13;lock (-ly) or unlock (-ln) a database for use with read only media
(access to a locked database is treated as immutable)
</TD
></TR
><TR
><TD
>-n</TD
><TD
>&#13;do not use traditional family rules
</TD
></TR
><TR
><TD
>-o</TD
><TD
>&#13;Specify program output filename (eg, -o/tmp/mytests)
</TD
></TR
><TR
><TD
>-r</TD
><TD
>&#13;open database with read-only access (protect against other
writer access)
</TD
></TR
><TR
><TD
>-t</TD
><TD
>&#13;trace function calls in report programs (for debugging)
</TD
></TR
><TR
><TD
>-u</TD
><TD
>&#13;specify window size (eg, -u120,34 specifies 120 columns by 34 rows)
</TD
></TR
><TR
><TD
>-w</TD
><TD
>&#13;open database with writeable access (protect against other
writer or reader access)
</TD
></TR
><TR
><TD
>-x</TD
><TD
>&#13;execute a single lifelines report program directly
</TD
></TR
><TR
><TD
>-z</TD
><TD
>&#13;Use normal ASCII characters for drawing lines in user interface rather
than the vt100 special characters.
</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><P
>&#13;the <CODE
CLASS="option"
>-o</CODE
> option specifies the initial filename to use for
output when running reports.  It only applies to reports run with the 
<CODE
CLASS="option"
>-x</CODE
> option.  This option has no effect on interactively run
programs.
</P
><P
>&#13;
     The <CODE
CLASS="option"
>-r</CODE
> option opens the database with read-only
     access. When in this mode
     <SPAN
CLASS="application"
>LifeLines</SPAN
> will not let you modify
     the database; no other operations are affected. The
     <CODE
CLASS="option"
>-w</CODE
> option opens the database with writeable
     access. If the database cannot be opened with the requested
     mode <SPAN
CLASS="application"
>LifeLines</SPAN
> quits
     immediately. When you open a database with neither the
     <CODE
CLASS="option"
>-r</CODE
> or <CODE
CLASS="option"
>-w</CODE
> options,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> first tries to open the
     database with writeable access; if not possible
     <SPAN
CLASS="application"
>LifeLines</SPAN
> then tries to open the
     database with read-only access; and if this is not possible
     <SPAN
CLASS="application"
>LifeLines</SPAN
> quits. A
     <SPAN
CLASS="application"
>LifeLines</SPAN
> database may be open
     simultaneously by any number of programs with read-only
     access; however, if a database is open by a program with
     writeable access, then it cannot be opened by any other other
     program.

</P
><P
>&#13;
     In rare situations the read/write mode mechanism can fail;
     when this happens a database may appear unopenable. If this
     happens use the <CODE
CLASS="option"
>-f</CODE
> option to force open the
     database; this will open the database and reset the mode
     mechanism. This is a dangerous feature; you can use it to open
     the same database with writeable access more than once; the
     results are unpredictable and generally disastrous.

</P
><P
>&#13;
     The multiuser protection supplied by this reader/writer access
     mechanism is provided via a flag setting in the database, so both
     read-only and writeable access actually alter the database (read-only
     access only alters the value of this flag). For truly read-only
     access, e.g., for use with read-only media, the best solution is to
     lock (-ly) the      database before copying it to the read-only media. This
     annotates the database itself as being for immutable access.
     Alternatively, to use a database already on read-only media and not
     so annotated, use the immutable (-i) flag.

</P
><P
>&#13;By default lifelines supports a traditional family concept, that is, each
family has at most one father and one mother.  The -n flag relaxes this
restriction.  However, not all the code in lifelines supports these
relaxations.  For example, the default family browse screen will only display
two parents, however by switching to one of the gedcom modes of displaying the
family you can see all the data.
</P
><P
>&#13;
     If you don't give the name of a database on the command line,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> will prompt you for
     it.  If the name you supply is an absolute pathname or a
     relative pathname it is used as the path to the database.
     If you provided a simple filename and you use the
     <CODE
CLASS="envar"
>LLDATABASES</CODE
> variable or user options (described later),
     <SPAN
CLASS="application"
>LifeLines</SPAN
> will search for the
     database in the directories named in the variable; this can be
     very convenient.
     If <CODE
CLASS="envar"
>LLDATABASES</CODE
> is not set
     the filename you enter is looked for in the current working directory.

</P
><P
>&#13;
     If you would like to choose a database from a list of existing ones,
     enter a single question mark and press return when
     <SPAN
CLASS="application"
>LifeLines</SPAN
> prompts you for the database name.
     <SPAN
CLASS="application"
>LifeLines</SPAN
> will then display a list of all
     databases that it can find, and you may select one from the list.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN190"
>1.4. INTRODUCTION TO <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
></A
></H2
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> records are stored in
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> format; you organize, edit and
     maintain your data in this format. <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
>
     is a standard that defines a file format for moving
     genealogical data between computer
     systems. <SPAN
CLASS="application"
>LifeLines</SPAN
> has adopted this
     format for structuring the records in its databases. This
     approach provides a structured yet flexible method for storing
     all the data you wish to record. There are few restrictions on
     the format, amount or type of information you may store in a
     <SPAN
CLASS="application"
>LifeLines</SPAN
> database.

</P
><P
>&#13;
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> is defined at two levels. At the
     syntactic level <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> is a simple set of
     rules for organizing and structuring data into records, with
     no concern about the types of records, types or formats of
     information in the records, or the relationships between
     records. At the semantic level <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> adds
     an additional set of rules that specify what record types are
     allowed, how records must be structured, how data within the
     records must be identified and formatted, and what specific
     relationships between the record types are allowed. In
     principle there can be multiple semantic versions of
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
>, though in practice there is only
     one, lineage-linked <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
>. Unfortunately
     this semantic version of <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> is poorly
     defined, and every genealogical system has interpreted it in
     different ways.

</P
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> uses
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> primarily at the syntactic level,
     though it does impose a few of the generally accepted
     lineage-linked semantic restrictions. This means some
     important things. It means that you can store all your
     genealogical data in your <SPAN
CLASS="application"
>LifeLines</SPAN
>
     database, and that you have wide freedom in how you choose
     your own conventions for structuring and formatting your
     data. But it also means that the way you store data in your
     databases can be different from the way that someone else
     stores their data.  This can be a problem if you share data
     with others or share report programs with other
     <SPAN
CLASS="application"
>LifeLines</SPAN
> users. My recommendation
     is to use <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> lineage-linking
     conventions wherever possible.

</P
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> does not use forms or
     screens to guide you through entering or changing
     data. Instead you use a screen editor and directly edit the
     data records. This requires you to understand the
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> format, and be able to edit data in
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> format, before you can use
     <SPAN
CLASS="application"
>LifeLines</SPAN
>. The
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> format is quite simple; this
     introduction will provide all you need to know about
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> in order to use
     <SPAN
CLASS="application"
>LifeLines</SPAN
>.

</P
><P
>&#13;
     Here is an example <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> person record:

<DIV
CLASS="example"
><A
NAME="AEN222"
></A
><P
><B
>Example 1-1. 

 <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> person record

</B
></P
><PRE
CLASS="programlisting"
>&#13;  0 @I25@ INDI
  1 NAME <KBD
CLASS="userinput"
>Thomas Trask /Wetmore/ Sr</KBD
>
  1 SEX <KBD
CLASS="userinput"
>M</KBD
>
  1 BIRT
    2 DATE <KBD
CLASS="userinput"
>13 March 1866</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>St. Mary's Bay, Digby, Nova Scotia</KBD
>
    2 SOUR <KBD
CLASS="userinput"
>Social Security application</KBD
>
  1 NATU
    2 NAME <KBD
CLASS="userinput"
>Thomas T. Wetmore</KBD
>
    2 DATE <KBD
CLASS="userinput"
>26 October 1888</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>Norwich, New London, Connecticut</KBD
>
    2 AGE <KBD
CLASS="userinput"
>22 years</KBD
>
    2 COUR <KBD
CLASS="userinput"
>New London County Court of Common Pleas</KBD
>
    2 SOUR <KBD
CLASS="userinput"
>court record from National Archives</KBD
>
  1 OCCU <KBD
CLASS="userinput"
>Antiques Dealer</KBD
>
  1 DEAT
    2 NAME <KBD
CLASS="userinput"
>Thomas Trask Wetmore</KBD
>
    2 DATE <KBD
CLASS="userinput"
>17 February 1947</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>New London, New London, Connecticut</KBD
>
    2 AGE <KBD
CLASS="userinput"
>80 years, 11 months, 4 days</KBD
>
    2 CAUS <KBD
CLASS="userinput"
>Heart Attack</KBD
>
    2 SOUR <KBD
CLASS="userinput"
>New London Death Records</KBD
>
  1 FAMC @F11@
  1 FAMS @F6@
  1 FAMS @F12@

</PRE
></DIV
>

</P
><P
>&#13;
     A <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> record is made up of lines. Each
     line has a level number and a tag, and most lines have a value
     following the tag. The first line in every record has a
     cross-reference index between the level number and the tag.

</P
><P
>&#13;
     Level numbers allow data to be structured to any degree of
     detail; lines with higher level numbers expand on lines with
     lower numbers. Each record begins at level 0, and each deeper
     level increments the level by
     one. <SPAN
CLASS="application"
>LifeLines</SPAN
> does not restrict
     the structuring depth. Tags are uppercase (by convention) code
     words that specify the kind of information on the line or on
     the higher numbered lines that follow. The information after
     the tag, if any, is the value of the line.

</P
><P
>&#13;
     The first line in a record indicates its type. There are four
     fixed record types in <SPAN
CLASS="application"
>LifeLines</SPAN
>
     databases: person, family, source and event. The first, 0
     level line in these records have tags
     <CODE
CLASS="structname"
>INDI</CODE
>, <CODE
CLASS="structname"
>FAM</CODE
>,
     <CODE
CLASS="structname"
>SOUR</CODE
> and
     <CODE
CLASS="structname"
>EVEN</CODE
>, respectively. Besides these
     record types, you may create your own record types by using
     any other tag on the 0 level line of a record. The lines that
     begin records are the only level 0 lines used in
     <SPAN
CLASS="application"
>LifeLines</SPAN
>. Each level 0 line has a
     cross-reference index between the level number and the
     tag. This index is the record's internal reference key; other
     records may refer to this record by using this index.
     Cross-reference indexes are bracketed by @ characters.

</P
><P
>&#13;
     The first line in the example record has the
     <CODE
CLASS="structname"
>INDI</CODE
> tag, identifying it as a
     person. The cross-reference index value, I25, can be used by
     other records to refer to this record.

</P
><P
>&#13;
     The second line in the example has the person's name. Each
     person record in a <SPAN
CLASS="application"
>LifeLines</SPAN
>
     database must have at least one <CODE
CLASS="structfield"
>1
     NAME</CODE
> line, and its value must be in
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> name format. This format allows
     names to be as long as needed, but the surname, which may be
     placed anywhere in the name, must be separated from the rest
     of the name by one or two slashes. For example:

<DIV
CLASS="example"
><A
NAME="AEN261"
></A
><P
><B
>Example 1-2. 
Example of NAME formats

</B
></P
><PRE
CLASS="programlisting"
>&#13;1 NAME <KBD
CLASS="userinput"
>John/Smith</KBD
>
1 NAME <KBD
CLASS="userinput"
>John /Smith/</KBD
>
1 NAME <KBD
CLASS="userinput"
>John/Smith/Jr.</KBD
>
</PRE
></DIV
>

</P
><P
>&#13;
     The second slash is required only if name elements follow the
     surname. White space is optional before the first slash and
     after the second. If you don't know a person's surname, or the
     person doesn't have a surname, you may use / or // or no
     slashes at all. For example:

<DIV
CLASS="example"
><A
NAME="AEN268"
></A
><P
><B
>Example 1-3. 
Example of searching on NAMEs
</B
></P
><PRE
CLASS="programlisting"
>&#13;
1 NAME <KBD
CLASS="userinput"
>Mary//</KBD
>
1 NAME <KBD
CLASS="userinput"
>Mary/</KBD
>
1 NAME <KBD
CLASS="userinput"
>Mary</KBD
>
</PRE
></DIV
>

     are all ways to enter a person named Mary with no known
     surname. A person may have any number, including zero, given
     names and/or initials. A <SPAN
CLASS="application"
>LifeLines</SPAN
>
     person record may have any number of <CODE
CLASS="structfield"
>1
     NAME</CODE
> lines, though the person will be displayed
     with the first name value only. Persons are indexed under all
     their names, however, so you will be able to search for
     persons by any of their names.
</P
><P
>&#13;
     The next line in the example gives the person's
     sex. <SPAN
CLASS="application"
>LifeLines</SPAN
> doesn't require a
     <CODE
CLASS="structfield"
>1 SEX</CODE
> line, but you should include
     it. The value of the line should be <KBD
CLASS="userinput"
>M</KBD
>
     or <KBD
CLASS="userinput"
>F</KBD
> if the sex is known; it can be
     left blank or set to <KBD
CLASS="userinput"
>U</KBD
> or
     <KBD
CLASS="userinput"
>?</KBD
>, say, if not known. A person must
     have a <CODE
CLASS="structfield"
>1 SEX</CODE
> line with a value of
     either <KBD
CLASS="userinput"
>M</KBD
> or <KBD
CLASS="userinput"
>F</KBD
>
     before he or she can be made a spouse or parent in a family.

</P
><P
>&#13;
     The example record also contains three events: birth,
     naturalization, and death. An event begins with a level 1 line
     whose tag indicates the event type. For example,
     <CODE
CLASS="structfield"
>BIRT</CODE
> is the tag for a birth event.

</P
><P
>&#13;
     Events usually have at least a <CODE
CLASS="structfield"
>2
     DATE</CODE
> and a <CODE
CLASS="structfield"
>2 PLAC</CODE
>
     line and often a <CODE
CLASS="structfield"
>2 SOUR</CODE
> line. The
     <CODE
CLASS="structfield"
>DATE</CODE
> and
     <CODE
CLASS="structfield"
>PLAC</CODE
> lines give the date and place
     of the event. The value of a
     <SPAN
CLASS="application"
>LifeLines</SPAN
>
     <CODE
CLASS="structfield"
>DATE</CODE
> line is free format, though
     <SPAN
CLASS="application"
>LifeLines</SPAN
> will try to parse it for
     specific day, month and year information. The value of a
     <CODE
CLASS="structfield"
>PLAC</CODE
> line is usually a
     comma-separated list of geopolitical units, starting with the
     most specific, ending with the most general. The
     <CODE
CLASS="structfield"
>SOUR</CODE
> line indicates the source of
     information about the event. The
     <CODE
CLASS="structfield"
>SOUR</CODE
> line can be the root of a full
     description of the source, or the value of the
     <CODE
CLASS="structfield"
>SOUR</CODE
> line can be a cross-reference
     key that refers to the source record that describes the
     source.

</P
><P
>&#13;
     The naturalization event (with tag
     <CODE
CLASS="structfield"
>NATU</CODE
>) shows a few other lines. The
     <CODE
CLASS="structfield"
>2 NAME</CODE
> line gives the person's name
     as recorded in the source (only <CODE
CLASS="structfield"
>1
     NAME</CODE
> lines must follow <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
>
     format). The <CODE
CLASS="structfield"
>2 AGE</CODE
> line gives the
     person's age at the time of the event. The <CODE
CLASS="structfield"
>2
     COUR</CODE
> line indicates the court where
     naturalization occurred.

</P
><P
>&#13;
     The final event is a death event (tag
     <CODE
CLASS="structfield"
>DEAT</CODE
>). The <CODE
CLASS="structfield"
>2
     CAUS</CODE
> line gives the cause of death.

</P
><P
>&#13;
     At the end of the record are three lines that refer to family
     records. A <CODE
CLASS="structfield"
>1 FAMC</CODE
> line refers to a
     family record that the person belongs to as a child; its value
     is the cross-reference index value of that family.  A
     <CODE
CLASS="structfield"
>1 FAMS</CODE
> line refers to a family
     record that the person belongs to as a spouse or parent.

</P
><P
>&#13;
     When using <SPAN
CLASS="application"
>LifeLines</SPAN
> to edit a
     person, you will not be able to edit the cross reference
     values on the <CODE
CLASS="structfield"
>0 INDI</CODE
>,
     <CODE
CLASS="structfield"
>1 FAMC</CODE
> or <CODE
CLASS="structfield"
>1
     FAMS</CODE
> lines; these are maintained by
     <SPAN
CLASS="application"
>LifeLines</SPAN
>.

</P
><P
>&#13;
     Here is an example family record:

<DIV
CLASS="example"
><A
NAME="AEN321"
></A
><P
><B
>Example 1-4. 
Example family record
</B
></P
><PRE
CLASS="programlisting"
>&#13;
  0 @F6@ FAM
  1 HUSB @I25@
  1 WIFE @I26@
  1 MARR
    2 DATE <KBD
CLASS="userinput"
>31 March 1891</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>New London, New London, Connecticut</KBD
>
    2 SOUR <KBD
CLASS="userinput"
>New London Vital Records</KBD
>
  1 CHIL @I27@
  1 CHIL @I17@</PRE
></DIV
>

</P
><P
>&#13;
     The <CODE
CLASS="structfield"
>0 FAM</CODE
> line assigns the family
     the cross-reference index of F6. The record contains
     <CODE
CLASS="structfield"
>1 HUSB</CODE
> and <CODE
CLASS="structfield"
>1
     WIFE</CODE
> lines that refer to the two
     spouses/parents. The record also holds a marriage event (tag
     <CODE
CLASS="structfield"
>MARR</CODE
>) and two <CODE
CLASS="structfield"
>1
     CHIL</CODE
> lines that refer to two children in the
     family. When editing family records, you cannot edit the
     <CODE
CLASS="structfield"
>0 FAM</CODE
>, <CODE
CLASS="structfield"
>1
     HUSB</CODE
>, <CODE
CLASS="structfield"
>1 WIFE</CODE
>, or
     <CODE
CLASS="structfield"
>1 CHIL</CODE
> lines; these are maintained
     by <SPAN
CLASS="application"
>LifeLines</SPAN
>.

</P
><P
>&#13;
     When you create new records for your database, you are free to
     invent tags and structure your data in any way you see
     fit. However, it is good practice to use standard
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> tags and value formats.
     <SPAN
CLASS="application"
>LifeLines</SPAN
> does enforce a small set
     of conventions that you must obey. Within person records,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> requires that you use
     <CODE
CLASS="structfield"
>1 NAME</CODE
> and <CODE
CLASS="structfield"
>1
     SEX</CODE
> lines with their special meanings and value
     formats. Though not required,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> assumes that you will use
     <CODE
CLASS="structfield"
>1 BIRT</CODE
>, <CODE
CLASS="structfield"
>1
     DEAT</CODE
>, <CODE
CLASS="structfield"
>1 CHR</CODE
>, and
     <CODE
CLASS="structfield"
>1 BURI</CODE
> lines for birth, death,
     baptism and burial events, respectively. In family records,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> assumes you will use the
     <CODE
CLASS="structfield"
>1 MARR</CODE
> event for marriage
     events. Within person records, you are not allowed to use
     <CODE
CLASS="structfield"
>0 INDI</CODE
>, <CODE
CLASS="structfield"
>1
     FAMC</CODE
> or <CODE
CLASS="structfield"
>1 FAMS</CODE
> lines,
     since these are used to maintain linkage information. Within
     family records, you are not allowed to use <CODE
CLASS="structfield"
>0
     FAM</CODE
>, <CODE
CLASS="structfield"
>1 HUSB</CODE
>,
     <CODE
CLASS="structfield"
>1 WIFE</CODE
> or <CODE
CLASS="structfield"
>1
     CHIL</CODE
> lines.

</P
><P
>&#13;
     The indentation shown in the examples is not part of
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> format. When
     <SPAN
CLASS="application"
>LifeLines</SPAN
> prepares records for you
     to edit, however, it always indents the records, making them
     easier to read and understand. You do not need to follow this
     indentation scheme when you edit the records. Indentation is
     removed from the data before it is stored in the database.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN361"
>1.5. MAIN MENU</A
></H2
><P
>&#13;
     After <SPAN
CLASS="application"
>LifeLines</SPAN
> opens an existing
     database, or creates a new one, it presents you with the main
     menu:

<PRE
CLASS="screen"
>&#13;Please choose an operation:
   b Browse the persons in the database
   s Search database
   a Add information to the database
   d Delete information from the database
   p Pick a report from list and run
   r Generate report by entering report name
   t Modify character translation tables
   u Miscellaneous utilities
   x Handle source, event and other records
   Q Quit current database
   q Quit program
</PRE
>


</P
><P
>&#13;
     Select an operation by striking the proper selection letter.

</P
><P
>&#13;
     The browse operation lets you browse the database and perform
     many operations on the data. The search operation provides some
     simple wildcard search capabilities, which lead into browsing
     particular records. The add operation lets you add
     new information, and the delete operation removes
     information. The report operations read report
     programs and generates output reports. The modify character
     translation tables operation changes the translation
     tables. The miscellaneous utilities operation provides such
     things as backup and restore. The handle source, event and
     other records operation gives you access to these three record
     types. The quit operation closes the database and returns to
     <ACRONYM
CLASS="acronym"
>UNIX</ACRONYM
>.

</P
><P
>&#13;
     The browse operation deserves special mention, because it
     provides a rich environment for searching, viewing, adding,
     modifying, merging and deleting information in the
     database. You will find that you operate from the browsing
     modes most of the time. The operations are all described in
     later sections.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN370"
>1.6. CODESET</A
></H2
><P
>&#13;
     After you have created a new database, and before you actually
     add any data to it, is the time to set the codeset to be used
     in the database.

</P
><P
>&#13;
     The codeset (or character encoding, to use precise Unicode
     terminology) is the decision as to how letters will be represented
     by the computer. If you have only ever used English letters in
     computing, you may not have had to encounter this issue, because as
     it happens, the English letters (a-z and A-Z) are stored numerically
     in the same fashion in almost all codesets used by computers. However,
     in the field of genealogy, you are especially likely to meet letters
     outside of the English alphabet (for example, accented vowels).

</P
><P
>&#13;
     You have fundamentally three choices as to what codeset to use in your
     database, listed below from easiest to most powerful.

</P
><P
>&#13;
     First, you may leave it entirely unspecified. This will give the 
     traditional lifelines behavior. This is really only suitable if either
     (a), you only use English (ASCII) data, or (b), you work in an 
     environment which entirely uses the same 8-bit codeset (eg, a GNU/Linux box
     which is all ISO-8859-15), and you only run lifelines in English.
     If you use any non-English data on MS-Windows, this is not likely to 
     be suitable, because the lifelines screens run in the console, but 
     you are likely to use MS-Windows applications either for editing or 
     for viewing output, and the MS-Windows console uses a different 
     codeset from MS-Windows applications. Also, if you use lifelines in a
     different language than English, this may not be suitable, because 
     the gettext message catalogs (for non-English interface) will not 
     be converted into your codeset.

</P
><P
>&#13;
     Second, you may specify a particular 8-bit codeset. Assuming that you
     have iconv and gettext installed (or you are using the MS-Windows version,
     which comes with these), you may specify any 8-bit codeset supported by
     iconv, and iconv supports quite many. A natural choice for Western European
     languages would be ISO-8859-1, or (for MS-Windows only) CP-1252. With this
     option, gettext language files will be converted to your codeset.

</P
><P
>&#13;
     Third, you may specify the use of UTF-8. This is a Unicode encoding, and
     is by far the most powerful option. In fact, this is the only really
     convenient way to be able to store, for example, names in English, names
     in Russian, and names in Greek, all in the same database, in their native
     scripts (alphabets).  In recent versions, lifelines has become more
     knowledgeable about handling UTF-8, so that, for example, upper &#38;
     lower casing only work correctly with versions from 3.0.28 on.

</P
><P
>&#13;
     To actually specify a codeset, enter it via the u(tility) o(ptions) page
     (which is documented below). From the main menu, in the English version,
     press u to reach the utility page, and then o to edit the user options. To
     set a codeset of, e.g., ISO-8859-1, enter this string on its own line,
     without the surrounding quotes: "codeset=ISO-8859-1". Or, to specify the
     use of UTF-8, "codeset=UTF-8".

</P
><P
>&#13;
     Further information about codeset conversion is found in the later chapter
     of that name (for example, information about producing reports which make
     use of HTML entity names for non-ASCII characters).

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN380"
>1.7. ENTERING THE FIRST PERSON</A
></H2
><P
>&#13;
     Note: Before you add the first person to your database, you
     specify internal codeset (review the Codeset chapter for
     information).

</P
><P
>&#13;
     Normally you add persons to the database from the browsing
     modes, but when entering the first person there is no one in
     the database to browse to. To add the first person to a
     <SPAN
CLASS="application"
>LifeLines</SPAN
> database, first select
     the add operation from the main menu. You will be prompted
     with the add menu (described later).  Strike p to add a
     person. <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a
     template of a <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> person record, and
     puts you in a screen editor to edit the template. The default
     template is:

<DIV
CLASS="example"
><A
NAME="AEN387"
></A
><P
><B
>Example 1-5. 
Default person record template
</B
></P
><PRE
CLASS="programlisting"
>&#13;
  0 INDI
  1 NAME <TT
CLASS="replaceable"
><I
>Fname /Surname/</I
></TT
>
  1 SEX <TT
CLASS="replaceable"
><I
>MF</I
></TT
>
  1 BIRT
    2 DATE
    2 PLAC
    2 SOUR
  1 DEAT
    2 DATE
    2 PLAC
    2 SOUR</PRE
></DIV
>

</P
><P
>&#13;
     Edit the template to create the new person's record. Change
     the name to the person's name. Assign the person's sex by
     deleting either <KBD
CLASS="userinput"
>M</KBD
> or
     <KBD
CLASS="userinput"
>F</KBD
>. Fill out the birth and death events
     as best you can. If the person is alive, remove the death
     event. Remove any <CODE
CLASS="structfield"
>DATE</CODE
> and
     <CODE
CLASS="structfield"
>PLAC</CODE
> lines you do not have the
     information for.

</P
><P
>&#13;
     The default template provides lines for one birth and one
     death event. You can expand the record with other events (even
     more birth or death events) and lines. Indentation makes it
     easier to read and edit the record, but isn't necessary. You
     may change the default edit template by defining the user
     option <CODE
CLASS="option"
>INDIREC</CODE
> (described later).

</P
><P
>&#13;
     Here is how I might edit the template when creating a record
     about myself:

<DIV
CLASS="example"
><A
NAME="AEN400"
></A
><P
><B
>Example 1-6. 
Example editing of template record
</B
></P
><PRE
CLASS="programlisting"
>&#13;
  0 INDI
  1 NAME <KBD
CLASS="userinput"
>Thomas Trask /Wetmore/ IV</KBD
>
  1 SEX <KBD
CLASS="userinput"
>M</KBD
>
  1 BIRT
    2 DATE <KBD
CLASS="userinput"
>18 December 1949</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>New London, New London, Connecticut</KBD
>
    2 SOUR <KBD
CLASS="userinput"
>Birth Certificate</KBD
>
  1 OCCU <KBD
CLASS="userinput"
>Software Engineer</KBD
>
  1 RESI
    2 DATE <KBD
CLASS="userinput"
>1982 to 1995</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>Newburyport, Essex, Massachusetts</KBD
>
    2 ADDR <KBD
CLASS="userinput"
>2 Barton Street, Newburyport, MA 01950</KBD
>

... lots of other events and facts
</PRE
></DIV
>

</P
><P
>&#13;
     When you edit a person record, don't add or modify
     <CODE
CLASS="structfield"
>INDI</CODE
>,
     <CODE
CLASS="structfield"
>FAMC</CODE
> or
     <CODE
CLASS="structfield"
>FAMS</CODE
>
     lines. <SPAN
CLASS="application"
>LifeLines</SPAN
> creates and
     maintains these lines through specific user commands.

</P
><P
>&#13;
     When you finish editing and leave the editor, you
     automatically return to
     <SPAN
CLASS="application"
>LifeLines</SPAN
>. If you made an error
     (eg, didn't use proper level numbers or didn't follow the
     proper name convention), <SPAN
CLASS="application"
>LifeLines</SPAN
>
     displays an error message, and asks if you want to re-edit the
     record. If you don't, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     doesn't add the person to the database.

</P
><P
>&#13;
     When the record is in proper format,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks if you are sure you
     want to add the person to the database. If you answer yes, the
     person is added; if you answer no, the person isn't. In both
     cases <SPAN
CLASS="application"
>LifeLines</SPAN
> returns to the main
     menu.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN424"
>1.8. SCREEN EDITORS AND ENVIRONMENT VARIABLES</A
></H2
><P
>&#13;
     With <SPAN
CLASS="application"
>LifeLines</SPAN
> you maintain the
     database records using a screen editor. This is different than
     other genealogical programs where screens or forms are used to
     gather the data.The default screen editor for
     <SPAN
CLASS="application"
>LifeLines</SPAN
> is
     <SPAN
CLASS="application"
>vi</SPAN
>. (The <ACRONYM
CLASS="acronym"
>MS-Windows</ACRONYM
>
     version defaults instead to notepad.exe.) This can be overridden by the
     <CODE
CLASS="envar"
>ED</CODE
>, <CODE
CLASS="envar"
>EDITOR</CODE
> or
     <CODE
CLASS="envar"
>LLEDITOR</CODE
> environment variables. For example, if
     you prefer the emacs screen editor, and if you use a bourne-compatible
     shell, you may add the line:
     <KBD
CLASS="userinput"
><CODE
CLASS="envar"
>ED</CODE
>=<TT
CLASS="replaceable"
><I
>emacs</I
></TT
></KBD
>
     to your login profile file, and
     <SPAN
CLASS="application"
>LifeLines</SPAN
> will use
     <SPAN
CLASS="application"
>emacs</SPAN
> for editing.

</P
><P
>&#13;
     There are four other, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     specific environment variables. They are
     <CODE
CLASS="envar"
>LLDATABASES</CODE
>, <CODE
CLASS="envar"
>LLARCHIVES</CODE
>,
     <CODE
CLASS="envar"
>LLPROGRAMS</CODE
> and <CODE
CLASS="envar"
>LLREPORTS</CODE
>.
     <CODE
CLASS="envar"
>LLDATABASES</CODE
> and
     <CODE
CLASS="envar"
>LLPROGRAMS</CODE
> are <ACRONYM
CLASS="acronym"
>UNIX</ACRONYM
> path
     list variables.  

</P
><P
>&#13;     There is also a configuration file, and
     entries in it may be used in lieu of environment variables.
     It is ordinarily named .linesrc under <ACRONYM
CLASS="acronym"
>UNIX</ACRONYM
>,
     and lines.cfg under <ACRONYM
CLASS="acronym"
>MS-Windows</ACRONYM
>.
     A sample configuration file should have been included
     in the distribution.
</P
><P
>&#13;     See the section on System and User properties
     for more details.
</P
><P
>&#13;
     <CODE
CLASS="envar"
>LLDATABASES</CODE
> can be set to a list of directories
     that hold <SPAN
CLASS="application"
>LifeLines</SPAN
> databases. When
     you execute the <SPAN
CLASS="application"
>LifeLines</SPAN
> program,
     these directories will be searched in turn for the database
     mentioned on the command line. For example,
     <KBD
CLASS="userinput"
><CODE
CLASS="envar"
>LLDATABASES</CODE
>=<TT
CLASS="replaceable"
><I
>.:/home/ttw4/LifeLines/Databases</I
></TT
></KBD
>
     indicates that databases should be searched for in the current
     directory first, and if not found there, then searched for in:
     <TT
CLASS="filename"
>/home/ttw4/LifeLines/Databases</TT
>

</P
><P
>&#13;
     Each <SPAN
CLASS="application"
>LifeLines</SPAN
> database is
     implemented as a directory with specific contents. The
     <CODE
CLASS="envar"
>LLDATABASES</CODE
> variable should be set to a list of
     directories that contain these database directories, not to a
     list of database directories themselves.

</P
><P
>&#13;
     The environment variable <CODE
CLASS="envar"
>LLPROGRAMS</CODE
> is used in
     the same way, but to specify the search path for
     <SPAN
CLASS="application"
>LifeLines</SPAN
> report generating and
     other programs (described later).

</P
><P
>&#13;
     <CODE
CLASS="envar"
>LLARCHIVES</CODE
> and <CODE
CLASS="envar"
>LLREPORTS</CODE
> can
     each be set to specify a single
     directory. <CODE
CLASS="envar"
>LLARCHIVES</CODE
> is used to select a
     directory where all database backup files will be stored, and
     <CODE
CLASS="envar"
>LLREPORTS</CODE
> is used to select a directory where
     all generated reports and program outputs will be placed.

</P
><P
>&#13;
     New databases without explicit paths will be created in the
     first directory listed in the LLDATABASES path. (This is a 
     change; versions from 3.0.6 to 3.0.31 used a now obsolete
     variable LLNEWDBDIR).

</P
><P
>&#13;
     You are not required to use these environment variables; when
     a variable is not defined,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> uses the current
     directory as its default value. If you do use the variables,
     you can override their use by specifying files and directories
     as either absolute or relative paths.

</P
><P
>&#13;
     You may use the configuration file in
     lieu of environment variables. This is especially oriented towards
     users on <ACRONYM
CLASS="acronym"
>MS-Windows</ACRONYM
> systems, on which
     environment variables are not as common a configuration technique.

</P
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> uses the curses library
     for terminal independent I/O. This requires you to specify
     your terminal type with the <CODE
CLASS="envar"
>TERM</CODE
> environment
     variable. (This is not relevant in the <ACRONYM
CLASS="acronym"
>MS-Windows</ACRONYM
>
     version.)

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN480"
>1.9. BASICS OF BROWSING</A
></H2
><P
>&#13;
     You will use the browsing screens of
     <SPAN
CLASS="application"
>LifeLines</SPAN
> most of the time. When in
     these modes you can quickly search for or browse through the
     persons and families in the database. When you find a person
     or family you are interested in, you can then edit their
     records.

</P
><P
>&#13;     The browsing screens also allow you to add new persons and
     families to the database, add spouses to families, add
     children to families, swap the order of spouses and children,
     merge persons and merge families, and perform other
     operations. The browsing screens also lets you remove spouses
     from families and remove children from families.
</P
><P
>&#13;     There are six browsing screens. The person and family screens
     concentrate on a single person and family, respectively. The
     list screen allows you to browse through a list of persons. The
     two person browse screen shows two persons at once, and the
     two family browse screen shows two families at once. The
     auxiliary screen is used browsing any other type of records
     (e.g., events, sources, notes).

</P
><P
>&#13;     Each browsing screen has multiple
     view modes. The view mode affects how the information is displayed
     on the screen, but does not affect the menu choices available at
     the bottom of the screen. Menu commands are available on each screen
     to change amongst the view modes available for that screen.
</P
><P
>&#13;     The person screen has the most view modes. It has normal mode,
     which shows a summary of the vital records of the person. It (like
     all other screens) has GEDCOM mode, which shows the actual GEDCOM
     data of the record, and also expanded GEDCOM mode, which shows the
     actual GEDCOM data, but augments it with information on each line
     that contains a cross-reference (GEDCOM xref). It has two pedigree
     or tree modes, one showing an ancestral tree and one showing a
     descendant tree. The depth of the pedigree trees shown may be
     adjusted via menu commands.
</P
><P
>&#13;     The two person browse screen has the same modes as the person
     screen.
</P
><P
>&#13;     The two family browse screen and tandem family screen alike have
     normal mode (showing a summary of vitals), GEDCOM mode, and
     expanded GEDCOM mode.
</P
><P
>&#13;     The auxiliary screen has only GEDCOM mode and expanded GEDCOM mode.
     (The list screen has no view modes at present).
</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN491"
>1.10. IDENTIFYING A PERSON OR LIST OF PERSONS TO BROWSE</A
></H2
><P
>&#13;
     To enter the browsing modes from the main menu strike
     b. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify a
     person or list of persons to browse to:

<PRE
CLASS="screen"
>&#13;Please identify person or persons to browse to.
Enter name, key, refn or list:
</PRE
>

</P
><P
>&#13;
     Enter either a name or partial name, or an internal key value,
     or a user-defined reference key (described later) or the name
     of a previously defined list of persons (described later), and
     strike return.

</P
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> allows wide flexibility
     in how to enter names. You may enter a name in upper or lower
     case or any combination. You may leave out all but the first
     given name, and, for given names, you may leave out any
     letters except the first. You may leave vowels out of the
     surname, and after four or five consonants have been typed,
     you may leave them out too. You must separate the given names
     from the surname by a slash, and if you enter given names
     after the surname (as in Chinese names), or any modifiers
     (such as Jr, Sr, IV, etc.), they must be separated from the
     surname by another slash. Here are a few of the ways I can
     enter my name:

<DIV
CLASS="example"
><A
NAME="AEN499"
></A
><P
><B
>Example 1-7. 
Example of entering a name
</B
></P
><P
CLASS="literallayout"
><br>
Thomas&nbsp;Trask&nbsp;/Wetmore/&nbsp;IV<br>
thomas/wetmore/iv<br>
t&nbsp;t/wetmr/i<br>
th&nbsp;tr/Wetmore<br>
t/wtmr/iv<br>
</P
></DIV
>

</P
><P
>&#13;
     You may browse to the list of all persons with the same
     surname by using the * character as the first initial. For
     example:

<DIV
CLASS="example"
><A
NAME="AEN503"
></A
><P
><B
>Example 1-8. 
Example of using wildcard in browsing
</B
></P
><P
CLASS="literallayout"
>*/wetmore</P
></DIV
>matches all
     persons with surname Wetmore. This is the only wildcard
     feature supported in browsing. (However, the search operation
     provides some simple wildcards for
     finding individual name fragments, or searching by user-defined
     reference keys. The search operation is accessed via a different
     choice off of the main menu.)

</P
><P
>&#13;
     After you enter a name, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     searches for all persons who match. There are three
     possibilities: no one matches; one person matches; or more
     than one person matches. In the first case
     <SPAN
CLASS="application"
>LifeLines</SPAN
> writes: 
     <PRE
CLASS="screen"
>There is no one in the database with that name or key.</PRE
>
     and leaves you in the main menu.

</P
><P
>&#13;
     If one person matches, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     enters the person browse mode displaying the matched
     person. If more than one person matches,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> enters the list browsing
     mode with the list of matching persons.

</P
><P
>&#13;
     You may also identify a person by entering his or her
     internal, cross-reference key value. The internal key values
     of all person records are an I followed by digits.
     When you enter a key value you may omit the I.
     If <SPAN
CLASS="application"
>LifeLines</SPAN
> finds a person with
     the key value you provide,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> enters the person
     browsing mode displaying that person.  You can also browse to
     a Family, Source, or Note by entering its key, but you must
     include the letter identifing the key type, thus F11, S1, or N3
     would browse to the family, source or note corresponding to the key
     if it exists.

</P
><P
>&#13;
     The browse command b is also available from most browsing
     modes. The command works the same way from those modes as it
     does from the main menu.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN517"
>1.11. ZIP IDENTIFYING A NEW PERSON</A
></H2
><P
>&#13;
     Some <SPAN
CLASS="application"
>LifeLines</SPAN
> operations need you
     to identify a person, not for the purpose of browsing, but for
     the purpose of completing an operation you have requested. For
     example, when you add a child to a family,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> may ask you to identify
     the child. When this happens a panel pops up that asks you to
     identify a person. You respond by typing a name or key exactly
     as you would for the b command. If no one matches,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> returns to the previous
     browsing mode. If the name matches persons in the database
     <SPAN
CLASS="application"
>LifeLines</SPAN
> displays something like:

<PRE
CLASS="screen"
>&#13;Please choose from among these records.
  &#62;Thomas Trask Wetmore, b. 1826, N.B. (42)
   Thomas Trask Wetmore IV, b. 1949, Conn. (1)
   Thomas Trask Wetmore III, b. 1925, Conn. (6)
   Thomas Trask Wetmore Jr, b. 1896, Conn. (11)
   Thomas Trask Wetmore Sr, b. 1866, N.S. (23)
   Thomas Trask Wetmore V, b. 1982, Mass. (5)
_______________________________________________
Commands: j Move down k Move up i Select q Quit
</PRE
>


</P
><P
>&#13;
     Use the j and k commands to move the selection cursor (&#62;) to
     the correct person, and then use the i command to select that
     person. There may be more persons in the list than you can see
     at once. If this is so then you can use the j and k commands
     to scroll through the full list. If you don't find the proper
     person, use the q command and
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks whether you want to
     enter another name.

</P
><P
>&#13;
     With version 3.0.15, lists may also be navigated with the up
     and down arrows, PageUp and PageDown keys, Home and End keys, and
     the Enter key. Shift-PageUp and Shift-PageDown move more than one
     page at a time in a given direction. The keyboard equivalents are
     j=UpArrow, k=DownArrow, u=PageUp, d=PageDown, ^=Home, $=End,
     U=Shift-PageUp, D=Shift-PageDown, i=Enter.

</P
><P
>&#13;
     When <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a list of
     names for you to select from, it tries to add extra
     information to the name; this helps determine which name to
     choose, and is important in databases where many persons have
     the same name. <SPAN
CLASS="application"
>LifeLines</SPAN
> also
     places the person's key value at the end of each menu line;
     this may be helpful in large databases.

</P
><P
>&#13;
     Some browse screens provide the z command, which allows you to
     browse to a new person using the zip style of identification
     rather than the b style.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN532"
>1.12. BROWSE DISPLAY BASICS</A
></H2
><P
>&#13;
     The screen display for each browsing screen is made up of
     panels. At the bottom of each display is a message panel used
     for one line messages. Each display contains one or two data
     panels showing information from the database. And each display
     has a panel with the operation menu available for that screen.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN535"
>1.13. PERSON BROWSE SCREEN</A
></H2
><P
>&#13;
     After you identify a person to browse to,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> enters the person browse
     screen. The top panel in the display gives basic information
     about the person (in the normal, or vitals, mode, which is the
     default). The middle panel provides a menu of commands.
     For example:

<PRE
CLASS="screen"
>&#13;person: Thomas Trask WETMORE Sr (25)
  born: 13 March 1866, St. Mary's Bay, Digby, Nova Scotia
  died: 17 February 1947, New London, New London, Connecticut
  father: Daniel Lorenzo WETMORE, b. 1821, N.S., d. 1903, Conn. (48)
  mother: Mary Ann DOTY, b. 1824, N.S., d. 1897, Conn. (59)
  spouse: Margaret Ellen KANEEN, b. 1855, Eng., d. 1900, Conn. (26)
    child: Portia Louise WETMORE, b. 1892, Conn., d. 1921, Conn. (27)
    child: Thomas Trask WETMORE, b. 1896, Conn., d. 1970, Conn. (17)
  spouse: Arleen M KEENEY, m. 1914, Conn. (75)
_______________________________________________________________________
Please choose an operation:             (pg 1/3)
  e  Edit the person       g  Browse to family    p  Pedigree mode
  f  Browse to father      u  Browse to parents   n  Create new person
  m  Browse to mother      b  Browse to persons   a  Create new family
  s  Browse to spouse/s    h  Add as spouse       x  Swap two families
  c  Browse to children    i  Add as child        tt Enter tandem mode
  o  Browse to older sib   r  Remove as spouse    ?  Other menu choices
  y  Browse to younger sib d  Remove as child     q  Return to main menu
_______________________________________________________________________
LifeLines -- Person Browse Screen
</PRE
>


</P
><P
>&#13;
The commands perform a wide variety of functions.

</P
><P
>&#13;
<DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>e</B
> <SPAN
CLASS="action"
>Edit the person. </SPAN
></B
></DT
><DD
><P
>&#13;
     Edit the person's database
     record. <SPAN
CLASS="application"
>LifeLines</SPAN
> puts the record
     in a file, and then runs a screen editor so you can edit the
     record. When you return from the editor,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to confirm any
     changes; the person is changed only if you answer yes.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>f</B
> <SPAN
CLASS="action"
>Browse to father.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the person's father. If the father isn't in the
     database, <SPAN
CLASS="application"
>LifeLines</SPAN
> doesn't change
     the display. If there are more than one father,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to select one.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>m</B
> <SPAN
CLASS="action"
>Browse to mother.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the person's mother. If the mother isn't in the
     database, <SPAN
CLASS="application"
>LifeLines</SPAN
> doesn't change
     the display. If there are more than one mother,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to select one.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>s</B
> <SPAN
CLASS="action"
>Browse to spouse/s.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the person's spouse. If the person has more than one
     spouse, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     select one. If the person has no spouse, the display does not
     change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>c</B
> <SPAN
CLASS="action"
>Browse to children.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to one of the person's children. If there is more than
     one child, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     select one. If the person has no children, the display does
     not change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>o</B
> <SPAN
CLASS="action"
>Browse to older sib.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the person's next older sibling. If the person has
     no such sibling, the display does not change. Only siblings
     from the same family are browsed by this command.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>y</B
> <SPAN
CLASS="action"
>Browse to younger sib.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the person's next younger sibling. If the person has
     no such sibling, the display does not change. Only siblings
     from the same family are browsed by this command.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>g</B
> <SPAN
CLASS="action"
>Browse to family.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the family the person is a spouse or parent in, and
     switch to the family browse mode. If the person is in more
     than one family, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you
     to identify which one. If the person is not a spouse or parent
     in any family, the display does not change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>u</B
> <SPAN
CLASS="action"
>Browse to parents.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the family the person is a child in, and switch to
     the family browse mode. If the person is not a child in a
     family, the display does not change. If the person is a child
     in more than one family, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     asks you to identify which one.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>b</B
> <SPAN
CLASS="action"
>Browse to persons.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to a new person or list of
     persons. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify a person or persons by name, key or list name, and
     depending on how many persons are identified, switches either
     to the list browse mode, or remains in the person browse mode.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>h</B
> <SPAN
CLASS="action"
>Add as spouse.</SPAN
></B
></DT
><DD
><P
>&#13;
     Add the person as a spouse/parent to an existing
     family. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the family, and then asks you to confirm the request.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>i</B
> <SPAN
CLASS="action"
>Add as child.</SPAN
></B
></DT
><DD
><P
>&#13;
     Add the person as a child to an existing family. The person
     may already be a child in another
     family. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the family, and then asks you to confirm the request.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>r</B
> <SPAN
CLASS="action"
>Remove as spouse.</SPAN
></B
></DT
><DD
><P
>&#13;
     Remove the person as a spouse or parent from an existing
     family. If the person is a spouse or parent in more than one
     family, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the family.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>d</B
> <SPAN
CLASS="action"
>Remove as child.</SPAN
></B
></DT
><DD
><P
>&#13;
Remove the person as a child in an existing family.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>n</B
> <SPAN
CLASS="action"
>Create new person.</SPAN
></B
></DT
><DD
><P
>&#13;
     Create and add a new person to the
     database. <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a
     record template and puts you into the screen editor to edit
     the record. When you return from the editor,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to confirm the
     operation. If you do, the new person is added and becomes the
     current person. If not, the new person is not added, and
     <SPAN
CLASS="application"
>LifeLines</SPAN
> returns to the original
     display.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>a</B
> <SPAN
CLASS="action"
>Create new family.</SPAN
></B
></DT
><DD
><P
>&#13;
     Create and add a new family to the database. The new family
     may have the current person as either a spouse/parent or as a
     child; <SPAN
CLASS="application"
>LifeLines</SPAN
> asks which. If you
     choose to create a family with the person as a spouse/parent,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the
     other spouse if he or she is known. In either case
     <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a family
     template, and places you in the screen editor.  When you
     return from the editor, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     asks you to confirm the operation. If you do,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> adds the family and
     shifts into family browse mode. If the command you ran just
     before the a command were the n command, and you choose to
     create a family with the person as a spouse/parent,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> guesses that the other
     spouse in the family will be the person displayed just before
     the new person was
     created. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you if this
     is the case, and if so, automatically make that person the
     other spouse in the new family. If this is not the case,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the
     other spouse.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>p</B
> <SPAN
CLASS="action"
>Pedigree mode.</SPAN
></B
></DT
><DD
><P
>&#13;
     Change to pedigree browse mode. The person becomes the root
     person in the pedigree display.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>x</B
> <SPAN
CLASS="action"
>Swap two families.</SPAN
></B
></DT
><DD
><P
>&#13;
     Swap (change chronological order) any two families that the
     person belongs to as a spouse or
     parent. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the two families and then swaps them.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>tt</B
> <SPAN
CLASS="action"
>Enter tandem mode.</SPAN
></B
></DT
><DD
><P
>&#13;
     Change to the tandem person browse
     mode. <SPAN
CLASS="application"
>LifeLines</SPAN
> first asks you to
     identify the second person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>?</B
> <SPAN
CLASS="action"
>Other menu choices.</SPAN
></B
></DT
><DD
><P
>&#13;     Go to the next page of menu choices. This will have no effect on the
     upper (data) portion of the screen, but it allows you to page through
     all available commands for this display screen.
</P
></DD
><DT
><B
><B
CLASS="keycap"
>q</B
> <SPAN
CLASS="action"
>Return to main menu.</SPAN
></B
></DT
><DD
><P
>&#13;
     Return to the <SPAN
CLASS="application"
>LifeLines</SPAN
> main menu.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>z</B
> <SPAN
CLASS="action"
>Zip browse to person.</SPAN
></B
></DT
><DD
><P
>&#13;
        Zip browse to a new person.
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
        identify a person by name or key value, and if you do so,
        browses to that person.

</P
></DD
></DL
></DIV
>

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN704"
>1.14. LIST BROWSE SCREEN</A
></H2
><P
>&#13;
     This browse screen handles lists of persons. The top panel shows
     information about one person in the list.  The left panel
     shows a list of up to 12 persons. The person shown in the top
     panel is identified by the &#62; character. The right panel is the
     menu of available commands.

<PRE
CLASS="screen"
>&#13;person: Thomas Trask WETMORE Sr (25)
  born: 13 March 1866, St. Mary's Bay, Digby, Nova Scotia
  died: 17 February 1947, New London, New London, Connecticut
  father: Daniel Lorenzo WETMORE, b. 1821, N.S., d. 1903, Conn. (48)
  mother: Mary Ann DOTY, b. 1824, N.S., d. 1897, Conn. (59)
  spouse: Margaret Ellen KANEEN, b. 1855, Eng., d. 1900, Conn. (26)
_______________________________________________________________________
  Thomas Trask WETMORE (42)                Choose an operation:
  Thomas Trask WETMORE III (6)              j Move down list
  Thomas Trask WETMORE IV (1)               k Move up list
  Thomas Trask WETMORE (11)                 e Edit this person
 &#62;Thomas Trask WETMORE Sr (23)              i Browse this person
  Thomas Trask WETMORE (5)                  m Mark this person
                                            r Remove from list
                                            t Enter tandem mode
                                            n Name this list
                                            b Browse new persons
                                            a Add to this list
                                            x Swap mark/current
                                            q Return to main menu
_______________________________________________________________________
LifeLines -- List Browse Screen
</PRE
>


</P
><P
>&#13;
<DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>j</B
> <SPAN
CLASS="action"
>Move down list.</SPAN
></B
></DT
><DD
><P
>&#13;
     Move down the list one person. The list panel is only large
     enough to show 12 persons. However, the list may contain many
     more persons. Use the <B
CLASS="keycap"
>j</B
> and
     <B
CLASS="keycap"
>k</B
> commands to scroll to these other persons.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>k</B
> <SPAN
CLASS="action"
>Move up list.</SPAN
></B
></DT
><DD
><P
>&#13;
     Move up the list one person. The list panel is only large
     enough to show 12 persons. However, the list may contain many
     more persons. Use the <B
CLASS="keycap"
>j</B
> and
     <B
CLASS="keycap"
>k</B
> commands to scroll to these other persons.

</P
><P
>&#13;
     With version 3.0.15, lists may also be navigated with the up
     and down arrows, PageUp and PageDown keys, Home and End keys, and
     the Enter key. Shift-PageUp and Shift-PageDown move more than one
     page at a time in a given direction. The keyboard equivalents are
     j=UpArrow, k=DownArrow, u=PageUp, d=PageDown, ^=Home, $=End,
     U=Shift-PageUp, D=Shift-PageDown, i=Enter.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>e</B
> <SPAN
CLASS="action"
>Edit this person.</SPAN
></B
></DT
><DD
><P
>&#13;
     Edit the displayed person's database
     record. <SPAN
CLASS="application"
>LifeLines</SPAN
> runs the editor
     on the person's record. When you return from the editor,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to confirm any
     changes, and then leaves you in the list browse screen.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>i</B
> <SPAN
CLASS="action"
>Browse this person.</SPAN
></B
></DT
><DD
><P
>&#13;
     Change to the person browse screen with the current person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>m</B
> <SPAN
CLASS="action"
>Mark this person.</SPAN
></B
></DT
><DD
><P
>&#13;
     Mark the current person if he/she is not marked; unmark the
     person is he/she is.  The marked person is shown with an x by
     his/her name. Marked persons are used by the t and x
     commands. Only one person may be marked at a time.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>r</B
> <SPAN
CLASS="action"
>Remove from list.</SPAN
></B
></DT
><DD
><P
>&#13;
     Remove the current person from the browse list (not from the database).

</P
></DD
><DT
><B
><B
CLASS="keycap"
>t</B
> <SPAN
CLASS="action"
>Enter tandem mode.</SPAN
></B
></DT
><DD
><P
>&#13;
     Change to the tandem person mode with the current person and
     the marked person as the two persons. If no person is marked there is no change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>n</B
> <SPAN
CLASS="action"
>Name this list.</SPAN
></B
></DT
><DD
><P
>&#13;
     Lists of persons may be named, allowing you to quickly browse
     back to them by giving a list name in response to the b
     command from different
     modes. <SPAN
CLASS="application"
>LifeLines</SPAN
> will prompt you
     for the name. List names are most convenient when short.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>b</B
> <SPAN
CLASS="action"
>Browse new persons.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to a new person or list of persons. You can identify a
     person or list of persons by name, internal or user key or by
     list name.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>a</B
> <SPAN
CLASS="action"
>Add to this list.</SPAN
></B
></DT
><DD
><P
>&#13;
     Add more persons to the current browse
     list. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify a new person or list of persons by name, key or list
     name, and they are added to and name-sorted into the current
     list.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>x</B
> <SPAN
CLASS="action"
>Swap mark/current.</SPAN
></B
></DT
><DD
><P
>&#13;
     Swap the current person with the marked person in the list.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>q</B
> <SPAN
CLASS="action"
>Return to main menu.</SPAN
></B
></DT
><DD
><P
>&#13;
     Return to the <SPAN
CLASS="application"
>LifeLines</SPAN
> main menu.

</P
></DD
></DL
></DIV
>

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN792"
>1.15. FAMILY BROWSE SCREEN</A
></H2
><P
>&#13;
     This browse screen displays information about a family. The top
     panel shows basic information about the family. The bottom
     panel shows the menu of available commands.  If the database contains
     more than two parents for this family only the first two are displayed.

<PRE
CLASS="screen"
>&#13;father: Thomas Trask WETMORE IV (1)
  born: 18 December 1949, New London, New London, Connecticut
  died:
mother: Luann Frances GRENDA (2)
  born: 10 July 1949, Pittsburgh, Allegheny, Pennsylvania
  died:
married: 1 August 1970, Governors Island, New York, New York
  child: Anna Vivian Wetmore, b. 1974, Alaska (3)
  child: Marie Margaret WETMORE, b. 1979, Conn. (4)
  child: Thomas Trask WETMORE V, b. 1982, Mass. (5)
_______________________________________________________________________
Please choose an operation:            (pg 1/4)
 e  Edit the family       %s  Add source           r  Remove spouse from
 f  Browse to father      %e  Add event            d  Remove child from
 m  Browse to mother      %o  Add other            x  Swap two children
 c  Browse to children    s  Add spouse to family  ?  Other menu choices
 n  Create new person     a  Add child to family   q  Return to main menu
_______________________________________________________________________
LifeLines -- Family Browse Screen (* toggles menu)

</PRE
>
</P
><P
>&#13;
<DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>e</B
> <SPAN
CLASS="action"
>Edit the family.</SPAN
></B
></DT
><DD
><P
>&#13;
     Edit the family's record. <SPAN
CLASS="application"
>LifeLines</SPAN
>
     writes the record to a file and puts you into an editor to
     edit the file. When you return from the editor,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to confirm the
     update; the family is changed only if you do so.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>f</B
> <SPAN
CLASS="action"
>Browse to father.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to the father/husband of the family, switching to
     person browse screen. If the father is not there, there is no change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>m</B
><SPAN
CLASS="action"
>Browse to mother.</SPAN
>
         </B
></DT
><DD
><P
>&#13;
     Browse to the mother/wife of the family, switching to person
     browse screen. If the mother is not there, there is no change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>c</B
> <SPAN
CLASS="action"
>Browse to children.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to a child in the family, switching to the person
     browse screen. If the family has more than one child,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify a
     specific child.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>n</B
> <SPAN
CLASS="action"
>Create new person.</SPAN
></B
></DT
><DD
><P
>&#13;
     Create and add a new person to the
     database. <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a
     record template and puts you into the screen editor to edit
     the record. When you return from the editor,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to confirm the
     operation. If you do, the new person is added to the
     database. If not, the new person is not added. In both cases
     the display does not change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>s</B
> <SPAN
CLASS="action"
>Add spouse to family.</SPAN
></B
></DT
><DD
><P
>&#13;
     Add a spouse to the
     family. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the new spouse. If the command you ran just before
     the s command were the n command,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> guesses that the new
     spouse will be the person just
     created. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks if this is
     the case, and if so, makes that person the second spouse in
     the family. If not, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks
     you to identify the other spouse.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>a</B
> <SPAN
CLASS="action"
>Add child to family.</SPAN
></B
></DT
><DD
><P
>&#13;
     Add a child to the
     family. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the new child. If the command you ran just before the
     a command were the n command,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> guesses that the new
     child will be the person just
     created. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks if this is
     the case, and if so, adds that child to the family. If not,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the
     child. If the family already has children,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> also asks where to place
     the new child in the family.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>r</B
> <SPAN
CLASS="action"
>Remove spouse from.</SPAN
></B
></DT
><DD
><P
>&#13;
     Remove a parent/spouse from the
     family. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the person, and if you do, removes him or her. The
     person is not removed from the database.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>d</B
> <SPAN
CLASS="action"
>Remove child from.</SPAN
></B
></DT
><DD
><P
>&#13;
     Remove a child from the
     family. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the child should, and if you do, removes the child
     from the family. The person is not removed from the database.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>x</B
> <SPAN
CLASS="action"
>Swap two children.</SPAN
></B
></DT
><DD
><P
>&#13;
     Swap (change the chronological order) of any two children in
     the family.  <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify the two children and then swaps them.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>t</B
> <SPAN
CLASS="action"
>Enter family tandem.</SPAN
></B
></DT
><DD
><P
>&#13;
     This command takes you to the tandem family browse
     screen. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to
     identify a second family, and then takes you to the tandem
     family screen, displaying both the two families.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>b</B
> <SPAN
CLASS="action"
>Browse to persons.</SPAN
></B
></DT
><DD
><P
>&#13;
     Browse to a new person or list of persons. You can identify a
     person or list by name, by key, or by list name. If you
     successfully identify a new person or persons you will switch
     into the person or list browse screens.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>z</B
> <SPAN
CLASS="action"
>Browse to person.</SPAN
></B
></DT
><DD
><P
>&#13;
     Zip browse to a new person.
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify a
     person by name or key value, and if you do, browses to that
     person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>q</B
> <SPAN
CLASS="action"
>Return to main menu.</SPAN
></B
></DT
><DD
><P
>&#13;
     Return to the <SPAN
CLASS="application"
>LifeLines</SPAN
> main menu.

</P
></DD
></DL
></DIV
>

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN902"
>1.16. TANDEM PERSON BROWSE MODE</A
></H2
><P
>&#13;
     The tandem person browse screen displays information about two
     persons. Its main use it to support the person merging
     operation. The top two panels show two persons in the format
     used in the person and list screen displays. The bottom panel
     gives the menu of available commands. For example:


<PRE
CLASS="screen"
>&#13;  person: Thomas Trask WETMORE Sr (25)
  born: 13 March 1866, St. Mary's Bay, Digby, Nova Scotia
  died: 17 February 1947, New London, New London, Connecticut
  father: Daniel Lorenzo WETMORE, b. 1821, N.S., d. 1903, Conn. (48)
  mother: Mary Ann DOTY, b. 1824, N.S., d. 1897, Conn. (59)
  spouse: Margaret Ellen KANEEN, b. 1855, Eng., d. 1900, Conn. (26)
______________________________________________________________________
person: Thomas Trask WETMORE IV (1)
  born: 18 December 1949, New London, New London, Connecticut
  died:
  father: Thomas Trask WETMORE III, b. 1925, Conn. (6)
  mother: Joan Marie HANCOCK, b. 1928, Conn. (7)
  spouse: Luann Frances GRENDA, m. 1970, N.Y. (2)
______________________________________________________________________
Please choose an operation:
 e Edit top person    s Browse top spouse/s   a Add family
 t Browse to top      c Browse top children   j Merge bottom to top
 f Browse top father  b Browse to persons     x Switch top/bottom
 m Browse top mother  d Copy top to bottom    q Return to main menu
______________________________________________________________________
LifeLines - Two Person Browse Screen
</PRE
>


</P
><P
>&#13;
<DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>e</B
> <SPAN
CLASS="action"
>Edit top person.</SPAN
></B
></DT
><DD
><P
>&#13;
     Edit the top person's
     record. <SPAN
CLASS="application"
>LifeLines</SPAN
> writes the record
     to a file, and puts you in the screen editor to edit the
     file. When you return from the editor,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to confirm the
     update; the person is changed only if you do so.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>t</B
> <SPAN
CLASS="action"
>Browse to top.</SPAN
></B
></DT
><DD
><P
>&#13;
     Switch to the person display with the top person as current person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>f</B
> <SPAN
CLASS="action"
>Browse top father.</SPAN
></B
></DT
><DD
><P
>&#13;
     Replace the top person with his/her father.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>m</B
> <SPAN
CLASS="action"
>Browse top mother.</SPAN
></B
></DT
><DD
><P
>&#13;
     Replace the top person with his/her mother.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>s</B
> <SPAN
CLASS="action"
>Browse top spouse/s.</SPAN
></B
></DT
><DD
><P
>&#13;
     Replace the the top person with his/her spouse. If the person
     has more than one spouse, <SPAN
CLASS="application"
>LifeLines</SPAN
>
     asks you to identify one.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>c</B
> <SPAN
CLASS="action"
>Browse top children.</SPAN
></B
></DT
><DD
><P
>&#13;
Replace the top person with one of his/her children. If the person has more
than one child, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the one.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>b</B
> <SPAN
CLASS="action"
>Browse to persons.</SPAN
></B
></DT
><DD
><P
>&#13;
Browse to a new person or list of persons. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify a new
person or persons by name, key or list name, and then does as described in the section on identifying a
person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>d</B
> <SPAN
CLASS="action"
>Copy top to bottom.</SPAN
></B
></DT
><DD
><P
>&#13;
Copy the top person into the bottom person. A new person is not created; the same
person is displayed twice.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>a</B
> <SPAN
CLASS="action"
>Add family.</SPAN
></B
></DT
><DD
><P
>&#13;
Create a new family record; <SPAN
CLASS="application"
>LifeLines</SPAN
> assumes the two displayed persons are to become
the spouses/parents in the new family; they must be of opposite sex.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>j</B
> <SPAN
CLASS="action"
>Merge bottom to top.</SPAN
></B
></DT
><DD
><P
>&#13;
Merge the bottom person into the top person. <SPAN
CLASS="application"
>LifeLines</SPAN
> combines the two person
records and places you in the screen editor to edit the combined record. When you are done, if you
confirm the operation, <SPAN
CLASS="application"
>LifeLines</SPAN
> removes the bottom person from the database, and the top person is
given the combined record. See the section on merging.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>x</B
> <SPAN
CLASS="action"
>Switch top/bottom.</SPAN
></B
></DT
><DD
><P
>&#13;
Swap the two persons in the display.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>q</B
> <SPAN
CLASS="action"
>Return to main menu.</SPAN
></B
></DT
><DD
><P
>&#13;
Return to the <SPAN
CLASS="application"
>LifeLines</SPAN
> main menu.

</P
></DD
></DL
></DIV
>

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN989"
>1.17. TANDEM FAMILY BROWSE MODE</A
></H2
><P
>&#13;
The tandem family browse screen displays information about two families. Its main use it to support the
family merging operation.The top two panels provide information about the two families you are
browsing, and the bottom panel holds the menu of available commands. For example:
<PRE
CLASS="screen"
>&#13;father: Thomas Trask WETMORE IV (1)
  born: 18 December 1949, New London, New London, Connecticut
mother: Luann Frances GRENDA (2)
  born: 10 July 1949, Pittsburgh, Allegheny, Pennsylvania
married: 1 August 1970, Governors Island, New York, New York
  child: Anna Vivian WETMORE, b. 1974, Alaska (3)
__________________________________________________________________
father: Thomas Trask WETMORE III (6)
  born: 26 October 1925, New London, New London, Connecticut
wife: Joan Marie Hancock (7)
  born: 6 June 1928, New London, New London, Connecticut
married: 5 February 1949, New London, New London, Connecticut
  child: Thomas Trask WETMORE IV, b. 1949, Conn. (1)
__________________________________________________________________
Please choose an operation:            (pg 1/3)
 e  Edit top person       m  Browse to mothers     )b Scroll bottom down
 t  Browse to top         (t Scroll top up         (( Scroll both up
 b  Browse to bottom      )t Scroll top down       ?  Other menu choices
 f  Browse to fathers     (b Scroll bottom up      q  Return to main menu
__________________________________________________________________
LifeLines -- Two Family Browse Screen (* toggles menu)
</PRE
>


</P
><P
>&#13;
<DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>e</B
> <SPAN
CLASS="action"
>Edit top family.</SPAN
></B
></DT
><DD
><P
>&#13;
This command lets you edit the top family's record. <SPAN
CLASS="application"
>LifeLines</SPAN
> writes the record into
a file, and then puts you into an editor to edit that information. When you return from the editor,
<SPAN
CLASS="application"
>LifeLines</SPAN
> asks you whether you are sure you want to update the family in the database. The family
is changed only if you answer yes.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>t</B
> <SPAN
CLASS="action"
>Browse to top.</SPAN
></B
></DT
><DD
><P
>&#13;
Change to the family browse screen with the top family the current family.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>b</B
> <SPAN
CLASS="action"
>Browse to bottom.</SPAN
></B
></DT
><DD
><P
>&#13;
Change to the single family browse screen with the bottom family the current
family.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>f</B
> <SPAN
CLASS="action"
>Browse to fathers.</SPAN
></B
></DT
><DD
><P
>&#13;
Change to the tandem person screen with the fathers of the two
families as the two persons.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>m</B
> <SPAN
CLASS="action"
>Browse to mothers.</SPAN
></B
></DT
><DD
><P
>&#13;
Change to the tandem person screen with the mothers of the two
families as the two persons.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>(t</B
> <SPAN
CLASS="action"
>Scroll top up.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>)t</B
> <SPAN
CLASS="action"
>Scroll top down.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>(b</B
> <SPAN
CLASS="action"
>Scroll bottom up.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>)b</B
> <SPAN
CLASS="action"
>Scroll bottom down.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>((</B
> <SPAN
CLASS="action"
>Scroll both up.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>))</B
> <SPAN
CLASS="action"
>Scroll both down.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>#</B
> <SPAN
CLASS="action"
>Toggle childnos.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>(1-9)</B
> <SPAN
CLASS="action"
>Browse to child.</SPAN
></B
></DT
><DD
><P
>&#13;
TODO

</P
></DD
><DT
><B
><B
CLASS="keycap"
>j</B
> <SPAN
CLASS="action"
>Merge bottom to top.</SPAN
></B
></DT
><DD
><P
>&#13;
Merge the bottom family into the top family. <SPAN
CLASS="application"
>LifeLines</SPAN
> combines the two
family records and places you in the screen editor to edit the combined record. When you are done, if
you confirm the operation, <SPAN
CLASS="application"
>LifeLines</SPAN
> deletes the bottom family from the database, and the top
family is given the combined record. See the section on merging.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>x</B
> <SPAN
CLASS="action"
>Switch top/bottom.</SPAN
></B
></DT
><DD
><P
>&#13;
Swap the two families in the display.

</P
><P
>&#13;   [There are some more miscellaneous commands available on the menus.]
</P
></DD
><DT
><B
><B
CLASS="keycap"
>q</B
> <SPAN
CLASS="action"
>Return to main menu.</SPAN
></B
></DT
><DD
><P
>&#13;
Return to the <SPAN
CLASS="application"
>LifeLines</SPAN
> main menu.

</P
></DD
></DL
></DIV
>

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1097"
>1.18. PEDIGREE BROWSE MODE</A
></H2
><P
>&#13;
The pedigree browse screen displays a four-generation pedigree for the current person. The top panel
holds the pedigree, and the bottom panel holds the menu of available commands. For example:
<PRE
CLASS="screen"
>&#13;                  John WETMORE [1755-1848] (32)
            Daniel Van Cott WETMORE [1791-1881] (41)
                  Anna VAN COTT [1757-1802] (33)
      Daniel Lorenzo WETMORE [1821-1903] (48)
                  Thomas TRASK [-1836] (81)
            Hannah TRASK [1797-1829] (46)
                  Susannah PORTER [1754-] (82)
Thomas Trask WETMORE Sr [1866-1947] (25)
                  Samuel DOTY [1759-] (501)
            Samuel DOTY [1787-] (74)
                  Hephzibah PORTER [1764-1853] (502)
      Mary Ann DOTY [1827-1897] (59)
                  Nathan SAVERY [1748-1826] (510)
            Lydia SAVERY [1806-] (75)
                  Deidamia SABEAN [1765-1845] (511)
__________________________________________________________________
Please choose an operation:
 e Edit the person   m Browse to mother    g Browse to family
 i Browse to person  s Browse to spouse/s  b Browse to persons
 f Browse to father  c Browse to children  q Return to main menu
__________________________________________________________________
LifeLines - Pedigree Browse Mode</PRE
>

</P
><P
>&#13;
<DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>e</B
> <SPAN
CLASS="action"
>Edit the person.</SPAN
></B
></DT
><DD
><P
>&#13;
Edit the current person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>i</B
> <SPAN
CLASS="action"
>Browse to person.</SPAN
></B
></DT
><DD
><P
>&#13;
Change to the person display mode with the current person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>f</B
> <SPAN
CLASS="action"
>Browse to father.</SPAN
></B
></DT
><DD
><P
>&#13;
Browse to the father of the current person, shifting the pedigree one
generation back. If the father is not in the database, there is no change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>m</B
> <SPAN
CLASS="action"
>Browse to mother.</SPAN
></B
></DT
><DD
><P
>&#13;
Browse to the mother of the current person, shifting the pedigree one
generation back. If the mother is not in the database, there is no change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>s</B
> <SPAN
CLASS="action"
>Browse to spouse/s.</SPAN
></B
></DT
><DD
><P
>&#13;
Browse to a spouse of the current person, shifting the display to the pedigree of
that person. If the current person has more than one spouse, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the spouse;
if the person has no spouse there is no change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>c</B
> <SPAN
CLASS="action"
>Browse to children.</SPAN
></B
></DT
><DD
><P
>&#13;
Browse to a child of the current person, shifting the pedigree one generation
forward. If the current person has more than one child, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the child; if
the person has no children there is no change.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>g</B
> <SPAN
CLASS="action"
>Browse to family.</SPAN
></B
></DT
><DD
><P
>&#13;
Change to the family display; the family will be the one that the current person
belongs to as spouse or parent. If there are more than one, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the proper
one.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>b</B
> <SPAN
CLASS="action"
>Browse to persons.</SPAN
></B
></DT
><DD
><P
>&#13;
Browse to another person or list of persons; if you identify a single person the
display remains in the pedigree display; if you identify more than one person the display changes to
the list browse mode.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>q</B
> <SPAN
CLASS="action"
>Return to main menu.</SPAN
></B
></DT
><DD
><P
>&#13;
Leave the pedigree browsing mode and return to the main menu.

</P
></DD
></DL
></DIV
>

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1160"
>1.19. SEARCH MENU</A
></H2
><P
>&#13;If you choose Search database from the main menu, <SPAN
CLASS="application"
>LifeLines</SPAN
> displays the search menu:
<PRE
CLASS="screen"
>&#13;How would you like to find a record?
  v Review visit history (12 records)
  c Review change history (3 records)
  f Full database scan
  q Return to previous menu
</PRE
>
The first two items will depend on your previous activity.  If you have
browsed to individuals or family records in the database,
the first item will appear similar to what's shown above,
if you haven't it will just contain a note that the visit history is empty.
The second item will appear similar to what's shown above if you
have changed individual records in this session 
with <SPAN
CLASS="application"
>LifeLines</SPAN
>, otherwise it will contain
a note that the change history is empty.
</P
><P
>&#13;Selecting a non-empty visit history or change history will bring up a list
of individuals (or families) that are in the history, allowing you to
browse to that individual or family. 
</P
><P
>&#13;If you choose Full database scan off the search menu, 
<SPAN
CLASS="application"
>LifeLines</SPAN
> displays the fullscan menu.
<PRE
CLASS="screen"
>&#13;What scan type?
  f  Full name scan
  n  Name fragment (whitespace-delimited) scan
  r  Refn scan
  q  Return to previous menu
</PRE
>
The first two items on this menu allow you to search all the NAME
records in the current database.
If you choose Full name scan you are prompted for a 
search pattern and then <SPAN
CLASS="application"
>LifeLines</SPAN
> searches for all 
the individual NAME records whose value matches the pattern supplied.
If you choose the Name fragment scan, you will be prompted for a 
search pattern and then <SPAN
CLASS="application"
>LifeLines</SPAN
> will search for
whitespace delimited words within individual NAME records that match the
pattern supplied.
</P
><DIV
CLASS="sect2"
><HR><H3
CLASS="sect2"
><A
NAME="AEN1172"
>1.19.1. Search Patterns</A
></H3
><P
>&#13;The pattern supplied to the search commands is used to match against
the names in the database.  The following characters have special meaning
when used in a pattern:
<DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN1175"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL
WIDTH="48"><COL><TBODY
><TR
><TD
>?</TD
><TD
>Matches any single character</TD
></TR
><TR
><TD
>*</TD
><TD
>&#13;Matches zero or more occurrences of any character
</TD
></TR
><TR
><TD
>SUB</TD
><TD
>&#13;a control Z (^Z) is similar to '*', this matches zero
or more occurences of any characters other than '.'.
(of course you probably can't type this on unix)
</TD
></TR
><TR
><TD
>[ab]</TD
><TD
>&#13;A set of characters enclosed in square brackets
matches the single characters listed between the
brackets.  If the dash '-' character is to be included,
it must immediately follow the opening bracket '['.
If the closing bracket ']' character is to be included,
it must be preceded by a quote '`'.
</TD
></TR
><TR
><TD
>[a-z]</TD
><TD
>&#13;Matches a single character in the range 'a' to 'z'.
Ranges and sets may be combined within the same set of
brackets.
</TD
></TR
><TR
><TD
>!R</TD
><TD
>&#13;Matches a single character not in the range 'R'.
If range 'R' includes the dash '-' character, the dash
must immediately follow the '!'.
</TD
></TR
><TR
><TD
>!</TD
><TD
>&#13;Makes the following pattern match
any string except those what it would normally match.
</TD
></TR
><TR
><TD
>QUOTE</TD
><TD
>&#13;(On DOS this is `, on UNIX it is \)
Makes the next character a regular (nonspecial)
character.
Note that to match the quote character itself, it must
be quoted.
Note that this character must be escaped if used within
string constants ("\\").
</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
>
</P
><P
>&#13;Upper and lower case alphabetic characters are considered identical,
i.e., 'a' and 'A' match each other.
(What constitutes a lowercase letter depends on the current locale
settings.)
</P
><P
>&#13;Spaces and control characters (other than control z) are treated as normal 
characters,
</P
><P
>&#13;As an example, consider the following NAME record:
<PRE
CLASS="programlisting"
>&#13;1 NAME <KBD
CLASS="userinput"
>John /Smith/</KBD
>
</PRE
>
When doing a full name search, the value searched is the complete gedcom name 
value including the slashes used to delimit the surname.
in order to have a match, the search pattern
must match the slashes.  Thus

<PRE
CLASS="programlisting"
>&#13;*smith
</PRE
>
will not match this name, whereas
<PRE
CLASS="programlisting"
>&#13;*smith/
</PRE
>
will match.
</P
><P
>&#13;When doing a name fragment search, the slashes are removed from the surname
before trying to match the name, thus
<PRE
CLASS="programlisting"
>&#13;smith
smi*
joh*
*hn
</PRE
>
will all match this NAME record.
</P
></DIV
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1212"
>1.20. ADD OPERATION</A
></H2
><P
>&#13;
If you choose the add operation from the main menu, <SPAN
CLASS="application"
>LifeLines</SPAN
> displays the add menu:
<PRE
CLASS="screen"
>&#13;What do you want to add?
  p Person - add new person to the database
  f Family - create family record from one or two spouses
  c Child - add a child to an existing family
  s Spouse - add a spouse to an existing family
  q Quit - return to the previous menu
</PRE
>


</P
><P
>&#13;
These operations work in a straightforward way. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you the necessary questions, and lets
you cancel at any time. The operations provided by this menu are also available from the browsing
modes, and are often easier to perform there.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1219"
>1.21. DELETE OPERATION</A
></H2
><P
>&#13;
If you choose the delete operation at the main menu, <SPAN
CLASS="application"
>LifeLines</SPAN
> displays the delete menu:
<PRE
CLASS="screen"
>&#13;What do you want to delete?
  c Child - remove a child from his/her family
  s Spouse - remove a spouse from a family
  p Person - remove a person completely
  q Quit - return to the previous menu
</PRE
>


</P
><P
>&#13;
These operations also work in a straightforward way. <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you the necessary questions and
lets you cancel at any time.


</P
><P
>&#13;
You may also remove a child from his/her family, or remove a spouse/parent from his/her family,
from the person browsing mode. In both cases, only a relationship is removed, not a person. On the other
hand, the delete menu must be used if you want to completely remove a person from the database; this
cannot be done from the browsing mode.


</P
><P
>&#13;
There is no special operation for removing a family record. <SPAN
CLASS="application"
>LifeLines</SPAN
> silently removes any family
record that has no parent or child associated with it.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1229"
>1.22. CODESET CONVERSION</A
></H2
><P
>&#13;
     (This section was previously entitled CHARACTER TRANSLATION.)

</P
><P
>&#13;
     The intention is that you need only specify the internal codeset for
     each database you create (and this step may be automated via the NewDbProps
     property), and all else works pretty well without tuning. That is,
     lifelines tries to guess the correct codeset for your environment (including
     guessing the console and windows codesets when operating under MS-Windows,
     which it should do fairly well).

</P
><P
>&#13;
     However, you may encounter situations where you wish to alter the codeset
     behavior, or the codeset conversion is not operating correctly (in which case
     we hope you will report the problem to the mailing list and/or sourceforge
     bugs list).

</P
><P
>&#13;
     There are two ways to amend codeset conversion. The first method is by
     changing configuration variables. For example, if you wish to generate an
     HTML report of all your data, which includes names in Russian (in Cyrillic
     letters), for your cousin, and you know that your cousin's computer has no
     font for Cyrillic letters, you might wish to temporarily adjust your
     report output codeset so that you will get interpolated ASCII letters for
     the Russian letters. You could do this by temporarily altering the
     configuration variable ReportCodesetOut to be "ASCII" (actually, if any of
     your data has characters in it that are reserved in HTML, such as the less
     than sign, or the ampersand, you would probaby want "ASCII//HTML").

</P
><P
>&#13;
     The second way to change codeset conversion, and the only way in lifelines
     3.0.6, is to edit the embedded character translation tables, in which you
     actually specify the letters you want converted, letter by letter, and how
     you want them converted.  This method, unlike the first, even works in
     databases with no specified internal codeset.  </P
><P
>&#13;
If you choose the modify character translation tables operation from the main menu, <SPAN
CLASS="application"
>LifeLines</SPAN
> displays
the character translation menu:
<PRE
CLASS="screen"
>&#13;Which character mapping do you want to edit?
   e Editor to Internal mapping
   m Internal to Editor mapping
   i GEDCOM to Internal mapping
   x Internal to GEDCOM mapping
   d Internal to Display mapping
   r Internal to Report mapping
   q Return to main menu
</PRE
>


</P
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> can do codeset conversion in changing
     text from one form to another, and lifelines supports five different
     forms.

</P
><P
>&#13;
</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
>internal</B
></DT
><DD
><P
>&#13;
for records in the database

</P
></DD
><DT
><B
>editor</B
></DT
><DD
><P
>&#13;for records being edited
</P
></DD
><DT
><B
>display</B
></DT
><DD
><P
>&#13;for records being displayed
</P
></DD
><DT
><B
>report</B
></DT
><DD
><P
>&#13;for records written to output file
</P
></DD
><DT
><B
>GEDCOM</B
></DT
><DD
><P
>&#13;for records read in from or written out to GEDCOM
</P
></DD
></DL
></DIV
><P
>&#13;
     When converting text from one form to another
     <SPAN
CLASS="application"
>LifeLines</SPAN
> normally uses iconv conversion, and
     codesets specified in configuration variables. This may be augmented by
     codeset translation or extension using the text conversion (*.tt) files in
     the tt subdirectory. To use the tables in the tt subdirectory,
     you need to set
     the property "TTPATH" in your <SPAN
CLASS="application"
>LifeLines</SPAN
>
     configuration file to the path of the tt directory.  There are two types
     of files in this directory. 
     
</P
><P
>&#13;     
     Files of the form &#60;codeset&#62;_&#60;codeset1&#62;.tt convert from one 
     codeset to another. For example, CP1250_UTF-8.tt can be used to convert
     characters in codeset CP1250 to their representations in UTF-8.
     
</P
><P
>&#13;
     Files of the form &#60;codeset&#62;__&#60;subcodeset&#62;.tt apply a
     conversion within the codeset, for example, UTF-8__html.tt is a
     sub-conversion that converts UTF-8 characters that have special escape
     codes within html to those special codes.  For example, specifing the
     report codeset to be UTF-8//html will apply the html sub-conversion to
     all the data being written.  Probably not what you really wanted.
     See the report language function convertcode() in the reportmanual for
     details.

</P
><P
>&#13;     
     If your system lacks iconv, or you need more specialized
     conversion than provided with iconv, you may either write a text
     conversion file (a tt file), or you may edit one of the in-database
     translation tables.
 
</P
><P
>&#13;
     The in-database translation tables convert between forms (as listed
     above). Every translation table converts either to the internal form, or
     from the internal form. That is, the internal form is used as an
     intermediate step in all operations. There are six supported translation
     tables.  The following table shows the six tables and describes when they
     are applied:
     
</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
>internal to editor</B
></DT
><DD
><P
>&#13;when converting from internal, database form to editor form
</P
></DD
><DT
><B
>editor to internal</B
></DT
><DD
><P
>&#13;when converting from editor form back to internal, database form
</P
></DD
><DT
><B
><ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> to internal</B
></DT
><DD
><P
>&#13;when reading <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> input records and writing them to 
database
</P
></DD
><DT
><B
>internal to <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
></B
></DT
><DD
><P
>&#13;when writing internal database records to external <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> file
</P
></DD
><DT
><B
>internal to display</B
></DT
><DD
><P
>&#13;when displaying a record in a browsing mode display screen
</P
></DD
><DT
><B
>internal to report</B
></DT
><DD
><P
>&#13;when writing internal database records to external report file
</P
></DD
></DL
></DIV
><P
>&#13;
After you select a translation table you are placed in the editor to edit the table. Translation tables are
made up of lines that look like:
<PRE
CLASS="synopsis"
><TT
CLASS="replaceable"
><I
>pattern</I
></TT
> <TT
CLASS="replaceable"
><I
>pattern</I
></TT
></PRE
>
where a tab separates the patterns. Each pattern is an arbitrary sequence of verbatim <ACRONYM
CLASS="acronym"
>ASCII</ACRONYM
> characters
and escape sequences. Translation occurs by finding all occurrences that match left patterns and
replacing them with the corresponding right patterns.

</P
><P
>&#13;There are five escape mechanisms used in patterns:
</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
>#nnn</B
></DT
><DD
><P
>&#13;nnn is a decimal character value
</P
></DD
><DT
><B
>$hh</B
></DT
><DD
><P
>&#13;hh is a hexadecimal character value
</P
></DD
><DT
><B
>\#</B
></DT
><DD
><P
>&#13;represents the # character
</P
></DD
><DT
><B
>\$</B
></DT
><DD
><P
>&#13;represents the $ character
</P
></DD
><DT
><B
>\\</B
></DT
><DD
><P
>&#13;represents the \ character
</P
></DD
></DL
></DIV
><P
>&#13;
     It is possible, and desirable, to provide a short name for
     the translation table, using the "##!name: " command. An 
     example would be

</P
><PRE
CLASS="programlisting"
>&#13;##!name: UTF-8 to latex
</PRE
><P
>&#13;
     Naming the translation table is desirable because these 
     names are displayed, at least in part and if they fit, on
     the translation table menu.

</P
><P
>&#13;
     It is possible to format the file using a character other than
     tab as the separator between source and destination code. To do
     requires using the "##!sep" command. Those exact six characters
     must begin the line, and then the next character is the new
     separator for all following lines. For clarity, this should only
     occur once, and near the top of the file before any actual
     translation lines, and a fairly clear separator should be used
     (e.g., the equal sign "=").

</P
><P
>&#13;
     Any line which is blank, or which begins with two hash marks (##), is
     ignored. Therefore, comments begin with two hash marks.

</P
><P
>&#13;
     For advanced users, it is possible to mix different types of 
     conversion, for example iconv conversion and also translation
     table conversion, in the same form step. For example, it is possible
     to convert internal database text (internal form) first via the
     "internal to GEDCOM" in-database translation table, and then via
     the iconv conversion from configured internal codeset to configured
     GEDCOM codeset. In-database translation tables are always applied
     in the internal codeset, so when converting to the internal form,
     they are applied after iconv and/or tt conversions, and when
     converting from internal form, they are applied first.

</P
><P
>&#13;
     An example of adding a mixin in-database translation table might
     be to escape certain characters which are control characters
     to an output computer language, e.g., latex. One could create an
     "Internal to Report" mapping in UTF-8 (if the database is internally
     UTF-8) to escape any characters that may occur in place names or
     textual descriptions and inadvertently cause grief in latex
     processing.

</P
><P
>&#13;
     However, in this case, one could also write a tt file to achieve
     the same results, and be shared across databases, by naming it, eg,
     UTF-8__latex.tt. The double underscore ("__") signifies that this
     is a conversion to be applied to text which is in UTF-8, and to 
     trigger lifelinesn to use this, one must specify a report codeset
     such as "UTF-8//latex" (if UTF-8 output is desired, but with the
     latex conversion first applied), or "ISO-8859-1//latex" (if 
     ISO-8859-1 output is desired, but with the latex conversion first
     applied).

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1334"
>1.23. MISCELLANEOUS UTILITIES</A
></H2
><P
>&#13;
If you choose the miscellaneous utilities operation,
<SPAN
CLASS="application"
>LifeLines</SPAN
> displays the utilities menu:
<PRE
CLASS="screen"
>&#13;What utility do you want to perform?
  s Save the database in a GEDCOM file
  r Read in data from a GEDCOM file
  R  Pick a GEDCOM file and read in
  k Find a person's key value
  i Identify a person from key value
  d Show database statistics
  m Show memory statistics
  e Edit the place abbreviation file
  o Edit the user options file
  c  Character set options
  q Return to the main menu
</PRE
>


</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>s</B
> <SPAN
CLASS="action"
>Save the database in a GEDCOM file.</SPAN
></B
></DT
><DD
><P
>&#13;
This command saves the complete <SPAN
CLASS="application"
>LifeLines</SPAN
> database in a
<ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> file. All person, family, event, source and user-defined records are stored. This command
may be used to periodically back up your database. When you use this command, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you
for the name of the file. If you have defined the <CODE
CLASS="envar"
>LLARCHIVE</CODE
> shell variable, <SPAN
CLASS="application"
>LifeLines</SPAN
> will store
the file in the directory named in the variable.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>r</B
> <SPAN
CLASS="action"
>Read in data from a GEDCOM file.</SPAN
></B
></DT
><DD
><P
>&#13;
This command allows you restore a complete database from a
<ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> file. When you select this command, <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you for the name of the <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> file.
This command can also be used to import data from a <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> file to an existing database. When
<SPAN
CLASS="application"
>LifeLines</SPAN
> performs this command, it first reads the entire <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> file and checks it for validity.
If there are problems in the file, <SPAN
CLASS="application"
>LifeLines</SPAN
> describes them, writing them to the file err.log, and does
not add any records to the database. If there are no problems, <SPAN
CLASS="application"
>LifeLines</SPAN
> adds all the records found in
the file to the database (only header and trailer records are not stored in the database).

</P
><P
>&#13;Normally, <SPAN
CLASS="application"
>LifeLines</SPAN
> will replace the XREF's (the
identifiers for individuals, families, sources, notes, etc.) in the
<ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> with its own.
These identifiers are reserved by the <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> for internal
use of genealogy programs.  However, if the identifiers are compatible with
<SPAN
CLASS="application"
>LifeLines</SPAN
> internal representation and there are no
conflicts with existing identifiers, <SPAN
CLASS="application"
>LifeLines</SPAN
> will
ask you if you want to perserve the identifiers in the 
<ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> 
file rather than assign new values.
</P
></DD
><DT
><B
><B
CLASS="keycap"
>k</B
> <SPAN
CLASS="action"
>Find a person's key value.</SPAN
></B
></DT
><DD
><P
>&#13;
This command finds the internal key value of a person.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>i</B
> <SPAN
CLASS="action"
>Identify a person from key value.</SPAN
></B
></DT
><DD
><P
>&#13;
This command identifies the person that has a particular internal
key value.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>d</B
> <SPAN
CLASS="action"
>Show database statistics.</SPAN
></B
></DT
><DD
><P
>&#13;
This command summarizes the contents of the current database. It
displays the number of person, family, source, event and other records in the database.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>m</B
> <SPAN
CLASS="action"
>Show memory statistics.</SPAN
></B
></DT
><DD
><P
>&#13;
This command is used by the author for debugging.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>e</B
> <SPAN
CLASS="action"
>Edit the place abbreviation file.</SPAN
></B
></DT
><DD
><P
>&#13;
     This command allows you to edit the place abbreviations
     file. This file defines the abbreviations that are used by
     <SPAN
CLASS="application"
>LifeLines</SPAN
> when it creates lists of
     persons for you to select from. Each line in the file has the
     format:<PRE
CLASS="synopsis"
><TT
CLASS="replaceable"
><I
>word</I
></TT
>:<TT
CLASS="replaceable"
><I
>&#13;     abbr </I
></TT
></PRE
>where word is a word to be
     abbreviated, and abbr is its abbreviation. The word and its
     abbreviation are separated by a colon. For example:

<DIV
CLASS="example"
><A
NAME="AEN1406"
></A
><P
><B
>Example 1-9. 
Example of using abbreviations
</B
></P
><P
CLASS="literallayout"
>Connecticut:Conn.<br>
Massachusetts:Mass.<br>
Nova&nbsp;Scotia:N.S.</P
></DIV
>

</P
><P
>&#13;
When <SPAN
CLASS="application"
>LifeLines</SPAN
> constructs lists of persons for you to select from, it looks up the last component of
certain <CODE
CLASS="structfield"
>PLAC</CODE
> lines in this file, and if it finds that component, replaces it with its abbreviation.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>o</B
>
<SPAN
CLASS="action"
>Edit the user options file.</SPAN
>
</B
></DT
><DD
><P
>&#13;
This command allows you to edit the user options file. The user options file
is a record kept in the database that holds user selectable options. Each
option has a name and a string value. Each line in the options file has the
format:<PRE
CLASS="synopsis"
><TT
CLASS="replaceable"
><I
>option</I
></TT
>=<TT
CLASS="replaceable"
><I
>value</I
></TT
></PRE
>
where option is the name of an option and value is the option's string value.
If the value is more than one line long, then the last character in each
non-final line must be a backslash. The escapes \n and \t are also recognized
in version 3.0.7 and better (to represent a carriage return and a tab, respectively).
These (\n and \t) are primarily for use in custom record templates.
In version 3.0.14 there are 39 options. Note that all of these may also be specified in
the configuration file, to apply to all databases, but if specified in
both places, the entry in the database (user options table) governs.
For more information, see the sample configuration file; each option is preceded
by a brief explanation.

</P
><P
>&#13;The list of options can be found in the section 'System and User Properties'
below.
</P
></DD
></DL
></DIV
><P
>&#13;
For example if you would like to replace the default person
record template with the following:

<DIV
CLASS="example"
><A
NAME="AEN1423"
></A
><P
><B
>Example 1-10. 
Example of replacing the default person record template
</B
></P
><PRE
CLASS="programlisting"
>&#13;
  0 INDI
  1 NAME //
  1 SEX</PRE
></DIV
>
you would edit the user option file to contain:<DIV
CLASS="example"
><A
NAME="AEN1426"
></A
><P
><B
>Example 1-11. 
Example of replaced default person record template
</B
></P
><P
CLASS="literallayout"
>INDIREC=0&nbsp;INDI\<br>
&nbsp;&nbsp;1&nbsp;NAME&nbsp;//\<br>
&nbsp;&nbsp;1&nbsp;SEX</P
></DIV
>

or, using the \n escape so as to keep the entry on one line:<DIV
CLASS="example"
><A
NAME="AEN1429"
></A
><P
><B
>Example 1-12. 
Example of replaced single line default person record template
</B
></P
><P
CLASS="literallayout"
>INDIREC=0&nbsp;INDI\n1&nbsp;NAME&nbsp;//\n1&nbsp;SEX</P
></DIV
>

</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>q</B
> <SPAN
CLASS="action"
>Return to main menu.</SPAN
></B
></DT
><DD
><P
>&#13;This command returns you to the main menu.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1439"
>1.24. IMPORT ERRORS</A
></H2
><P
>&#13;Errors generated during a GEDCOM import are logged to a file,
by default named errs.log. 
</P
><P
>&#13;A number of errors are related to having an incorrect XREF value.
An XREF is the internal name used to Identify a family, individual, note,
source or other record.  An XREF is bracked by two @ signs.  As an example
</P
><PRE
CLASS="programlisting"
>  0 @F6@ FAM
  1 HUSB @I25@
  1 WIFE @I26@
  1 CHIL @I17@</PRE
><P
>&#13;Here F6 is the internal name of this family.  The family refers
to other individuals by specifing their XREF values.  Also I25, I26 and I17
are XREF values of individuals. 
</P
><P
>&#13;XREF values used within <SPAN
CLASS="application"
>LifeLines</SPAN
> are totally under
the control of <SPAN
CLASS="application"
>LifeLines</SPAN
>.
The values that are used are always of the form, a single letter, followed by
a number.  However, when importing a gedcom
<SPAN
CLASS="application"
>LifeLines</SPAN
> should accept almost
anything as an XREF, converting it to what is needed for internal use.
For the curious, the letters that <SPAN
CLASS="application"
>LifeLines</SPAN
> uses
are I for Individual, F for Family, S for Source, E for Events, and X for
other records.

</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
>Bad NAME syntax.</B
></DT
><DD
><P
>&#13;
     A level 1 NAME record must have a value, and the value must not be a pointer, and may 
     have no more than two slashes.
</P
><DIV
CLASS="example"
><A
NAME="AEN1455"
></A
><P
><B
>Example 1-13. 
Example of bad NAME syntax (too many slashes in this case)
</B
></P
><PRE
CLASS="programlisting"
>  0 @I99@ INDI
  1 NAME Mary /Smith/ nee /Jones/
</PRE
></DIV
></DD
><DT
><B
>Family F13 has an incorrect key.</B
></DT
><DD
><P
></P
></DD
><DT
><B
>Person XYZ has an incorrect key: skipped.</B
></DT
><DD
><P
>&#13;
     The XREF values must be unique.  These error messages are
     generated if a XREF is found to refer to two different records.
     For example, the XREF for a family is the same as one for an individual.

</P
><DIV
CLASS="example"
><A
NAME="AEN1466"
></A
><P
><B
>Example 1-14. 
Example of XREF XYZ being defined twice
</B
></P
><PRE
CLASS="programlisting"
>  0 @XYZ@ INDI
  1 NAME Mary /Smith/ nee /Jones/
  0 @XYZ@ FAM
  1 HUSB @I48@
</PRE
></DIV
></DD
><DT
><B
>Person defined here has no name.</B
></DT
><DD
><P
>&#13;
     Each INDI record must have at least one level 1 NAME record, if the 
     configuration option RequireNames is non-zero.

</P
></DD
><DT
><B
>Person INDI_XYZ is multiply defined: skipped.</B
></DT
><DD
><P
>&#13;
     No XREF value of an INDI may be reused.  This message indicates that
     INDI_XYZ has been used to identify two different persons.

</P
><DIV
CLASS="example"
><A
NAME="AEN1477"
></A
><P
><B
>Example 1-15. 
Example of person multiply defined
</B
></P
><PRE
CLASS="programlisting"
>  0 @INDI_XYZ@ INDI
  1 NAME John /Smith/
  0 @INDI_XYZ@ INDI
  1 NAME Jack /Smith/
</PRE
></DIV
></DD
><DT
><B
>The family defined here has no key.</B
></DT
><DD
><P
>&#13;
     Each FAM record must have an XREF value.
     (The XREF is the letters between "0" and "FAM".)

</P
><DIV
CLASS="example"
><A
NAME="AEN1484"
></A
><P
><B
>Example 1-16. 
Example of family record missing key
</B
></P
><PRE
CLASS="programlisting"
>  0 FAM
  1 HUSB @I1@
</PRE
></DIV
></DD
><DT
><B
>Family F123 is referred to but
not defined.</B
></DT
><DD
><P
>&#13;
     A FAMS or FAMC record on an Individual refers to a family
     but there is no FAM record with that XREF.

</P
></DD
><DT
><B
>The person defined here has no key: skipped.</B
></DT
><DD
><P
>&#13;
     Each INDI record must have an XREF value.
     (The XREF is the letters between "0" and "INDI".)

</P
><DIV
CLASS="example"
><A
NAME="AEN1495"
></A
><P
><B
>Example 1-17. 
Example of person record missing key
</B
></P
><PRE
CLASS="programlisting"
>  0 INDI
  1 NAME John /Smith/
</PRE
></DIV
></DD
><DT
><B
>This line has a level number that is too large.</B
></DT
><DD
><P
>&#13;
     A child level must be one higher than its parent level.

</P
><DIV
CLASS="example"
><A
NAME="AEN1502"
></A
><P
><B
>Example 1-18. 
Example of level number which is too high
</B
></P
><PRE
CLASS="programlisting"
>  0 @I99@ INDI
  1 NAME //
  3 NOTE name is missing
</PRE
></DIV
></DD
><DT
><B
>This FAMS line is missing a
value field (INDI I99).</B
></DT
><DD
><P
>&#13;
   Lineage-linking tags must have a value, including tags FAMC, FAMS, FATH, MOTH, HUSB, WIFE, CHIL.

</P
><DIV
CLASS="example"
><A
NAME="AEN1509"
></A
><P
><B
>Example 1-19. 
Example of lineage-linking line which is missing required value
</B
></P
><PRE
CLASS="programlisting"
>  0 @I99@ INDI
  1 NAME John /Smith/
  2 FAMS
</PRE
></DIV
></DD
></DL
></DIV
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1512"
>1.25. HANDLING SOURCE, EVENT AND USER-DEFINED RECORDS</A
></H2
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> supports source, event
     and other, user-defined record types.  You can access these
     features in two ways: either through the x operation from the
     main menu, or via commands in the individual and family browse
     screens.  The first approach might be most convenient when you
     are solely working with these record types.  The second makes
     it easier to work with source, event and user-defined records
     in parallel with your person and family records; this can be
     useful for instance when you want to create references from
     your person and family record to your source, event and user
     defined records as you create them, and to view and edit
     records that you have referenced from within a person or
     family record.

</P
><P
>&#13;
     Using the first of these two possibilities
     <SPAN
CLASS="application"
>LifeLines</SPAN
> displays the following
     menu:

<PRE
CLASS="screen"
>&#13;What activity do you want to perform?

  s  Browse source records
  e  Browse event records
  x  Browse other records
  1  Add a source record to the database
  2  Edit source record from the database
  3  Add an event record to the database
  4  Edit event record from the database
  5  Add an other record to the database
  6  Edit other record from the database
  q  Return to main menu
</PRE
>

     Using the second variant (from the person and family browse
     screens), the following six commands are available. The first
     three are described alongside with their counterparts in the x
     menu (they do mostly, but not entirely, the same things); the
     last three are described separately:

<PRE
CLASS="screen"
>&#13;  %s  Add source
  %e  Add event
  %o  Add other
</PRE
>

<PRE
CLASS="screen"
>&#13;  $s  List sources
  $n  List notes
  $$  List references
</PRE
>

</P
><P
>&#13;
     The handling of source, event and user-defined records in
     <SPAN
CLASS="application"
>LifeLines</SPAN
> is still in
     development. For example, sources cannot yet be searched by
     REFN or be deleted.

</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
><B
CLASS="keycap"
>s</B
>
<SPAN
CLASS="action"
>Browse source records.</SPAN
></B
></DT
><DD
><P
>&#13;This will bring up a list of all source records by number, showing
REFN, title, and author for each. A record may be selected
from this list to edit.
</P
></DD
><DT
><B
><B
CLASS="keycap"
>e</B
>
<SPAN
CLASS="action"
>Browse event records.</SPAN
></B
></DT
><DD
><P
>&#13;This will bring up a list of all event records by number. As of
yet this does not display any information about each event.
(Suggestions as to how to summarize events are welcome).
A record may be selected from this list to edit.
</P
></DD
><DT
><B
><B
CLASS="keycap"
>x</B
>
<SPAN
CLASS="action"
>Browse other records.</SPAN
></B
></DT
><DD
><P
>&#13;This will bring up a list of all other records by number,
showing the 0 level line as summary. A record may be selected
from this list to edit.
</P
></DD
><DT
><B
><B
CLASS="keycap"
>1</B
>
     <SPAN
CLASS="action"
>Add a source record to the
     database.</SPAN
></B
></DT
><DD
><P
>&#13;
     This operation (or alternatively <B
CLASS="keycap"
>%s</B
> from the
     person, family or auxiliary browse screens) is used to add a
     new source record to the database.
     <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a template source
     and puts you in the screen editor to edit the template. The
     default template is:

<PRE
CLASS="programlisting"
>  0 SOUR
  1 REFN
  1 TITL <TT
CLASS="replaceable"
><I
>Title</I
></TT
>
  1 AUTH <TT
CLASS="replaceable"
><I
>Author</I
></TT
>

</PRE
>

</P
><P
>&#13;
     Do not change the <CODE
CLASS="structfield"
>0 SOUR</CODE
>
     line. Otherwise you may edit this record any way you like. The
     <CODE
CLASS="structfield"
>1 REFN</CODE
> line is a special line you
     can use to give the source a symbolic name that can be used in
     other records to refer to the source record. See the section
     on using <CODE
CLASS="structfield"
>REFN</CODE
> values. Because many
     sources have a title and an author, the default template has
     these lines. You may adjust the source template via the
     SOURREC user option (either at the database level, via the
     user options, or globally, via the configuration file). Here
     is how I recorded one of the sources in my database:

<DIV
CLASS="example"
><A
NAME="AEN1557"
></A
><P
><B
>Example 1-20. 
Example of a source record
</B
></P
><PRE
CLASS="programlisting"
>0 SOUR
  1 REFN <KBD
CLASS="userinput"
>jcw</KBD
>
  1 TITL <KBD
CLASS="userinput"
>The Wetmore Family of America, and its Collateral Branches: with</KBD
>
    2 CONT <KBD
CLASS="userinput"
>Genealogical, Biographical, and Historical Notices</KBD
>
  1 AUTH <KBD
CLASS="userinput"
>James Carnahan Wetmore</KBD
>
  1 PUBL
    2 DATE <KBD
CLASS="userinput"
>1861</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>Albany, New York</KBD
>
    2 INST <KBD
CLASS="userinput"
>Munsell and Rowland</KBD
>
    2 ADDR <KBD
CLASS="userinput"
>78 State Street</KBD
></PRE
></DIV
>

</P
><P
>&#13;
     The add source command in the x menu is equivalent to the
     <B
CLASS="keycap"
>%s</B
> command available in the person or family
     browse screen, in terms of entering the source record; after
     saving the source record though, there is one significant
     difference, in that that you then are presented with the
     following prompt (also, the key value of the new record is
     displayed in the status bar at this point):
</P
><PRE
CLASS="screen"
>&#13;Please choose from the following options:
  1: Insert xref automatically at bottom of current record.
  2: Edit current record now to add xref manually.
  3: Browse new record (without adding xref).
  4: Return to current record (without adding xref).

 Commands:   j Move down     k Move up    i Select     q Quit
</PRE
><P
>&#13;
     The four options perform the following actions:

     </P
><P
>&#13;
     1: LifeLines adds a reference to the new source record at the
     bottom of the person or family record that was visible in the
     display screen when you prompted LifeLines to create the new
     source record.

     </P
><P
>&#13;
     2: LifeLines will open the person or family record that was
     visible in the display screen when you prompted LifeLines to
     create the new source record, so that you can manually enter a
     reference to the newly created source record (perhaps as a
     source reference to an event that you are planning to add).

     </P
><P
>&#13;
     3: LifeLines lets you browse (and optionally reopen for
     editing) your newly added source record.

     </P
><P
>&#13;
     4: You are returned to the person or family record that was
     visible in the display screen when you prompted LifeLines to
     create the new source record. No reference is added to the new
     record.

     </P
></DD
><DT
><B
><B
CLASS="keycap"
>2</B
> <SPAN
CLASS="action"
>Edit source record from the database.</SPAN
></B
></DT
><DD
><P
>&#13;
Use this operation to edit an existing source record already in
the database. When you select this operation
<SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify a source:
<PRE
CLASS="screen"
>&#13;Which source record do you want to edit?
enter key or refn:
</PRE
>


</P
><P
>&#13;
Identify a source by entering its key value, with or without the leading S, or by entering its <CODE
CLASS="structfield"
>REFN</CODE
>
value. <SPAN
CLASS="application"
>LifeLines</SPAN
> retrieves the record and puts you in the editor with the record.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>3</B
> <SPAN
CLASS="action"
>Add an event record to the database.</SPAN
></B
></DT
><DD
><P
>&#13;
This operation (or alternatively <B
CLASS="keycap"
>%e</B
> from the person,
family or auxiliary browse screens) adds a new event record to the
database.  <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a template
event and puts you in the screen editor to edit the template. The
default template is:
<PRE
CLASS="programlisting"
>0 EVEN
  1 REFN
  1 DATE
  1 PLAC
  1 INDI
    2 NAME
    2 ROLE
  1 SOUR</PRE
>

</P
><P
>&#13;
     You may adjust the event template via the EVENREC user option (either
     at the database level, via the user options, or globally, via the
     configuration file).

</P
><P
>&#13;
     Do not change the <CODE
CLASS="structfield"
>0 EVEN</CODE
>
     line. Otherwise you may edit this record any way you like. The
     <CODE
CLASS="structfield"
>1 REFN</CODE
> line allows you to give this
     event a symbolic name you can use when you want to refer to
     this event from other records. See the section on using
     <CODE
CLASS="structfield"
>REFN</CODE
> values. The default template
     suggests that an event has a date, a place, and refers to
     persons in roles with respect to the event. There is far less
     experience with event-based <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
> than
     there is with simple person and family
     <ACRONYM
CLASS="acronym"
>GEDCOM</ACRONYM
>. You may even be wondering why you
     would need event records when you can simply tuck events away
     in person and family records. This is a topic that may get
     covered in an appendix.

</P
><P
>&#13;
     The add event command in the x menu is equivalent to the
     <B
CLASS="keycap"
>%e</B
> command available in the person or family
     browse screen, in terms of entering the event record; after
     saving the event record though, there is one significant
     difference, in that that you then are presented with the
     following prompt (also, the key value of the new record is
     displayed in the status bar at this point):
</P
><PRE
CLASS="screen"
>&#13;Please choose from the following options:
  1: Insert xref automatically at bottom of current record.
  2: Edit current record now to add xref manually.
  3: Browse new record (without adding xref).
  4: Return to current record (without adding xref).

 Commands:   j Move down     k Move up    i Select     q Quit
</PRE
><P
>&#13;
     The four options perform the following actions:

     </P
><P
>&#13;
     1: LifeLines adds a reference to the new event record at the
     bottom of the person or family record that was visible in the
     display screen when you prompted LifeLines to create the new
     event record.

     </P
><P
>&#13;
     2: LifeLines will open the person or family record that was
     visible in the display screen when you prompted LifeLines to
     create the new event record, so that you can manually enter a
     reference to the newly created event record.

     </P
><P
>&#13;
     3: LifeLines lets you browse (and optionally reopen for
     editing) your newly added event record.

     </P
><P
>&#13;
     4: You are returned to the person or family record that was
     visible in the display screen when you prompted LifeLines to
     create the new event record. No reference is added to the new
     record.

     </P
></DD
><DT
><B
><B
CLASS="keycap"
>4</B
> <SPAN
CLASS="action"
>Edit event record from the database.</SPAN
></B
></DT
><DD
><P
>&#13;
     Use this operation to edit an existing event record from the
     database . When you select this operation
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify an
     event:

<PRE
CLASS="screen"
>&#13;Which event record do you want to edit?
enter key or refn:
</PRE
>


</P
><P
>&#13;
     You identify a event by entering its key value, with or
     without the leading E, or by entering its
     <CODE
CLASS="structfield"
>REFN</CODE
>
     value. <SPAN
CLASS="application"
>LifeLines</SPAN
> retrieves the
     record and places you in the screen editor with the record.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>5</B
> <SPAN
CLASS="action"
>Add an other record to the database.</SPAN
></B
></DT
><DD
><P
>&#13;
     This operation (or alternatively <B
CLASS="keycap"
>%o</B
> from the
     person, family or auxiliary browse screens) adds a new
     user-defined record to the database.
     <SPAN
CLASS="application"
>LifeLines</SPAN
> creates a template and
     puts you in the screen editor to edit the template. The
     default template is

<PRE
CLASS="programlisting"
>0 XXXX
1 REFN
</PRE
>
</P
><P
>&#13;
     Replace <TT
CLASS="replaceable"
><I
>XXXX</I
></TT
> with the tag string
     you select for the type of the new record. You are free to
     choose any tag value except <CODE
CLASS="structfield"
>INDI</CODE
>,
     <CODE
CLASS="structfield"
>FAM</CODE
>,
     <CODE
CLASS="structfield"
>SOUR</CODE
> and
     <CODE
CLASS="structfield"
>EVEN</CODE
>. For example, if you keep
     record information about the ships that your North American
     immigrant ancestors arrived on, you would keep records about
     those ships in your database; the tag
     <CODE
CLASS="structfield"
>SHIP</CODE
> suggests itself for such
     records. The <CODE
CLASS="structfield"
>1 REFN</CODE
> line allows you
     to give this record a symbolic name you can use when you want
     to refer to it from other records. See the section on using
     <CODE
CLASS="structfield"
>REFN</CODE
> values. You may adjust the
     other template via the OTHR user option (either at the database
     level, via the user options, or globally, via the configuration
     file).

</P
><P
>&#13;
     The add other record command in the x menu is equivalent to the
     <B
CLASS="keycap"
>%o</B
> command available in the person or family
     browse screen, in terms of entering the other record; after
     saving the record though, there is one significant difference,
     in that that you then are presented with the following prompt
     (also, the key value of the new record is displayed in the
     status bar at this point):
</P
><PRE
CLASS="screen"
>&#13;Please choose from the following options:
  1: Insert xref automatically at bottom of current record.
  2: Edit current record now to add xref manually.
  3: Browse new record (without adding xref).
  4: Return to current record (without adding xref).

 Commands:   j Move down     k Move up    i Select     q Quit
</PRE
><P
>&#13;
     The four options perform the following actions:

     </P
><P
>&#13;
     1: LifeLines adds a reference to the new other record at the
     bottom of the person or family record that was visible in the
     display screen when you prompted LifeLines to create the new
     other record.

     </P
><P
>&#13;
     2: LifeLines will open the person or family record that was
     visible in the display screen when you prompted LifeLines to
     create the new other record, so that you can manually enter a
     reference to the newly created other record (perhaps as a
     note reference to an event that you are planning to add).

     </P
><P
>&#13;
     3: LifeLines lets you browse (and optionally reopen for
     editing) your newly added other record.

     </P
><P
>&#13;
     4: You are returned to the person or family record that was
     visible in the display screen when you prompted LifeLines to
     create the new other record. No reference is added to the new
     record.

     </P
></DD
><DT
><B
><B
CLASS="keycap"
>6</B
> <SPAN
CLASS="action"
>Edit other record from the database.</SPAN
></B
></DT
><DD
><P
>&#13;
     Use this operation to edit an existing user-defined record
     from the database. When you select this operation
     <SPAN
CLASS="application"
>LifeLines</SPAN
> asks you to identify the
     record:

<PRE
CLASS="screen"
>&#13;What record do you want to edit?
enter key or refn:
</PRE
>


</P
><P
>&#13;
     You identify a record by entering its key value, with or
     without the leading X, or by entering its
     <CODE
CLASS="structfield"
>REFN</CODE
>
     value. <SPAN
CLASS="application"
>LifeLines</SPAN
> retrieves the
     record and places you in the screen editor with the record.

</P
></DD
><DT
><B
><B
CLASS="keycap"
>$s</B
>
<SPAN
CLASS="action"
>List sources</SPAN
></B
></DT
><DD
><P
>&#13;
     This command is available in the person and family browse
     screens. It will bring up a list of all source records that
     are referenced within the currently displayed person or family
     record, by the order they appear in the person/family record,
     showing REFN, title, and author for each. A record may be
     selected from this list to view in the auxiliary browse screen
     (and optionally be edited from there).

     </P
></DD
><DT
><B
><B
CLASS="keycap"
>$n</B
>
<SPAN
CLASS="action"
>List notes</SPAN
></B
></DT
><DD
><P
>&#13;
     This command is available in the person and family browse
     screens. It will bring up a list of all note records that are
     referenced within the currently displayed person or family
     record, by the order they appear in the person/family record,
     showing REFN, title, and author for each. A record may be
     selected from this list to view in the auxiliary browse screen
     (and optionally be edited from there).

     </P
></DD
><DT
><B
><B
CLASS="keycap"
>$$</B
>
<SPAN
CLASS="action"
>List all references</SPAN
></B
></DT
><DD
><P
>&#13;
     This command is available in the person and family browse
     screens. It will bring up a list of all records that are
     referenced within the currently displayed person or family
     record, by the order they appear in the person/family record,
     showing REFN, title, and author for each. A record may be
     selected from this list to view in the auxiliary browse screen
     (and optionally be edited from there).

     </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1677"
>1.26. FAMILY STRUCTURE AND MERGING PERSONS AND FAMILIES</A
></H2
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> 3.0.2 has relaxed most of
     restrictions on family structure that were imposed by earlier
     versions. For example, a family record may have more than one
     parent/spouse of the same sex; a person may be a child in more
     than family. This is a controversial issue. Some users insist
     that family relationships should imply biological relatedness,
     and that all other relationships should be handled by
     different means. Others insist that non-traditional families
     (any number of parents/spouses of any sex) should be allowed,
     and that children can be members of more than one family (eg,
     natural family and adoptive
     family). <SPAN
CLASS="application"
>LifeLines</SPAN
> no longer takes
     a position on this matter; you are free to set up families any
     way you like; the operations that add spouses and children to
     families no longer check for non-traditional arrangements. It
     is possible that a future release will include a user option
     to either disallow or to ask for confirmation about
     non-traditional relationships.

</P
><P
>&#13;
     <SPAN
CLASS="application"
>LifeLines</SPAN
> provides features for
     merging persons together and for merging families
     together. The person merging feature is accessed from the
     tandem person browse mode, and the family merging feature is
     accessed from the tandem family browse mode. You browse to the
     two persons or families you want to merge and then use the j
     command. Merging is necessary when you discover that two or
     more person records, or two or more family records, represent
     the same person or family, respectively.

</P
><P
>&#13;
     Versions of <SPAN
CLASS="application"
>LifeLines</SPAN
> prior to
     3.0.2 required that persons and families meet certain criteria
     before they could be merged. The criteria ensured that the
     merged persons and families would still meet traditional
     family structuring rules. With the relaxation of the
     structuring rules, restrictions on merging have also been
     removed. It is now possible to create non-traditional
     relationships by merging traditional persons and/or
     families. For example, if you merge two persons that happen to
     be children in two different families, the merged person will
     be a child in both families. If you want to maintain only
     traditional relationships in your database you may have to
     makes further to changes to relationships after you complete a
     merge operation.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1686"
>1.27. LINKING RECORDS TOGETHER AND USING THE REFN FEATURE</A
></H2
><P
>&#13;
     Records in a <SPAN
CLASS="application"
>LifeLines</SPAN
> database may
     refer to other records via cross-reference links. The
     lineage-linked references are maintained directly by
     <SPAN
CLASS="application"
>LifeLines</SPAN
> through operations found
     in the browsing mode menus.  These references are the links
     from a person to families (<CODE
CLASS="structfield"
>1 FAMC</CODE
>
     and <CODE
CLASS="structfield"
>1 FAMS</CODE
>), and the links from a
     family to persons (<CODE
CLASS="structfield"
>1 HUSB</CODE
>,
     <CODE
CLASS="structfield"
>1 WIFE</CODE
> and <CODE
CLASS="structfield"
>1
     CHIL</CODE
>). Because
     <SPAN
CLASS="application"
>LifeLines</SPAN
> maintains these links you
     are not allowed to change these lines when you are editing
     records. There are a couple of seeming exceptions to this
     rule. For example, you may change the order of <CODE
CLASS="structfield"
>1
     CHIL</CODE
> lines in a family record in order to change
     the order of children in a family, and you may change the
     order of <CODE
CLASS="structfield"
>1 FAMS</CODE
> lines in a person
     record to change the order of families the person was a spouse
     or parent in. These operations are allowed because they don't
     affect which person records refer to which family records and
     vice versa.

</P
><P
>&#13;
     Besides the lineage-links that are maintained by
     <SPAN
CLASS="application"
>LifeLines</SPAN
>, you may place your own
     links in records.  Probably the most common example of this is
     referring events within a person record to the record of the
     information source for the event. For example:


<DIV
CLASS="example"
><A
NAME="AEN1701"
></A
><P
><B
>Example 1-21. 
Example of referring events from a person record
</B
></P
><PRE
CLASS="programlisting"
>0 @I23@ INDI
  1 NAME <KBD
CLASS="userinput"
>Thomas/Whitmore/</KBD
>
  1 BIRT
    2 DATE <KBD
CLASS="userinput"
>about 1615</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>England</KBD
>
    2 SOUR @S3@
...
0 @S3@ SOUR
  1 REFN <KBD
CLASS="userinput"
>cat</KBD
>
  1 TITL <KBD
CLASS="userinput"
>New England Marriages Prior to 1700</KBD
>
  1 AUTH <KBD
CLASS="userinput"
>Clarence Almon Torrey</KBD
>
...</PRE
></DIV
>

</P
><P
>&#13;
The <CODE
CLASS="structfield"
>2 SOUR</CODE
> <TT
CLASS="replaceable"
><I
>@S3@</I
></TT
> line in the person record refers to the source record. <SPAN
CLASS="application"
>LifeLines</SPAN
> allows any specific
structure within a record (in this case a birth event) to refer to another record. It is not possible to refer
to a specific location within another record, though this may be supported eventually.


</P
><P
>&#13;
This example implies that when linking one record to another you must know the key of the target
record (S3 in the example). This is not desirable because internal record keys may change when the
records are exported from one database or imported to another.

</P
><P
>&#13;
     Because internal key values are not permanent,
     <SPAN
CLASS="application"
>LifeLines</SPAN
> allows you to assign a
     permanent user-defined key to any record in the database using
     the <CODE
CLASS="structfield"
>1 REFN</CODE
> line. The value of this
     line is a string that you choose as your permanent key value
     for the record. When adding a link to a record that has a user
     <CODE
CLASS="structfield"
>REFN</CODE
> key value, you may use that
     value instead of the internal key value. For example, when
     adding the person in the previous example you could edit the
     new record as follows:

<DIV
CLASS="example"
><A
NAME="AEN1719"
></A
><P
><B
>Example 1-22. 
Example of adding a new person
</B
></P
><PRE
CLASS="programlisting"
>0 INDI
  1 NAME <KBD
CLASS="userinput"
>Thomas/Whitmore/</KBD
>
  1 BIRT
    2 DATE <KBD
CLASS="userinput"
>about 1615</KBD
>
    2 PLAC <KBD
CLASS="userinput"
>England</KBD
>
    2 SOUR <KBD
CLASS="userinput"
>&#60;cat&#62;</KBD
></PRE
></DIV
>

</P
><P
>&#13;
     Instead of using the actual key value of the source, S3, the
     <CODE
CLASS="structfield"
>REFN</CODE
> value cat was used. The
     <CODE
CLASS="structfield"
>REFN</CODE
> value must be enclosed by
     angle brackets when used this
     way. <SPAN
CLASS="application"
>LifeLines</SPAN
> automatically
     replaces the <CODE
CLASS="structfield"
>REFN</CODE
> link with the
     proper internal key value when the record is stored in the
     database.


</P
><P
>&#13;
     The <CODE
CLASS="structfield"
>REFN</CODE
> value may also be used
     when searching for person, source, event and user-defined
     records.  You should not add more than one
     <CODE
CLASS="structfield"
>REFN</CODE
> line to a record, and every
     <CODE
CLASS="structfield"
>REFN</CODE
> value should be unique.

</P
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN1735"
>1.28. System and User Properties</A
></H2
><P
>&#13;There are a number of properties that can be specified to customize
the behavior of <SPAN
CLASS="application"
>LifeLines</SPAN
>.  These properties can 
be specified in <SPAN
CLASS="application"
>LifeLines</SPAN
>
configuration files, in each <SPAN
CLASS="application"
>LifeLines</SPAN
> database 
or in some cases by environment variables.
</P
><P
>&#13;System Properties are properties that have a predefined meaning to lifelines,
such as LLEDITOR (see its meaning below).  User Properties typically have no
predefined meanings as they are simply a string that a report looks up in the
property tables.  It can be anything a user desires.  To simplify report
writing a number of User Properties are predefined with specific meanings.
These User Property Names begin with 'user.' and are listed below.  For
example, many reports have abstracted the concept of the user's name to
the property user.fullname.  By defining this property in your llines startup
file, it allows a report to reference your name as the source of the data
being printed without having it hard-coded in the report.
</P
><P
>&#13;When <SPAN
CLASS="application"
>LifeLines</SPAN
> begins execution, it reads any
specified configuration files and extracts Properties from the files read.
It is possible for multiple configuration files to be read.  Properties
defined in these files will be stored in the global property table.  If
multiple definitions of the same property are seen, the latest definition
overrides prior definitions.  Configuration files are read as follows:
</P
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN1744"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL
WIDTH="48"><COL><TBODY
><TR
><TD
>Note:</TD
><TD
>&#13;If a configuration file defines LLCONFIGFILE, it is not entered in the global
table, but the value of this parameter is read as a configuration file after
completion of reading the current file.
</TD
></TR
><TR
><TD
>Note:</TD
><TD
>&#13;In the following, the name of a user configuration file is listed as
.linesrc.  On windows versions of lifelines this name is lines.cfg.
</TD
></TR
><TR
><TD
>1</TD
><TD
>&#13;If a configuration file name is passed to the program with the -C option,
or if LLCONFIGFILE is defined as an environment variable use the value
supplied as the name of the configuration file.  Do not read configuration
information from the files listed in 2a, 2b, 2c, or 2d.
</TD
></TR
><TR
><TD
>2a</TD
><TD
>&#13;If the file /etc/lifelines.conf exists, read it.  '/etc' is a placeholder for
the standard location for system configuration files as defined when 
lifelines was built.  It is often /etc or /usr/local/etc.
</TD
></TR
><TR
><TD
>2b.</TD
><TD
>&#13;If the file $HOME/.linesrc exists, load parameters from it.
</TD
></TR
><TR
><TD
>2c.</TD
><TD
>&#13;If the file .linesrc exists in the current directory read parameters from it.
</TD
></TR
><TR
><TD
>2d</TD
><TD
>&#13;If LLCONFIGFILE is defined in the command line or database table and its 
value is the name of a file, load parameters from that file.
</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><P
>&#13;When <SPAN
CLASS="application"
>LifeLines</SPAN
> searches for a property it looks for it as follows:
</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
>cmdline table</B
></DT
><DD
><P
>&#13;First, <SPAN
CLASS="application"
>LifeLines</SPAN
> looks in the cmdline table.  This table contains the
values that have been specified using the -I option to
<SPAN
CLASS="application"
>LifeLines</SPAN
>.
</P
></DD
><DT
><B
>database table</B
></DT
><DD
><P
> Next, <SPAN
CLASS="application"
>LifeLines</SPAN
> looks in the database table.  This table contains the
values which have been stored in the current database.
</P
></DD
><DT
><B
>global table</B
></DT
><DD
><P
>&#13;Next, <SPAN
CLASS="application"
>LifeLines</SPAN
> looks in the global table.  This table contains the
values found when reading in the configuration files.
</P
></DD
><DT
><B
>environment table</B
></DT
><DD
><P
>&#13;Finally, <SPAN
CLASS="application"
>LifeLines</SPAN
> looks in the environment table.
Only a handful of properties may be set from the environment, namely 
LLPROGRAMS, LLREPORTS, LLARCHIVES, LLDATABASES, and LLEDITOR.
</P
></DD
></DL
></DIV
><P
>&#13;Properties are named group.subgroup.property or group.property, or even
just property.
The following keys are available at the moment: 
</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
>LLPROGRAMS</B
></DT
><DD
><P
>&#13;<CODE
CLASS="envar"
>LLPROGRAMS</CODE
> is the search path for
<SPAN
CLASS="application"
>LifeLines</SPAN
> report generating and
other programs.
</P
></DD
><DT
><B
>LLREPORTS</B
></DT
><DD
><P
>&#13;<CODE
CLASS="envar"
>LLREPORTS</CODE
> is used to select a directory where
all generated reports and program outputs will be placed.
</P
></DD
><DT
><B
>LLARCHIVES</B
></DT
><DD
><P
>&#13;<CODE
CLASS="envar"
>LLARCHIVES</CODE
> is used to select a
directory where all database backup files will be stored
</P
></DD
><DT
><B
>LLDATABASES</B
></DT
><DD
><P
>&#13;<CODE
CLASS="envar"
>LLDATABASES</CODE
> is a list of
directories that contain database directories used to locate
database directories themselves
</P
></DD
><DT
><B
>LLNEWDBDIR</B
></DT
><DD
><P
>&#13;<CODE
CLASS="envar"
>LLNEWDBDIR</CODE
> a single directory where new databases
specified without paths will be created.
This is a convenience for users
who generally put all their databases under a single common
directory.
</P
></DD
><DT
><B
>LLEDITOR</B
></DT
><DD
><P
>&#13;Overrides the default screen editor
</P
></DD
></DL
></DIV
><P
>&#13;Codeset Information:
</P
><P
>&#13;For the following parameters related to codeset, the values are a 
String denoting code set in use in data. Special handling is provided
for UTF-8, which may be entered as "UTF-8", "utf-8", or "65001". (The
official, and preferred, name is UTF-8.
</P
><DIV
CLASS="glosslist"
><DL
><DT
><B
>codeset</B
></DT
><DD
><P
>&#13;Is a property that report programs can read whose value is the codeset of the
current database.
</P
></DD
><DT
><B
>GedcomCodeset</B
></DT
><DD
><P
>&#13;Specifies the default Codeset to use when processing Gedcom files.
There are actually 3 properties.
<I
CLASS="glossterm"
>GedcomCodesetOut</I
> and <I
CLASS="glossterm"
>GedcomCodesetIn</I
>
can be used to specify the codeset for output or input.  If either of these is
not specified 
<I
CLASS="glossterm"
>GedcomCodeset</I
> is used. Most Gedcom files should
contain a codeset property, so this is not usually relevant when reading a Gedcom
file, unless the input Gedcom file lacks a codeset property. This is used, however,
when writing out a Gedcom file. 
NB: This is ignored if the database has no internal codeset specified.
</P
></DD
><DT
><B
>EditorCodeset</B
></DT
><DD
><P
>&#13;Specifies the codeset to use for editing.  There are actually 3 properties.
<I
CLASS="glossterm"
>EditorCodesetOut</I
> and <I
CLASS="glossterm"
>EditorCodesetIn</I
>
can be used to specify the codeset for output or input.  If either of these is
not specified <I
CLASS="glossterm"
>EditorCodeset</I
> is used. This property allows
lifelines to convert from its internal codeset to the one you use in your editor, so
this is important when your editor does not use the same codeset as your database.
NB: This is ignored if the database has no internal codeset specified.
</P
></DD
><DT
><B
>ReportCodeset</B
></DT
><DD
><P
>&#13;Specifies the codeset to use for reports.  There are actually 3 properties.
<I
CLASS="glossterm"
>ReportCodesetOut</I
> and <I
CLASS="glossterm"
>ReportCodesetIn</I
>
can be used to specify the codeset for output or input.  If either of these is
not specified <I
CLASS="glossterm"
>ReportCodeset</I
> is used. Recently created
reports may actually specify their codeset, in which case this is not used, but
for reports which do not include a specification of codeset, the
<I
CLASS="glossterm"
>ReportCodesetIn</I
> (or <I
CLASS="glossterm"
>ReportCodeset</I
>)
specifies how the report will be understood. In any case, the output of a 
report program will be written in the codeset given by
<I
CLASS="glossterm"
>ReportCodesetOut</I
> (or <I
CLASS="glossterm"
>ReportCodeset</I
>).
NB: This is ignored if the database has no internal codeset specified.
</P
></DD
><DT
><B
>GuiCodeset</B
></DT
><DD
><P
>&#13;Specifies the codeset to use for interaction with the graphical user interface.
There are actually 3 properties.
<I
CLASS="glossterm"
>GuiCodesetOut</I
> and <I
CLASS="glossterm"
>GuiCodesetIn</I
>
can be used to specify the codeset for output or input.  If either of these is
not specified <I
CLASS="glossterm"
>GuiCodeset</I
> is used. 
</P
></DD
><DT
><B
>LongDisplayDate</B
></DT
><DD
><P
>&#13;Six comma separated numbers. Specifing the format for
days, months, years, date format, era format, and complex format.
If string does not contain 6 comma separated numbers all formats are
set to 0, except date format is set to 14.
These formats are used by <SPAN
CLASS="application"
>LifeLines</SPAN
> to display dates in long format.
</P
></DD
><DT
><B
>LongDisplayDatePic</B
></DT
><DD
><P
>&#13;a custom ymd date picture.  A string in which %y, %m and %d will be
converted to the corresponding year, month and day.
This picture is used by <SPAN
CLASS="application"
>LifeLines</SPAN
> to display dates in long format.
</P
></DD
><DT
><B
>ShortDisplayDate</B
></DT
><DD
><P
>&#13;Six comma separated numbers. Specifing the format for
days, months, years, date format, era format, and complex format.
If string does not contain 6 comma separated numbers all formats are
set to 0, except date format is set to 14.
These formats are used by <SPAN
CLASS="application"
>LifeLines</SPAN
> to display dates in short format.
</P
></DD
><DT
><B
>ShortDisplayDatePic</B
></DT
><DD
><P
>&#13;a custom ymd date picture.  A string in which %y, %m and %d will be
converted to the corresponding year, month and day.
This picture is used by <SPAN
CLASS="application"
>LifeLines</SPAN
> to display dates in short format.
</P
></DD
><DT
><B
>LocaleDir</B
></DT
><DD
><P
>&#13;run-time specification of locale directory
</P
></DD
><DT
><B
>NewDbProps</B
></DT
><DD
><P
>&#13;if specified, properties to add to a newly created database.
The string is of the form "option1=value1\noption2=value2".
</P
></DD
><DT
><B
>IllegalChar</B
></DT
><DD
><P
>&#13;Apparently not used at this time.
</P
></DD
><DT
><B
> DenySystemCalls</B
></DT
><DD
><P
>&#13;If set to a non-zero value will disable use of the <CODE
CLASS="function"
>system</CODE
>
function.
</P
></DD
><DT
><B
>UiLocaleCollate</B
></DT
><DD
><P
>&#13;ui collating sequence
</P
></DD
><DT
><B
>UiLocaleMessages</B
></DT
><DD
><P
>&#13;ui messages locale
</P
></DD
><DT
><B
>RptLocaleCollate</B
></DT
><DD
><P
>&#13;Report Collating Sequence
</P
></DD
><DT
><B
>RptLocaleMessages</B
></DT
><DD
><P
>&#13;Report Messages Locale
</P
></DD
><DT
><B
>ShortOmitString</B
></DT
><DD
><P
>&#13;If defined this string replaces characters at the end of an event being
printed.
</P
></DD
><DT
><B
>DisplayKeyTags</B
></DT
><DD
><P
>&#13;If set to 1 an i or f is prepended to individual and family keys when shown
on-screen.
</P
></DD
><DT
><B
>AnnotatePointers</B
></DT
><DD
><P
>&#13;If set to 1 a descriptive comment is added to pointers when editing family or
individual records to help identify who is being refered to.  These tags
are removed when the edit is finished and not stored in the database.
</P
></DD
><DT
><B
>TTPATH</B
></DT
><DD
><P
>&#13;list of directories to search for translation table files (*.tt)
</P
></DD
><DT
><B
>TTPATH.debug</B
></DT
><DD
><P
>&#13;if defined, <SPAN
CLASS="application"
>LifeLines</SPAN
> outputs debug information
related to translation table processing.
</P
></DD
><DT
><B
>InputPath</B
></DT
><DD
><P
>&#13;path to look for in when reading in gedcom files
</P
></DD
><DT
><B
>INDIREC</B
></DT
><DD
><P
>&#13;The default template to use whenever creating a new individual.
If not specified, the concatenation of the following is used:
<PRE
CLASS="programlisting"
>&#13;"0 INDI\n1 NAME Fname/Surname\n1 SEX MF\n"
"1 BIRT\n  2 DATE\n  2 PLAC\n"
"1 DEAT\n  2 DATE\n  2 PLAC\n1 SOUR\n"
</PRE
>
</P
></DD
><DT
><B
>FAMRECBODY</B
></DT
><DD
><P
>&#13;The default template to use whenever creating a new family.
If not specified, the following is used:
<PRE
CLASS="programlisting"
>&#13;"1 MARR\n  2 DATE\n  2 PLAC\n  2 SOUR\n"
</PRE
>
Note: Unlike the others, this should not
include the 0 level FAM tag.)
</P
></DD
><DT
><B
>SOURREC</B
></DT
><DD
><P
>&#13;The default template to use whenever creating a new source.
If not specified, the following is used in english:
<PRE
CLASS="programlisting"
>&#13;"0 SOUR\n1 REFN\n1 TITL Title\n1 AUTH Author"
</PRE
>
</P
></DD
><DT
><B
>EVENREC</B
></DT
><DD
><P
>&#13;The default template to use whenever creating a new event.
If not specified, the following is used in english:
<PRE
CLASS="programlisting"
>&#13;"0 EVEN\n1 REFN\n1 DATE\n1 PLAC\n1 INDI\n  2 NAME\n  2 ROLE\n1 SOUR"
</PRE
>
</P
></DD
><DT
><B
>OTHR</B
></DT
><DD
><P
>&#13;The default template to use whenever creating a new other record.
If not specified, the following is used in english:
<PRE
CLASS="programlisting"
>&#13;"0 XXXX\n1 REFN"
</PRE
>
</P
></DD
><DT
><B
>HDR_SUBM</B
></DT
><DD
><P
>&#13;string to use when writing gedcom files for the SUBM.
Default is 
<PRE
CLASS="programlisting"
>&#13;"1 SUBM".
</PRE
>
</P
></DD
><DT
><B
>HDR_GEDC</B
></DT
><DD
><P
>&#13;String containing the GEDC block for the header record when exporting GEDCOM.
The default is 
<PRE
CLASS="programlisting"
>&#13;"1 GEDC\n2 VERS 5.5\n2 FORM LINEAGE-LINKED".
</PRE
>
</P
></DD
><DT
><B
>HDR_CHAR</B
></DT
><DD
><P
>&#13;Normally lifelines will populate the CHAR block in the header record
automatically when exporting GEDCOM, with the actual character encoding
being used in the export; this can be found in the settings displayed
in the u(ser) c(harset settings) page. However, if desired, the HDR_CHAR
variable may be used to overwrite the entire CHAR line.
String containing the CHAR block for the header record when exporting GEDCOM.
An example HDR_CHAR value would be "1 CHAR ASCII".
</P
></DD
><DT
><B
>ReportLog</B
></DT
><DD
><P
>&#13;name of file to print report program errors to, if not specified
use stdout curses window.
</P
></DD
><DT
><B
>CrashLog_llexec</B
></DT
><DD
><P
>&#13;file to write crash log into for llexec.  If not set, log is written to
the file <TT
CLASS="filename"
>CrashLog_llexec.log</TT
>.
</P
></DD
><DT
><B
>CrashLog_llines</B
></DT
><DD
><P
>&#13;file to write crash log into for llines. If not set, log is written to
the file <TT
CLASS="filename"
>CrashLog_llines.log</TT
>.
</P
></DD
><DT
><B
>LLTTEXPORT</B
></DT
><DD
><P
>&#13;directory to write translation tables to.  Default is the current
directory.
</P
></DD
><DT
><B
>ImportLog</B
></DT
><DD
><P
>&#13;where to log errors found while importing a gedcom file.
default is errs.log.
</P
></DD
><DT
><B
>gettext.path</B
></DT
><DD
><P
>&#13;for windows, if specified path to (re)load gettext dll
</P
></DD
><DT
><B
>iconv.path</B
></DT
><DD
><P
>&#13;for Windows, path to link dynamically to gettext and iconv
</P
></DD
><DT
><B
>user.fullname</B
></DT
><DD
><P
>&#13;The full name of the current user. If not found as a property it is fetched 
from the system when possible. 
</P
></DD
><DT
><B
>user.email</B
></DT
><DD
><P
>&#13;The email address of the current user. If not found as a property it is 
fetched from the system when possible. 
</P
></DD
><DT
><B
>user.address</B
></DT
><DD
><P
>&#13;Postal address of the current user. 
</P
></DD
><DT
><B
>user.phone</B
></DT
><DD
><P
>&#13;The phone number of the current user. 
</P
></DD
><DT
><B
>user.url</B
></DT
><DD
><P
>&#13;URL to the users home page. 
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="sect1"
><HR><H2
CLASS="sect1"
><A
NAME="AEN2031"
>1.29. Other Executables</A
></H2
><DIV
CLASS="sect2"
><H3
CLASS="sect2"
><A
NAME="AEN2033"
>1.29.1. dbverify</A
></H3
><P
>&#13;dbverify is a utility to check an existing database and report on various
inconsistencies.  It can also repair a number of issues found.
</P
><P
>&#13;dbverify supports the following options:
</P
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN2037"
></A
><TABLE
BORDER="0"
FRAME="void"
CLASS="CALSTABLE"
><COL
WIDTH="48"><COL><TBODY
><TR
><TD
>-a</TD
><TD
>Perform all checks (does not include fixes)</TD
></TR
><TR
><TD
>-D </TD
><TD
>Fix bad delete entries</TD
></TR
><TR
><TD
>-e </TD
><TD
>Check events</TD
></TR
><TR
><TD
>-f </TD
><TD
>Check families</TD
></TR
><TR
><TD
>-F </TD
><TD
>Alter any bad family lineage pointers (to _badptr)</TD
></TR
><TR
><TD
> -g </TD
><TD
>Check for ghosts (names/refns)</TD
></TR
><TR
><TD
>-G </TD
><TD
>Check for &#38; fix ghosts (names/refns)</TD
></TR
><TR
><TD
>-h </TD
><TD
>Display help text (this text)</TD
></TR
><TR
><TD
>-i </TD
><TD
>Check individuals</TD
></TR
><TR
><TD
>-l </TD
><TD
>Check database structure</TD
></TR
><TR
><TD
>-m </TD
><TD
>Check for records missing data entries</TD
></TR
><TR
><TD
>-M </TD
><TD
>Fix records missing data entries</TD
></TR
><TR
><TD
>-n </TD
><TD
>Noisy (echo every record processed)</TD
></TR
><TR
><TD
>-s </TD
><TD
>Check sours</TD
></TR
><TR
><TD
>-x </TD
><TD
>Check others</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="sect2"
><HR><H3
CLASS="sect2"
><A
NAME="AEN2086"
>1.29.2. btedit</A
></H3
><P
>&#13;This program edits raw binary btree blocks in a 
<SPAN
CLASS="application"
>LifeLines</SPAN
> lifelines database file.
Some information about its usage is provided by running:
<PRE
CLASS="programlisting"
>&#13;btedit -h
</PRE
>
Do NOT use this unless
you know what you are doing and you have backed up
your database.
</P
><P
>&#13;The 
<SPAN
CLASS="application"
>LifeLines</SPAN
> database has proven rather robust over
the years.  However, it is important to make frequent backups of any
database.  If you experience database corruption, make sure you save a copy
of the database before trying any recovery process.  Only work on a copy of
the data so that the data is not further damaged.
</P
><P
>&#13;Try exporting the database to a gedcom file from within 
<B
CLASS="command"
>llines</B
>.  Compare the saved file with previously saved
versions.  Editing the gedcom file to correct
issues is often easier than using btedit.
</P
></DIV
><DIV
CLASS="sect2"
><HR><H3
CLASS="sect2"
><A
NAME="AEN2095"
>1.29.3. llexec</A
></H3
><P
>&#13;llexec envokes the LifeLines report execution program without a GUI
for non-interactive processing of report programs.  The supported options are
the same as for <B
CLASS="command"
>llines</B
>.  
</P
><P
>&#13;An example usage, which will open the database 'myfamily' and run the report
eol.ll is:
<PRE
CLASS="programlisting"
>&#13;llexec myfamily -x eol 
</PRE
>
Programs that require input, will prompt for that data and read from standard
input. If a program required the input of a 0 or 1 to control the output,
the following is one way to allow use of llexec in a script:
<PRE
CLASS="programlisting"
>&#13;echo "1" | llexec myfamily -x myprog 
</PRE
>
</P
></DIV
></DIV
></DIV
></DIV
></BODY
></HTML
>
lifelines-doc 3.0.61-2 / usr / share / doc / lifelines-doc / ll-userguide.html
