gramps/gramps2/doc/gramps-manual/C/gramps-manual.xml

<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "0.9.3">
  <!ENTITY manrevision "2.2">
  <!ENTITY date "July 2003">
  <!ENTITY app "<application>GRAMPS</application>">
  <!-- Information about the entities
       The legal.xml file contains legal information, there is no need to edit the file. 
       Use the appversion entity to specify the version of the application.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
       Use the app entity to specify the name of the application. -->
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&app; Manual V&manrevision;</title>       

    <copyright> <year>2003</year> <holder>Alex Roitman</holder> </copyright> 
    <copyright> <year>2001</year> <holder>Donald N. Allingham</holder> </copyright>

<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> <publishername> GRAMPS Project </publishername> </publisher> 

   &legal;
   <!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

    <authorgroup> 
      <author> 
		<firstname>Alex</firstname> 
		<surname>Roitman</surname> 
		<affiliation> 
	  		<orgname>GRAMPS Project</orgname> 
	  		<address> <email>shura@alex.neuro.umn.edu</email> </address> 
		</affiliation> 
      </author> 
      <author> 
		<firstname>Donald N.</firstname> 
		<surname>Allingham</surname> 
		<affiliation> 
	  		<orgname>GRAMPS Project</orgname> 
	  		<address> <email>dallingham@users.sourceforge.net</email> </address> 
		</affiliation> 
      </author> 
      
<!-- This is appropriate place for other contributors: translators,
     maintainers,  etc. Commented out by default.
     
      <othercredit role="translator">
		<firstname>Latin</firstname> 
		<surname>Translator 1</surname> 
		<affiliation> 
	  		<orgname>Latin Translation Team</orgname> 
	  		<address> <email>translator@gnome.org</email> </address> 
		</affiliation>
		<contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>

<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop time frame is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->  
    <revhistory>
      <revision> 
		<revnumber>GRAMPS Manual V&manrevision;</revnumber> 
		<date>&date;</date> 
		<revdescription> 
	  		<para role="author">Alex Roitman
	    	<email>shura@alex.neuro.umn.edu</email>
	  		</para>
	  		<para role="author">Donald A. Peterson
	    	<email>dpeterson@sigmaxi.org</email>
	  		</para>
	  		<para role="publisher">GRAMPS Project</para>
		</revdescription> 
      </revision> 
      <revision> 
		<revnumber>GRAMPS Manual V2.1</revnumber> 
		<date>May 2003</date> 
		<revdescription> 
	  		<para role="author">Alex Roitman
	    	<email>shura@alex.neuro.umn.edu</email>
	  		</para>
	  		<para role="publisher">GRAMPS Project</para>
		</revdescription> 
      </revision> 
      <revision> 
		<revnumber>GRAMPS Manual V2.0</revnumber> 
		<date>April 2003</date> 
		<revdescription> 
	  		<para role="author">Alex Roitman
	    	<email>shura@alex.neuro.umn.edu</email>
	  		</para>
	  		<para role="publisher">GRAMPS Project</para>
		</revdescription> 
      </revision> 
      <revision> 
		<revnumber>GRAMPS User Manual V1.1</revnumber> 
		<date>2001</date> 
		<revdescription> 
	  		<para role="author">Donald N. Allingham 
	    	<email>dallingham@users.sourceforge.net</email>
	  		</para>
	  		<para role="publisher">GRAMPS Project</para>
		</revdescription> 
      </revision> 
      <revision> 
		<revnumber>gramps User Manual V1.0</revnumber> 
		<date>2001</date> 
		<revdescription> 
	  		<para role="author">Donald N. Allingham 
	    	<email>dallingham@users.sourceforge.net</email>
	  		</para>
	  		<para role="publisher">GRAMPS Project</para>
		</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of GRAMPS.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; application or
      this manual, follow the directions in the <ulink url="ghelp:gnome-feedback"
	  type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> <primary>GRAMPS</primary> </indexterm> 
  <indexterm zone="index"> <primary>gramps</primary> </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
  <sect1 id="gramps-intro"> 
    <title>Introduction</title> 
    <para> &app; is a genealogical 
    application. &app; is an acronym for the 
    Genealogical Research and Analysis Management Programming System. To put 
    it shortly, it allows you to store, edit, and research genealogical data 
    using your computer. Its functionality is somewhat common to other 
    genealogical programs. However, &app; offers some unique features. </para> 

    <sect2 id="why-gramps">
      <title>Why &app;?</title>
      <para> &app; was conceived under the concept
      that most genealogy programs were designed to provide the researcher the 
      capability to input information related to a particular family tree.  
      Most of these programs have allowed for the arranging and storing of
      information consistent with the GEDCOM standards. They usually provide
      means for displaying descendant or ancestral relationships by means of
      graphical displays, charts, or reports.  These may be augmented with 
      pictures or other media to enhance the data.  Most provide for inputting 
      data on unconnected individuals/families that may or may not have a 
      relationship to the primary surname being researched.  Various other 
      enhancements may also be provided in the genealogical program that 
      allows for different degrees of importing and exporting data from other 
      programs and printing the data contained in the various reports. </para>
      
      <para> &app;, on the other hand, attempts to
      provide all of the common capabilities of these programs, but, more
      importantly, to provide an additional capability of integration not common
      to these programs.  This is the ability to input any bits and pieces of
      information directly into &app; and
      rearrange/manipulate any/all data events in the entire data base (in any
      order or sequence) to assist the user in doing research, analysis and
      correlation with the potential of filling relationship gaps.  In short, it 
      is a tool that provides a way to input all your research into one place and 
      do your analysis and correlation using the speed, power, and accuracy of 
      your computer instead of pencils and unmanageable reams of paper. </para>
    </sect2>
  </sect1> <!-- ================ End Intro ================================ -->
	
<!-- =========== Getting Started ============================== -->

  <sect1 id="gramps-getting-started"> 
    <title>Getting Started</title> 

    <!-- ================ Getting Started Subsection ====== -->
    <sect2 id="gramps-start">
    <title>To Start &app;</title>
    <para>You can start &app; in the 
    following ways:</para> 
    <variablelist>
    <varlistentry>
	<term><guimenu>Applications</guimenu> menu</term>
	<listitem><para>Choose <menuchoice><guisubmenu>Other</guisubmenu>
	<guimenuitem>Gramps</guimenuitem></menuchoice>. </para></listitem>
    </varlistentry>
    <varlistentry>
	<term>Command line</term>
    	<listitem><para>To start &app; 
	from a command line, type <command>gramps</command>, then 
	press <keycap>Return</keycap>.</para>
	
	<para>If you would like &app; to open 
	a specific database or to import a specific file on startup, you can 
	supply the filename as a command line argument:</para>

	<para>
	<command>gramps -i</command> <replaceable>filename.ged</replaceable>
    	</para> 

    	<para>where <replaceable>filename.ged</replaceable> is the name 
	of the file you	want to open/import. </para></listitem>
    </varlistentry>
    </variablelist>
    </sect2>

    <!-- ================ Getting Started Subsection ==== -->
    <sect2 id="run-1st-time">
      <title>Running &app; for the first time</title>
    <para> 
    The first time you run the program, GRAMPS will display its 
    Getting Started dialogs. Follow the directions guiding you through
    <guilabel>Researcher information</guilabel>, <guilabel>Numerical date 
    formats</guilabel>, <guilabel>Alternate calendar support</guilabel>,
    and <guilabel>LDS extensions</guilabel> sections. Most of the dialogs
    are self-explanatory and will not be covered here.
    </para>
    
	<!-- ==== Figure: Getting Started Druid Window ==== -->
	<figure id="druid-fig"> 
	<title>&app; Getting Started Window: Researcher Information</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/researcher.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Researcher Information Window. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>Enter your personal information in the corresponding
	text entry fields. Although &app; requests information about you, 
	this information is used only so that &app; can create valid GEDCOM 
	output files. A valid GEDCOM file requires information about the file's 
	creator. If you choose, you may leave the information empty, however
	all the GEDCOM files you export will not be valid. 
	</para>
	
	<para>This information can be entered at any time in the 
	<guilabel>Preferences</guilabel> dialog, under the 
	<guilabel>Usage</guilabel> category. 
	</para>


    <!-- ================ Getting Started Sub-subsection  -->
      <sect3 id="choose-db-start">
      <title>Choosing a database on startup</title> 
      <para>If &app; is started without any
      database  to open, the following window will appear prompting you to 
      choose what database to open. </para>
      
	<!-- ==== Figure: Open existing/new database window ==== -->
	<figure id="first-open"> 
	<title>Open Database Window</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/first-open.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Open Database Window.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
      
      <para>If you would like to open an existing database, check the top radio
      button and click the <guibutton>OK</guibutton> button. You will then be asked to 
      specify the name of your existing database. If you would like to start
      creating your brand new database from scratch right away, choose new XML
      database. </para> 
      </sect3>
      
    <!-- ================ Getting Started Sub-subsection  -->
      <sect3 id="zodb-support">
        <title>Optional ZODB support</title> 

      <para>If either StandaloneZODB or Zope is installed on your system, 
      &app; will give you the third option of 
      creating a new ZODB database. You can choose to start your new database 
      in either XML or ZODB format. Both formats have their strong and weak 
      points.</para>

      <para>XML stands for eXtensible Markup Language, and is a human readable
      structured description of data. It could be easily parsed by other 
      programs should the need occur. It stores only the data itself. Its weak 
      point is the relatively low speed of processing large data files. </para>

      <para>ZODB stands for Zope Object Database and provides the full-fledged
      database support. ZODB files are not human readable. They contain a
      certain overhead to assist working with large data structures. However,
      ZODB provides a significant speed-up when the database size is large (over
      a few thousand people). </para>

      <para>Its is hard to tell which format is better, since this is a typical
      trade-off situation. If you are starting your research then you are likely
      to be fine with the regular XML database. If you have tons of data to
      import describing thousands upon thousands of people, then you are
      probably better off with ZODB. </para>

      </sect3>
    </sect2>
    <!-- ================ Getting Started Subsection ==== -->
    <sect2 id="get-help">
      <title>Obtaining Help</title>
    <para> At any time, the following items are available for immediate aid
    from the <menuchoice><guimenu>Help</guimenu></menuchoice> menu: </para>
    
	<variablelist>

	<varlistentry><term>User manual</term>
	<listitem><para> Choose this item to read the text of this manual 
	in the help browser.  </para></listitem>
	</varlistentry>

	<varlistentry><term>GRAMPS home page</term>
	<listitem><para> Select this item to open home page of &app; in your
	default web browser. </para></listitem>
	</varlistentry>
    
	<varlistentry><term>GRAMPS mailing lists</term>
	<listitem><para> Choose this item to direct your web browser 
	to the &app; mailing list archives. </para></listitem>
	</varlistentry>
    
	<varlistentry><term>Report a bug</term>
	<listitem><para> Use this item to file a bug report against &app; 
	with the bug tracking system.  </para></listitem>
	</varlistentry>
    
	<varlistentry><term>Show plugin status</term>
	<listitem><para> Use this item to display the status of loaded 
	plugins. </para></listitem>
	</varlistentry>
    
	<varlistentry><term>Open example database</term>
	<listitem><para> Select this item to load the example database shipped
	with &app;. This database is composed of fictitious people and serves as
	a useful example for learning how to work with &app;. </para></listitem>
	</varlistentry>
    
	</variablelist>
    </sect2>

  </sect1> <!-- ================ End Getting Started ======================== -->
  
<!-- ================ Main Window ================================ -->
  <sect1 id="gramps-mainwin"> 
    <title>Main Window</title> 
    <para>When you open a database (either existing or brand new), 
    the following window is displayed.</para>
 
	<!-- ==== Figure: Main Window  ==== -->
	<figure id="mainwin-fig"> 
	<title>&app; Main Window</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/mainwin.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows &app; main window. Contains titlebar, menubar, 
	      toolbar, sidebar, display area, statusbar, progressbar, and
	      scrollbars. Menubar contains File, Edit, View, Bookmarks, 
	      Reports, Tools, Settings, and Help menus.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

    <para>The &app; window contains the following elements: </para>
      <variablelist>
      <varlistentry><term>Menubar</term>
	<listitem><para>The menubar is located at the very top of the window
        (right below the window title) and provides access to all features of
	&app; through its menus.</para></listitem>
      </varlistentry>
      <varlistentry><term>Toolbar</term>
	<listitem><para> The toolbar is located immediately below the menubar. 
        The toolbar provides access to the most frequently used functions 
        of &app;. The appearance of the toolbar 
        can be adjusted in the <guilabel>Preferences</guilabel> 
	dialog. </para></listitem>
      </varlistentry>
      <varlistentry><term>Progressbar</term>
	<listitem><para>The progressbar is located in the lower left corner 
	of the &app; window. It displays the 
	progress of time consuming operations, such as opening and saving 
	large data bases, importing and exporting to other formats, generating 
	web sites, etc. </para></listitem>
      </varlistentry>
      <varlistentry><term>Statusbar</term>
	<listitem><para>The statusbar is located to the right of the 
        progressbar, on the very bottom of the &app; window. 
	It displays information about current &app; 
	activity and contextual information about the menu items. 
	The behavior of the statusbar can be adjusted in 
	<guilabel>Preferences</guilabel> dialog. </para></listitem>
      </varlistentry>
      <varlistentry><term>Display area</term>
	<listitem><para>The largest area in the center of the
	&app; window is the display area.  
	It shows certain aspects of genealogical information, depending on the 
	currently selected View. The following six Views are available 
	in &app;: 
	<itemizedlist>	
	<listitem><para>People View</para></listitem>
	<listitem><para>Family View</para></listitem>
	<listitem><para>Pedigree View</para></listitem>
	<listitem><para>Sources View</para></listitem>
	<listitem><para>Places View</para></listitem>
	<listitem><para>Media View</para></listitem>

	</itemizedlist>
	</para></listitem>
      </varlistentry>
      </variablelist>

    <!-- ================ Main Window Subsection  -->
    <sect2 id="gramps-views">
      <title>Views</title>
      <para>Views are the various ways to display different aspects of 
      genealogical information, as described below. Since the relevant 
      information is very broad and non-uniform in both context and modality, 
      it is best to split its display into smaller categories, uniform in 
      context and modality. Each View represents such a split and displays a 
      certain portion of overall available information. Before the detailed 
      description of available Views, let us  guide you through the ways of 
      switching between the Views.</para> 

    <!-- ================ Main Window Sub-subsection  -->
      <sect3 id="view-modes">
        <title>Switching Views and Viewing Modes</title>
	<para>Depending on the state of the <menuchoice> 
	<guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem> 
	</menuchoice> menu item, the View could be switched either in the 
	sidebar or in the notebook tabs in the top part of the window. 
	</para>

	<variablelist>
	<varlistentry><term>To switch the View while in a Sidebar mode, 
	click on the desired sidebar icon.</term>
	  <listitem>
	  <!-- ==== Figure: Sidebar Mode ==== -->
	  <figure id="side-nofilt-fig"> 
	  <title>Sidebar Viewing Mode</title> 
	  <screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/mainwin.png" format="PNG"/></imageobject>
	  <textobject> 
	  <phrase>Shows sidebar viewing mode.  </phrase>
	  </textobject></mediaobject></screenshot></figure>
	  <!-- ==== End of Figure ==== -->
	  </listitem></varlistentry>

	<varlistentry><term>To switch the View while in a Notebook mode, 
		click on the desired notebook tab.</term>
	  <listitem>
	  <!-- ==== Figure: Tabbed Notebook Mode ==== -->
	  <figure id="noside-nofilt-fig"> 
	  <title>Tabbed Viewing Mode</title> 
	  <screenshot><mediaobject><imageobject><imagedata 
	  	fileref="figures/noside-nofilt.png" format="PNG"/></imageobject>
	  <textobject> 
	  <phrase>Shows tabbed viewing mode.  </phrase>
	  </textobject></mediaobject></screenshot></figure>
	  <!-- ==== End of Figure ==== -->
	  </listitem></varlistentry>
	</variablelist>

	<para>To switch between sidebar and notebook viewing modes, 
	choose <menuchoice> <guimenu>View</guimenu> 
	<guimenuitem>Sidebar</guimenuitem> 
	</menuchoice> from the &app; menu.</para>
    
      </sect3>

    <!-- ================ Main Window Sub-subsection  -->
      <sect3 id="people-view">
        <title>People View</title>
	<para>When &app; opens a database, 
	the View is set to the People View (<xref linkend="side-nofilt-fig"/> 
	and <xref linkend="noside-nofilt-fig"/>). The People View lists 
        individuals whose data is stored in the database. The People View 
        displays people's <guilabel>Names</guilabel>, 
        &app; <guilabel>ID</guilabel> numbers, 
        <guilabel>Gender</guilabel>, and 
	their <guilabel>Birth</guilabel> and <guilabel>Death dates</guilabel>. 
	The list can be ordered by any field.</para> 

	<para>Example: to order list by the Birth date, click on the
	<guilabel>Birth date</guilabel> column heading. To order list in 
	reverse	(descending) order, click one more time on the desired column
	heading. </para> 

    <!-- ================ Main Window Sub-sub-subsection  -->
        <sect4 id="filters">
          <title>Filters</title>
	  <para>Genealogical databases may contain huge numbers of people. 
	  Since the long lists are hard for humans to handle,
	  &app; provides a convenient way to limit 
	  the scope of browsing by using the filter. To save screen space, 
	  filter controls may be hidden, depending on the state of 
	  <menuchoice> <guimenu>View</guimenu> 
	  <guimenuitem>Filter</guimenuitem> </menuchoice> menu item.</para> 
	  
	<!-- ==== Figure: Enabled Filter ==== -->
	<figure id="side-filt-fig"> 
	<title>Filter Controls Displayed</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/side-filt.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows filter controls.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	  <para>When &app; opens a database, the 
	  filter is set to the trivial filter called <guilabel>All
	  people</guilabel>, i.e. no filtering is in effect. To choose a 
	  filter, use the pop-up <guilabel>Filter</guilabel> menu above the 
	  people's list. Once the filter is chosen, click the 
	  <guibutton>Apply</guibutton> button in the upper right corner of the 
	  window. The filtering will take effect upon clicking the 
	  <guibutton>Apply</guibutton> button. To invert the filtering rule, 
          check the <guilabel>Invert</guilabel> box on the left 
	  of <guibutton>Apply</guibutton> button. </para>
	  
	  <para>Example: To show people without children, choose 
	  <guilabel>People with children</guilabel> filter, then check 
	  <guilabel>Invert</guilabel> box, and then click the 
	  <guibutton>Apply</guibutton> button. To cancel any filtering, set 
	  the filter to <guilabel>All people</guilabel>  
	  and then click the <guibutton>Apply</guibutton> button. </para>
	  
	  <para>Note: even if the filter controls are not displayed 
	  (<menuchoice> <guimenu>View</guimenu> 
	  <guimenuitem>Filter</guimenuitem> </menuchoice> menu item is
	  unchecked), the filtering might still be in place. In other words, 
	  the visibility of the filter controls is not related to the actual 
	  filtering imposed on the list. This may be a cause of confusion, when
	  you enable the filtering and then remove the controls from the
	  display. If in doubt, enable the display of filter controls by 
	  checking <menuchoice> <guimenu>View</guimenu> 
	  <guimenuitem>Filter</guimenuitem> </menuchoice> menu item and check 
	  what kind of filtering is currently set.</para> 
        </sect4>

    <!-- ================ Main Window Sub-sub-subsection  -->
        <sect4 id="alpha-tabs">
          <title>Alphabetical Tabs</title>
	  <para>&app; offers another way of 
	  managing long lists of people -- alphabetical tabs. Upon loading a 
	  database, &app; checks for the stored 
	  family names and breaks the people list into sublists based on the 
	  first letter of their name. The alphabetical tabs are displayed in 
	  the bottom part of the &app; window. 
	  The last tab, <guilabel>Other</guilabel>, stands for unidentified 
	  characters -- all the entries not assigned to any other tab end up 
	  in <guilabel>Other</guilabel>. In particular, people with no family 
	  name will appear under this category.</para> 
        </sect4>

      </sect3>
      
    <!-- ================ Main Window Sub-subsection  -->
      <sect3 id="family-view">
        <title>Family View</title>
	<para>Family View displays the family information of a currently 
	selected (or Active) person. Specifically, this view shows the 
	relationships (e.g marriages, partnerships, etc.) of the active 
	person, his/her parents (or step parents, or guardians, etc), and 
	his/her children (could be step children, adopted children, etc.).
	</para>
	
	<!-- ==== Figure: Family View ==== -->
	<figure id="family-fig"> 
	<title>Family View</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/family.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Family View.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The Active person's data is in the list box in the upper left 
	corner of the window. Directly below it, another box lists the Spouse's
	data, for each relationship of Active person (can be more than one). 
	The double-arrow button to the right of the Active person list box 
	allows you to exchange the currently selected spouse (Current spouse) 
	with the Active person. Double-clicking on the Active person allows the 
	editing of Active person's data. Double-clicking on the Current spouse 
	allows you to edit their relationship information. Shift-clicking on 
        the Current spouse allows the editing of the Current spouse's data.</para>

        <para> To add a new relationship use one of the two upper buttons to the
        right of the spouse box. Click the top one to add a new person to a
        database and to the new relationship. Click the middle one to add a
        person already existing in the database to the new relationship. 
	To remove Current spouse, click the lowest button 
        (<guibutton>-</guibutton>) to the 
	right of the spouse box. Note that removing a spouse from the
        relationship does not remove the person from the database. </para>
	
	<para>The parents of both the Active person and the Current spouse 
	are listed in the corresponding list boxes in the right-hand part of 
	the window (Active person's parents on top, Current spouse parents 
	on the bottom). Both list boxes have a set of three buttons on their 
	right side. The <guibutton>+</guibutton> and <guibutton>-</guibutton>
	buttons allow you to add and remove parents of the Active person and the 
	Current spouse, respectively. Clicking the right arrow button
	makes the family in the corresponding list box an active family. 
	That is, it makes the selected Father the Active person, and the 
	selected Mother the Current spouse. </para>
	
	<para>The bottom list box displays children of the Active person and 
	the Current  Spouse. The Children's list can be ordered by the Birth date 
	in the usual way of clicking on the <guilabel>Birth date</guilabel> column 
	header. In addition to the <guilabel>Name</guilabel>,
	<guilabel>ID</guilabel>, <guilabel>Gender</guilabel>, and
	<guilabel>Birth date</guilabel> columns, the list includes a  
	<guilabel>Status</guilabel> column. The pair of status words reflect the
	relationship between the child and his Father/Mother (such as Birth, Adoption, 
	etc.) Four buttons are available on the right side of the 
	children list box. The top (left arrow) button makes 
	the selected child the Active person. The next two buttons add a new
        child to the family: the upper one adds a new person to the database 
        and to the family, the lower one just adds a person existing in the
        database to the family. Finally, the lowest <guibutton>-</guibutton> 
        button removes the selected child from the family. Note that removing 
        a child from the family does not remove the person from the database.</para> 
      </sect3>

    <!-- ================ Main Window Sub-subsection  -->
      <sect3 id="pedigree-view">
        <title>Pedigree View</title>

	<!-- ==== Figure: Pedigree View ==== -->
	<figure id="pedigree-fig"> 
	<title>Pedigree View</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/pedigree.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Pedigree View.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The Pedigree View helps to visualize the place of the Active 
	person in the tree of his/her ancestors. The Pedigree View shows four 
	generations, going back in time from the Active person
	<guilabel>1</guilabel> to his/her parents <guilabel>2</guilabel>, 
	to grandparents <guilabel>3</guilabel>, to great-grandparents 
	<guilabel>4</guilabel>. 
	Each person is denoted by a white box bearing the person's name. 
	The two lines that converge on the box represent ties with the 
	person's Father (top line) and mother (bottom line). Solid lines 
	represent birth relations, while dashed lines represent non-birth 
	relations (such as adoption, step-parenthood, guardianship, etc.). 
	When the mouse moves over the white box, it expands to display the 
	corresponding person's dates of birth and death. When the mouse is 
	placed over the family line, the line changes color to indicate an 
	active link: double-clicking on the line makes the corresponding 
	ancestor the Active person. The display in that case is re-adjusted 
	to show four generations, starting from the newly selected Active 
	person. </para>
	
	<para>The left-hand side of the window shows the left arrow button. 
	Upon clicking, the button expands to the menu listing the children 
	of the Active person. Selecting the menu item makes the corresponding 
	child the Active person. </para>

	<para>The right-hand side of the window shows two right arrow buttons. 
	When the top button is clicked, the Father of the Active person 
	becomes the Active person. Clicking the bottom button makes the Mother of 
	the Active person the Active person. Again, the display is re-adjusted 
	to show four generations, starting from the newly selected Active 
	person.</para> 
      </sect3>

    <!-- ================ Main Window Sub-subsection  -->
      <sect3 id="sources-view">
        <title>Sources View</title>

	<!-- ==== Figure: Sources View ==== -->
	<figure id="sources-fig"> 
	<title>Sources View</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/sources.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Sources View.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The Sources View lists the sources of information stored in the 
	database. This can include various documents (birth, death, and 
	marriage certificates, etc.), books, films, journals, private diaries, 
	i.e. virtually anything that can be classified as a source of 
	information. The sources can be used as a reference for any event 
	stored in the database. The Source View lists the 
	<guilabel>Title</guilabel>, <guilabel>ID</guilabel>, and the 
	<guilabel>Author</guilabel> of the source. Any column can be 
	used for sorting the list. The usual rules apply: one click for 
	ascending order, another click for descending order.</para> 
      </sect3>

    <!-- ================ Main Window Sub-subsection  -->
      <sect3 id="places-view">
        <title>Places View</title>

	<!-- ==== Figure: Places View ==== -->
	<figure id="places-fig"> 
	<title>Places View</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/places.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Places View.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The Places View lists the geographical places in which the events 
	of the database took place. These could be places of birth, death, 
	and marriages of people, as well as their home, employment, education 
	addresses, or any other conceivable reference to the geographical 
	location. The Places View lists the places' <guilabel>Name</guilabel>,
	<guilabel>ID</guilabel>, <guilabel>Church Parish</guilabel>,
	<guilabel>City</guilabel>, <guilabel>County</guilabel>,
	<guilabel>State</guilabel>, and <guilabel>Country</guilabel>. All of
	these columns can be used for sorting by the usual sorting rules. </para> 
      </sect3>

    <!-- ================ Main Window Sub-subsection  -->
      <sect3 id="media-view">
        <title>Media View</title>

	<!-- ==== Figure: Media View ==== -->
	<figure id="media-fig"> 
	<title>Media View</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/media.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Media View.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The Media View is a list of Media Objects used in the database. 
	Media Objects are any files that relate somehow to the stored 
	genealogical data. Technically, any file can be stored as a Media 
	Object. Most frequently, these are images, audio files, animation 
	files, etc. The list box on the bottom lists the Name, ID, Type, and 
	Path to the Media Object. The top part of the GRAMPS window shows 
	a preview (if available) and information about the Media 
	Object. </para> 
      </sect3>

    </sect2>
  </sect1>  <!-- ================ End Main Window ===================== -->


<!-- ================ Usage ================================ -->
  <sect1 id="gramps-usage"> 
    <title>Usage</title> 
    <para>As commonly encountered in everyday life, in
    &app; there is usually more than one way to
    accomplish something. The alternatives to some actions will therefore 
    be listed as appropriate.</para> 

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="new-db"> 
      <title>Starting a New Database</title> 
      <para>To start a new database, choose <menuchoice><guimenu>File</guimenu>
      <guimenuitem>New</guimenuitem></menuchoice>. You will then be 
      prompted with the <guilabel>Save Database</guilabel> dialog asking 
      to specify the name under which the new database will be stored. 
      Choose an <replaceable>empty directory</replaceable> for your new 
      database (create one if necessary). </para> 
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="open-db"> 
      <title>Opening a Database</title> 
      <para>To open a database, either choose <menuchoice>
      <guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
      or click the <guibutton>Open</guibutton> button on the Toolbar. 
      The <guilabel>Open Database</guilabel> dialog will appear. 
      Either type the full path into the <guilabel>Database</guilabel> text 
      entry field, or click the <guibutton>Browse...</guibutton> button to get 
      the <guilabel>Open File</guilabel> dialog in which you can select the 
      database that you want to open. After you have selected the database, 
      click the <guibutton>OK</guibutton> button to open it. </para>
      
      <para>If you have previously opened databases with &app; you can 
      retrieve your past selections from the drop-down menu by clicking the 
      down arrow button. Finally, if the Revision Control System (RCS) is 
      enabled in the <guilabel>Preferences</guilabel> dialog, the check box 
      <guilabel>Revert to an older version from RCS</guilabel> will be 
      available. Check it to revert your database to an older RCS 
      version. </para>
      
      <para>NOTE: you should open a <replaceable>DIRECTORY</replaceable> and 
      <replaceable>NOT a FILE</replaceable> when opening 
      &app; database. The directory you need to open should contain the 
      database file (data.gramps or data.zodb) as well as any possible copies 
      of media objects. Such a directory is created by &app; when you start 
      a new database and is updated each time the database is saved. </para> 
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="save-db"> 
      <title>Saving a Database</title> 
      <para>To save changes made to your database, choose <menuchoice>
      <guimenu>File</guimenu>
      <guimenuitem>Save</guimenuitem></menuchoice> or click the 
      <guibutton>Save</guibutton> button on the Toolbar. The statusbar will then 
      display the <guilabel>Saving <replaceable>databasename</replaceable>...</guilabel> 
      message, and the progressbar will advance as the saving progresses.</para>
    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="import-data"> 
      <title>Importing Data</title> 
      <para>Importing allows you to incorporate the data from other 
      databases into your currently open &app; database. Currently, 
      &app; can import data from three different 
      formats: GEDCOM, &app; database, and &app; package. All of these are
      available as items of <menuchoice><guimenu>File</guimenu>
      <guisubmenu>Import</guisubmenu></menuchoice> submenu.</para>
      
      <para>Both &app; database, and &app; package are native &app; 
      formats. The package is a compressed archive containing the database 
      file and all media objects (images, sound files, etc.) that the 
      database refers to. The package is created by exporting data to 
      the &app; package, see <xref linkend="export-data"/>. 
      The &app; database is a directory containing the database file and 
      the local media objects. The database may also have references 
      to non-local (external) media objects, therefore it is not guaranteed 
      to be completely portable. The &app; database is created by saving 
      the data in a usual way, see <xref linkend="save-db"/>.
      </para>

      <para>Note that the difference between opening &app; database and 
      importing from &app; database is that importing incorporates all the 
      data into your currently open database, if any. </para>

      <para>After choosing an import format, you will be prompted with the
      <guilabel>Open File</guilabel> dialog asking you to specify the 
      file name from which to import. For GEDCOM and 
      &app; package, select an appropriate file. 
      For &app; database, select a directory which stores 
      the database and all media files (if any).</para> 

      <para>Upon starting the GEDCOM import, &app; 
      will display the following GEDCOM import dialog with the summary of the 
      information about the data. The information is updated as the import
      progresses. </para>

	<!-- ==== Figure: GEDCOM Import ==== -->
	<figure id="gedcom-import-fig"> 
	<title>GEDCOM Import</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/gedcom-import.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows GEDCOM Import Window. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

      <para>Upon starting the &app; database or &app; package import, 
      &app; will display the progress in the 
      progressbar of its main window.</para>

      <para>If a media file is not found during import, the following dialog
      will prompt you for the possible actions:</para>

	<!-- ==== Figure: Missing media window  ==== -->
	<figure id="missing-media-im"> 
	<title>Missing Media dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/missing-media.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Missing Media dialog.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

     <itemizedlist>	
     <listitem>
     <para>To remove the object corresponding to the missing file as well as
      all the references to that object from various database records, click the 
      <guibutton>Remove Object</guibutton> button. This will alter your 
      database so that it will be in a consistent state, but all the 
      references to the missing file will be gone. Use this option if the 
      file is irrevocably lost and there is no possibility of ever replacing 
      it. </para>
      </listitem>

     <listitem>
     <para>To keep the reference to the object corresponding to the missing 
     file, click the <guibutton>Keep Reference</guibutton> button. 
     This will leave things as is, i.e. in an inconsistent state.
     You could supply the missing file later, in which case you will have
     to copy it into your database directory. Choose this option if the
     replacement is possible, but not available right now. </para></listitem>

     <listitem>
     <para>To supply the missing file during import, click the 
     <guibutton>Select File</guibutton> button. This will copy the file you
     select in place of the missing file. No references will be altered
     in the database, and it will be in the consistent state. Use this option
     if the replacement is readily available. 
     </para></listitem>
    
     </itemizedlist>	

    </sect2>  

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="export-data"> 
      <title>Exporting Data</title> 
      
      <para>Exporting allows you to share any portion of your &app; database 
      with other researchers as well as to make your database completely 
      portable to another computer. Currently, &app; 
      can export data  to three different formats: GEDCOM, &app; package, 
      and CD. All of these are available as items of
      <menuchoice><guimenu>File</guimenu>  
      <guisubmenu>Export</guisubmenu></menuchoice> submenu.</para>

      <para>Exporting to GEDCOM will create a GEDCOM file, according to the
      settings set in the following dialog:</para>
      
	<!-- ==== Figure: GEDCOM Export ==== -->
	<figure id="gedcom-export-fig"> 
	<title>Export GEDCOM File dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/gedcom-export.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Export GEDCOM File dialog</phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Export ==== -->

      <para>Type the desired GEDCOM filename into the text entry box or
      click the <guibutton>Browse...</guibutton> button to evoke the  
      <guilabel>Save File</guilabel> dialog. Use the <guilabel>Filter</guilabel>
      pop-up menu to limit the scope of the export according to the stated rule. 
      Choose the desired <guilabel>Encoding</guilabel> of the exported file. 
      Use the <guilabel>Target</guilabel> to select the desired GEDCOM 
      dialect. Select your copyright statement from the 
      <guilabel>Copyright</guilabel> menu. Check <guilabel>Do not include
      records marked private</guilabel> to disable the output of private
      records. Check <guilabel>Restrict data on living people</guilabel>
      to limit living people's data to family ties. With this option, 
      information concerning birth, death, addresses, various events, 
      etc. will be omitted in the exported GEDCOM file.
      </para>

      <para>Upon starting the export, &app; will 
      display the following GEDCOM export progress window with the 
      progressbars reflecting the current state of exporting. </para>

	<!-- ==== Figure: GEDCOM Export ==== -->
	<figure id="gedcom-export-progress-fig"> 
	<title>Export GEDCOM progress dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/gedcom-export-progress.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Export GEDCOM progress dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Export ==== -->

      <para>Exporting to &app; package will create a gzip-compressed tar 
      archive (also known as tarball) which contains gramps database, all 
      local media objects, and copies of all external media objects. This is a
      useful format for moving your database to another machine or for sharing 
      it with somebody, while retaining all the features provided 
      by &app;.
      </para>
      
      <para>Exporting to CD will prepare you database directory with all its
      contents to be recorded to the CD. This is done through the 
      <guilabel>burn:///</guilabel> location in Nautilus. After exporting to 
      CD, go to the <guilabel>burn:///</guilabel> location by  
      selecting <menuchoice><guimenu>Go</guimenu>  
      <guisubmenu>CD Creator</guisubmenu></menuchoice> in Nautilus menu. Your
      database directory will show up. To record it onto the CD, click the CD
      icon on the Nautilus toolbar, or select <menuchoice><guimenu>File</guimenu>  
      <guisubmenu>Write to CD</guisubmenu></menuchoice> in Nautilus menu.
      </para>

      <para>If a media file is not found during export, the following dialog
      will prompt you for the possible actions:</para>

	<!-- ==== Figure: Missing media window  ==== -->
	<figure id="missing-media-ex"> 
	<title>Missing Media dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/missing-media.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Missing Media dialog.  </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

     <itemizedlist>	
     <listitem>
     <para>To remove the object corresponding to the missing file as well as
      all the references to that object from various database records, click
      the <guibutton>Remove Object</guibutton> button. This will alter your 
      database so that it will be in the consistent state, but all the 
      references to the missing file will be gone. Use this option if the 
      file is irrevocably lost and there is no possibility of ever replacing 
      it. </para>
      </listitem>

     <listitem>
     <para>To keep the reference to the object corresponding to the missing 
     file, click the <guibutton>Keep Reference</guibutton> button. 
     This will leave things as is, i.e. in the inconsistent state.
     You could supply the missing file later, in which case you will have
     to copy it into your database directory. Choose this option if the
     replacement is possible, but not available right now. </para></listitem>

     <listitem>
     <para>To supply the missing file during export, click the 
     <guibutton>Select File</guibutton> button. This will copy the file you
     select in place of the missing file. No references will be altered
     in the database, and it will be in the consistent state. Use this option
     if the replacement is readily available. 
     </para></listitem>
    
     </itemizedlist>	

    </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="gramps-edit-quick"> 
      <title>Editing Data: Quick Start</title> 
	<para> Editing any portion of data allows you to amend and/or 
	modify information stored in the database. The available editing 
	options include editing personal data, relationship data, data about
	children and parents, and information about sources, places, and media
	objects used in the database. In short, any data stored in the 
	database can be edited! Adding a new piece of information is in fact
	creating an appropriate empty data structure and subsequent 
	editing of that empty structure. </para>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-add-pers"> 
        <title>To Add a Person</title> 
	<para> To add a person to the database, switch to the People View 
	(<xref linkend="side-nofilt-fig"/>) and then click the 
	<guibutton>Add</guibutton> on the toolbar. 
	Enter any data you know about this person into the <guilabel>Edit 
	Person</guilabel> Dialog (see <xref linkend="edit-pers-fig"/> 
	for details). To edit information about a person already present 
	in the database, select an entry you would like to view/modify, 
	and then click the <guibutton>Edit</guibutton> icon on the toolbar. </para> 
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-spec-rel"> 
        <title>To Specify a Relationship</title> 
	<para>To specify a relationship, first switch to the Family View 
	(<xref linkend="family-fig"/>). Then click the <guibutton>+</guibutton>
	button on the right of the spouse box. Select a spouse/partner from the
	list and specify their relationship using the menu at the bottom. If
	necessary, you can add a person to the list by clicking the 
	<guibutton>Add...</guibutton> button. To edit information about a  
	relationship already present in the database, move the mouse over the 
	<guilabel>Spouse</guilabel> box and double-click. 
	</para>
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-spec-par"> 
        <title>To Specify Parents</title> 
	<para>To specify parents of an active person, first switch to the 
	Family View (<xref linkend="family-fig"/>). Then click the 
	<guibutton>+</guibutton> button on the right of the active person's
	parents list box. Select the parents from two lists and specify the
	parents' relationships to the active person using menus at the bottom. 
	You can also specify parents' relationship to each other. 
	If necessary, you can add a person to the list by clicking the 
	<guibutton>Add...</guibutton> button. </para>
	
	<para> The top and bottom lists contain males and females, 
	respectively. By default, &app; will
	limit both lists to people who could possibly be the parents (judged
	by the date of birth) of the active person. To override this, check
	the <guilabel>Show all</guilabel> box for each list. 
	</para>
	
	<para>To specify parents of the active person's spouse, switch to the 
	Family View and then click the <guibutton>+</guibutton> button on the 
	right of the spouse's parents list box. To edit information about 
	parents already present in the database, move the mouse over 
	the corresponding parents' box and double-click.</para>
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-spec-ch"> 
        <title>To Specify Children</title> 
	<para>To specify children of an active person, switch to the 
	Family View (<xref linkend="family-fig"/>) and then 
	click the <guibutton>+</guibutton> button on the 
	right of the children list box. Select a child from the list and 
	specify	the child's relationship with father and mother using menus 
	at the bottom. If necessary, you can add a person to the list by 
	clicking the <guibutton>Add...</guibutton> button.</para>

	<para> By default, &app; will
	limit the lists to people who could possibly be the child (judged
	by the date of birth) of the active person. To override this, check
	the <guilabel>Show all</guilabel> box. 
	</para>
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-add-img"> 
        <title>To Add Images</title> 
	<para>You can add images (as well as other media objects) to 
	individual people, events, sources, places, as well as images 
	generally related to the database (e.g. group family photos). </para>
	
	<para> To add images related to a single person, switch to the 
	People View (<xref linkend="side-nofilt-fig"/>), select a person, and 
	then click the <guibutton>Edit</guibutton> icon on the toolbar to 
        invoke the <guilabel>Edit Person</guilabel> Dialog 
	(<xref linkend="edit-pers-fig"/>). Then, select the 
	<guilabel>Gallery</guilabel> tab, and click the 
	<guibutton>Add...</guibutton> button to invoke the <guilabel>Select a media 
	object</guilabel> dialog. Type the filename or select a file with the 
	image, then provide a title for that image. To prevent the file from
	being copied into your database directory, check the <guilabel>Do not
	make a local copy</guilabel> box. Keep adding images until you are 
	done. </para>

	<para> To add images related to a relationship (e.g. marriage), 
	switch to the Family View (<xref linkend="family-fig"/>) and then
	double-click on the Spouse box invoke the <guilabel>Marriage/Relationship 
	editor</guilabel> dialog. Select the <guilabel>Gallery</guilabel> 
	tab and click the <guibutton>Add...</guibutton> button to add 
        an image. </para>

	<para> To add images related to a source or a place, first switch to 
	the Sources View (<xref linkend="sources-fig"/>) or Places 
	View (<xref linkend="places-fig"/>), respectively. Then select the 
	appropriate source or place and then either double-click on it 
	or click the <guibutton>Edit</guibutton> icon on the toolbar to invoke the 
	<guilabel>Source Editor</guilabel> (or <guilabel>Place 
	Editor</guilabel>) dialog. Select the <guilabel>Gallery</guilabel> 
	tab and click the <guibutton>Add...</guibutton> button to add 
        an image. </para>

	<para> Finally, to add images that are generally related to the 
	database but not limited to any person, relationship, source, or place 
	in particular, switch to the Media View (<xref linkend="media-fig"/>). 
	Then click the <guibutton>Add</guibutton> icon on the toolbar to 
        add an image. 
	If you have already added any images to any individual galleries, 
	you will also find them listed in the Media View. </para>

	<para> In any gallery, you can also use the <guibutton>Edit...</guibutton> 
	and <guibutton>Remove</guibutton> buttons to edit image information
	and to remove the image reference from that gallery. Note that in all
	galleries removing the reference to the image does not remove the image
	from the database. To completely remove the image from the database, 
	delete it from Media View by first selecting it and then 
	clicking the <guibutton>Remove</guibutton> icon on the toolbar. </para>

      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-edit-src-plc"> 
        <title>To Edit Sources and Places</title> 

	<para> To add a source or a place to the database, switch to 
	the appropriate Sources View (<xref linkend="sources-fig"/>) or 
	Places View (<xref linkend="places-fig"/>). 
	Then click the <guibutton>Add</guibutton> icon on the toolbar to add a
	source/place. Enter the information into the <guilabel>Source 
	Editor</guilabel> (or <guilabel>Place Editor</guilabel>) dialog. 
	</para>

	<para> To edit information about sources and places already present
	in the database, switch to the appropriate view, select an entry
	you would like to view/modify, and then click the 
	<guibutton>Edit</guibutton> icon on the toolbar. Alternatively, you 
        may double-click on the entry to edit it. 
	</para>

      </sect3>
    </sect2>
      
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="gramps-edit-complete"> 
      <title>Editing Data: Complete Description</title> 
      <para> This section provides a complete description of all editing 
      options for all pieces of data in the &app; database. </para>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-pers"> 
        <title>Edit Personal Information</title> 
	<para> Editing of personal data can be performed in the 
	following ways: </para>
	<variablelist>
	<varlistentry><term>From the People View:</term><listitem><para> 
	  Double-click the name of the person whose data you would like 
	  to edit, or select the name by single click and then click the 
	  <guibutton>Edit</guibutton> icon on the toolbar.
	  </para></listitem></varlistentry>
	<varlistentry><term>From the Family View:</term><listitem><para>
	  Move the mouse into the <guilabel>Active person</guilabel> box, 
	  then double-click.
	  </para></listitem></varlistentry>
	</variablelist>
	
	<para> With either method, the following <guilabel>Edit 
	Person</guilabel> dialog will appear: </para>

	<!-- ==== Figure: Edit Person dialog ==== -->
	<figure id="edit-pers-fig"> 
	<title>Edit Person dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
	
	<para> The top of the window shows the name of the person whose 
	data is being edited. The main part of the window displays nine 
	notebook tabs containing different categories of available 
	information. You can bring any tab to the top for viewing
	or editing by clicking on the appropriate tab heading. 
	The bottom part has <guibutton>OK</guibutton> and
	<guibutton>Cancel</guibutton> buttons. Clicking the 
        <guibutton>OK</guibutton> button 
	at any time will apply all the changes made in all tabs and close the
	dialog window. Clicking the <guibutton>Cancel</guibutton> button at any time will 
	close the window without applying any changes. If any of the data
	in any tab were modified, the alert window will appear with the 
	choices of closing the dialog without saving changes, canceling the
	initial cancel request, or saving the changes. 
	</para>

	<para>
	The tabs provide the following information categories of 
	personal data:
	</para>

	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para> 
	The <guilabel>General</guilabel> tab allows editing of 
	general information about the person. This includes the text 
	entry fields of <guilabel>Given name</guilabel>, 
	<guilabel>Family name</guilabel>, <guilabel>Family prefix</guilabel> 
	(such as de or van), <guilabel>Suffix</guilabel> (e.g. Jr. or III), 
	<guilabel>Title</guilabel> (e.g. Dr. or Rev.), 
	<guilabel>Nickname</guilabel> (Bob for Robert), 
	<guilabel>Type</guilabel> of the name (birth name, married name, etc.)
	and <guilabel>Date</guilabel> and <guilabel>Place</guilabel> of birth 
	and death. Some of these (<guilabel>Family name</guilabel>,
	<guilabel>Type</guilabel>, and both <guilabel>Place</guilabel> fields), 
	also allow you to choose the corresponding
	contents from the drop-down menus by clicking on the down arrow button
	located immediately to the right of the text entry field. The 
	available menu choices are formed from the information already stored 
	in the database. Also, when you start to type within these fields, 
	&app; will try to guess the remainder of 
	the text by using the same choices that are available from the
	corresponding menu. To accept the highlighted guess and move to 
	the next field, press the <keycap>Tab</keycap>. </para>
	
	<para>
	The <guilabel>Gender</guilabel> radio buttons offer
	the choice of person's gender between <guilabel>male</guilabel>,
	<guilabel>female</guilabel>, and <guilabel>unknown</guilabel>. 
	The buttons <guibutton>Source...</guibutton> and 
	<guibutton>Note...</guibutton> allow adding or modifying the data about 
	the sources of the name information and any relevant notes. 
	Clicking either <guibutton>Edit...</guibutton> button located next to 
        the birth and death Date fields will bring up a dialog allowing you to 
        edit the corresponding event (birth or death) details.
	The field <guilabel>ID</guilabel> displays an internal 
	&app; ID number which identifies the user in the
	database. Finally, the <guilabel>Image</guilabel> area shows the first
	image available in the <guilabel>Gallery</guilabel> of this 
        person (if any exist).
	</para>
		</listitem></varlistentry>
	</variablelist>
	
	<variablelist>
		<varlistentry><term><guilabel>Names</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - Names ==== -->
	<figure id="edit-pers-names-fig"> 
	<title>Edit Person dialog - Names</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-names.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Names Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para> The <guilabel>Names</guilabel> tab displays information concerning 
	alternate names of the person and the controls allowing their
	modification. The bottom part displays the list of all alternate names
	of the person stored in the database. The top part shows the details 
	of the currently selected name in the list (if any). The buttons
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Delete</guibutton> allow the addition, 
	modification, and removal of an alternate name record from the database. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	an alternate name is selected from the list.  
	</para>
		</listitem></varlistentry>
	</variablelist>
	
	<variablelist>
		<varlistentry><term><guilabel>Events</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - Events ==== -->
	<figure id="edit-pers-events-fig"> 
	<title>Edit Person dialog - Events</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-events.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Events Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The <guilabel>Events</guilabel> tab displays information about 
	the events relevant to the person and controls allowing its
	modification. The bottom part displays the list of all such events 
	stored in the database. The top part shows the details 
	of the currently selected event in the list (if any). The buttons
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Delete</guibutton> allow you to correspondingly add, 
	modify, and remove an event record from the database. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	an event is selected from the list.  
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Attributes</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - Attributes ==== -->
	<figure id="edit-pers-attributes-fig"> 
	<title>Edit Person dialog - Attributes</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-attributes.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Attributes Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The <guilabel>Attributes</guilabel> tab displays information about 
	the attributes of the person and controls allowing their
	modification. These could be any personal attributes of a person whose
	description naturally fits into Parameter-Value pairs (e.g. enormous
	generosity can be stored as the parameter "Generosity" with the 
	value "Enormous", etc.). The bottom part displays the list of all  
	attributes stored in the database. The top part shows the details 
	of the currently selected attribute in the list (if any). The buttons
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Delete</guibutton> allow you to correspondingly add, 
	modify, and remove an attribute record from the database. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	an attribute is selected from the list.  
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Addresses</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - Addresses ==== -->
	<figure id="edit-pers-addresses-fig"> 
	<title>Edit Person dialog - Addresses</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-addresses.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Addresses Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The <guilabel>Addresses</guilabel> tab displays information about 
	the addresses of the person and the controls allowing their
	modification. The bottom part displays the list of all 
	addresses stored in the database. The top part shows the details 
	of the currently selected address in the list (if any). The buttons
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Delete</guibutton> allow you to correspondingly add, 
	modify, and remove an address record from the database. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	an address is selected from the list.  
	</para>

        <para>Some reports allow you to restrict data on living people. 
        In particular, that option will omit the addresses of people who 
        are currently alive.</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Notes</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - Notes ==== -->
	<figure id="edit-pers-notes-fig"> 
	<title>Edit Person dialog - Notes</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-notes.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Notes Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The <guilabel>Notes</guilabel> tab displays information about 
	the notes concerning the person. These could be any notes which do not
	naturally fit into the Parameter-Value pairs available to Attributes. 
	To add a note or modify existing notes simply edit the text in the 
	text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Gallery</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - Gallery ==== -->
	<figure id="edit-pers-gallery-fig"> 
	<title>Edit Person dialog - Gallery</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-gallery.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Gallery Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The <guilabel>Gallery</guilabel> tab displays information about 
	media objects associated with the person and controls allowing subsequent 
	modification. The central part shows the list of all such media objects. 
	For media object which are valid image files, previews of images are 
	displayed. For other objects such as audio files, movie files, etc., a 
	generic &app; icon is displayed instead. Note that the first available
	image in the gallery will be also displayed in the
	<guilabel>Image</guilabel> area in the <guilabel>General</guilabel> 
	tab. The buttons <guibutton>Add...</guibutton>,
	<guibutton>Edit...</guibutton>, and <guibutton>Remove</guibutton> allow
	you to correspondingly add, modify, and remove a media object reference 
	to this person. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Remove</guibutton> buttons become available only when 
	a media object is selected from the list. 
	</para>

	<para>Note: removing a media object from a person's gallery does not 
        remove it from the database. It only removes the reference to that 
        object from this person's record. 
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Internet</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - Internet ==== -->
	<figure id="edit-pers-internet-fig"> 
	<title>Edit Person dialog - Internet</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-internet.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Internet Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The <guilabel>Internet</guilabel> tab displays information about 
	Internet addresses relevant to the person and the controls
	allowing data modification. The bottom part displays the list of all 
	such Internet addresses stored in the database. The top part shows the
	details of the currently selected addresses in the list (if any). 
	The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>,  and <guibutton>Delete</guibutton> 
	allow you to correspondingly add, modify, and remove an Internet address 
	record from the database. The button <guibutton>Go</guibutton> allows
	opening a web-page with the corresponding address with your default 
	browser. Note that the <guibutton>Edit...</guibutton>, 
	<guibutton>Delete</guibutton>, and <guibutton>Go</guibutton> buttons 
	become available only when an address is selected from the list.  
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>LDS</guilabel></term>
		<listitem>

	<!-- ==== Figure: Edit Person dialog - LDS ==== -->
	<figure id="edit-pers-lds-fig"> 
	<title>Edit Person dialog - LDS</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-person-lds.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows LDS Tab of Edit Person dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para>The <guilabel>LDS</guilabel> tab displays information 
	about LDS ordinances of the person and controls allowing 
	modification. These are <guilabel>LDS baptism</guilabel>, 
	<guilabel>Endowment</guilabel>, and <guilabel>Sealed to 
	parents</guilabel> ordinances, as labeled inside the tab. 
	Each ordinance is described by its date, LDS temple, and Place where 
	it happened. An additional pop-up menu <guilabel>Parents</guilabel> is
	available for the <guilabel>Sealed to parents</guilabel> ordinance.
	Each ordinance can further be described by its status through the 
	selections available in the <guilabel>Status</guilabel> pop-up 
	menu and can also be referenced by sources and notes via corresponding 
	<guibutton>Sources...</guibutton> and <guibutton>Note</guibutton>
	buttons. 
	</para>
		</listitem></varlistentry>
	</variablelist>

      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-dates"> 
        <title>Edit Dates</title> 
	<para> Anywhere in &app; where the date 
        is entered or edited, the following rules apply:</para> 

      <variablelist>
      <varlistentry><term>Date validity indicators</term>
	<listitem><para>&app; uses color 
        circles to indicate the validity of the entered date. </para>

        <itemizedlist>
        
        <listitem><para> Green circle means that the date is valid and 
        complete (e.g. May 24, 1961). </para></listitem>

        <listitem><para> Yellow circle means that the date is valid but is
        partial (i.e. not complete). Examples of partial dates are: 1961, 
        about 1961, from 1960 to 1962, before 1963. While partial dates do 
        not exactly define the date, they allow at least for some type of
        comparisons between the dates. </para></listitem>

        <listitem><para> Red circle means that the date is not recognized as 
        a valid date (e.g. Christmas week of 61). In that case the date will 
        be stored as a text string. Therefore, no comparison with other dates 
        will be available. It is best to avoid such date entries. Same 
        information can be entered as a note for the event of interest instead
        of a date. In the example considered, a better things to do is to
        enter December 1961 as a date and Christmas week of 61 as a note.
        </para></listitem> 

        </itemizedlist>
      </listitem></varlistentry>
      </variablelist>

      <variablelist>
      <varlistentry><term>Acceptable date entries</term>
	<listitem><para>&app; recognizes many 
        formats of exact dates. The only problematic formats are XX/XX/XX or
        XX-XX-XX because of the ambiguity between the day and the month.
        The interpretation for this type of formats is configured 
        in <guilabel>Getting Started</guilabel> dialog and can also be changed
        from the <guilabel>Preferences</guilabel> dialog. </para> </listitem>

	<listitem><para>Besides exact dates, &app; 
        recognizes and supports partial dates, date ranges, and alternate
        calendars. </para>
        
        <itemizedlist>
        
        <listitem><para> Partial dates define some portions of the date such 
        as a year or a year and a month. </para></listitem>

        <listitem><para> Date ranges define the boundaries containing the 
        date such as from January 1961 to March 1963. </para></listitem>

        <listitem><para> Alternate calendars are calendars other than Gregorian
        calendar. Currently, &app; supports Hebrew,
        French Republican, Julian, Islamic, and Persian alternate calendars. 
        </para></listitem>

        </itemizedlist>
      </listitem></varlistentry>
      </variablelist>
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-rel"> 
        <title>Edit Relationship Data</title> 
	<para> Editing of relationship data is performed in the following 
	<guilabel>Marriage/Relationship Editor</guilabel> dialog which appears 
	after double-clicking on the spouse box in the Family View.</para>

 	<!-- ==== Figure: Edit Relationship dialog ==== -->
	<figure id="edit-rel-fig"> 
	<title>Marriage/Relationship Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-rel.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Marriage/Relationship Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
	
	<para> The top of the window shows the names of the people whose 
	relationship is being edited. The main part of the window displays 
	six notebook tabs containing different categories of available 
	information. You can bring any tab to the top for viewing
	or editing by clicking on the appropriate tab heading. 
	The bottom part has <guibutton>OK</guibutton> and
	<guibutton>Cancel</guibutton> buttons. Clicking the 
        <guibutton>OK</guibutton> button 
	at any time will apply all the changes made in all tabs and close the
	dialog window. Clicking the <guibutton>Cancel</guibutton> button at any time will 
	close the window without applying any changes. If any of the data
	in any tab were modified, the alert window will appear with the 
	choices of closing the dialog without saving changes, canceling the
	initial cancel request, or saving the changes. </para> 

	<para>
	The tabs provide the following information categories of 
	relationship data:
	</para>

	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para> 
	The <guilabel>General</guilabel> tab allows editing of the most general
	information about the relationship: the relationship type. 
	The available types (such as married, partners, etc.) can be chosen 
	from the drop-down <guilabel>Relationship type</guilabel> menu. 
	The non-editable field <guilabel>ID</guilabel> displays an internal &app; 
	ID number which identifies this relationship in the database. 
	</para>
		</listitem></varlistentry>
	</variablelist>
	
	<variablelist>
		<varlistentry><term><guilabel>Events</guilabel></term>
		<listitem>
	<para>The <guilabel>Events</guilabel> tab displays information about 
	the events relevant to the relationship and the controls allowing 
	modification. The bottom part displays the list of all such events 
	stored in the database. The top part shows the details 
	of the currently selected event in the list (if any). The buttons
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Delete</guibutton> allow you to correspondingly add, 
	modify, and remove an event record from the database. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	an event is selected from the list.  
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Attributes</guilabel></term>
		<listitem>
	<para>The <guilabel>Attributes</guilabel> tab displays information about 
	the attributes of the relationship and the controls allowing
	modification. The bottom part displays the list of all such 
	attributes stored in the database. The top part shows the details 
	of the currently selected attribute in the list (if any). The buttons
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Delete</guibutton> allow you to correspondingly add, 
	modify, and remove an attribute record from the database. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	an attribute is selected from the list.  
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Notes</guilabel></term>
		<listitem>
	<para>The <guilabel>Notes</guilabel> tab displays information about the 
	notes concerning the relationship. These could be any notes which do 
	not naturally fit into the Parameter-Value pairs available to 
	Attributes. To add a note or modify existing notes simply edit the 
	text in the text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Gallery</guilabel></term>
		<listitem>
	<para>The <guilabel>Gallery</guilabel> tab displays information about 
	media objects associated with the person and the controls allowing 
	modification of such. The central part shows the list of all such media objects. 
	For media object which are valid image files previews of images are 
	displayed. For other objects such as audio files, movie files, etc., a 
	generic &app; icon is displayed instead. The buttons 
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Remove</guibutton> allow	you to correspondingly add, modify, 
	and remove a media object reference to this relationship. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Remove</guibutton> buttons become available only when 
	a media object is selected from the list. 
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>LDS</guilabel></term>
		<listitem>
	<para>The <guilabel>LDS</guilabel> tab displays information 
	about the LDS <guilabel>Sealed to spouse</guilabel> ordinance
	  of the person and the controls allowing 
	modification. The data can include date, LDS temple, and Place where 
	it happened. The ordinance can further be described by its status 
	through the selections available in the <guilabel>Status</guilabel> 
	pop-up menu and can also be referenced by sources and notes via 
	corresponding <guibutton>Sources...</guibutton> and 
	<guibutton>Note</guibutton> buttons. </para>
		</listitem></varlistentry>
	</variablelist>

     </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-src"> 
        <title>Edit Source Data</title> 
	<para> To edit source data, switch to the Sources View and select the
	desired entry in the list of sources. Double-click on that entry or
	click the <guibutton>Edit</guibutton> icon on the toolbar to invoke the 
	following <guilabel>Source Editor</guilabel> dialog: </para>

 	<!-- ==== Figure: Source Editor dialog ==== -->
	<figure id="edit-src-fig"> 
	<title>Source Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-src.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Source Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
	
	<para> The top of the window shows the <guilabel>Source
	Editor</guilabel> 
	title of the dialog. The main part of the window displays four notebook 
	tabs containing different categories of available information. You can 
	bring any tab to the top for viewing or editing by clicking on the 
	appropriate tab heading. The bottom part has <guibutton>OK</guibutton> 
	and <guibutton>Cancel</guibutton> buttons. Clicking the 
	<guibutton>OK</guibutton> button at any time will apply all the changes made 
	in all tabs and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data in any tab were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 
	
	<para>
	The tabs provide the following information categories of 
	source data:
	</para>

	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para>The  
	<guilabel>General</guilabel> tab allows editing of the most general
	information about the source: its title, author, and publication
	information. This information can be typed in the appropriate 
	text entry fields. 
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Note</guilabel></term>
		<listitem>
	<para>The <guilabel>Note</guilabel> tab displays any notes concerning 
	the source. To add a note or modify existing notes simply edit the 
	text in the text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Gallery</guilabel></term>
		<listitem>
	<para>The <guilabel>Gallery</guilabel> tab displays information about 
	media objects associated with the given source and controls 
	allowing its modification. The central part shows the list of all 
	such media objects. For media object which are valid image files 
	previews of images are displayed. For other objects such as audio 
	files, movie files, etc., a generic &app; icon is displayed instead. 
	The buttons <guibutton>Add...</guibutton>,
	<guibutton>Edit...</guibutton>, and <guibutton>Remove</guibutton> allow
	you to correspondingly add, modify, and remove a media object reference 
	to this source. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Remove</guibutton> buttons become available only when 
	a media object is selected from the list. 
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>References</guilabel></term>
		<listitem>
	<para>The <guilabel>References</guilabel> tab displays information about 
	database records that refer to this source. If the source is not 
	referenced from any database record, the tab shows an empty list. 
	If the source is referenced from many records, the tab will list 
	all of them. The list can be ordered by any of its column headers:
	<guilabel>Source type</guilabel>, <guilabel>Object</guilabel>, or
	<guilabel>Value</guilabel>. This information cannot be modified from
	the <guilabel>Source Editor</guilabel> dialog. Instead, the
	corresponding database record (e.g. birth event) has to be brought
	up and its source reference edited. </para>
		</listitem></varlistentry>
	</variablelist>

      </sect3>


      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-plc"> 
        <title>Edit Place Data</title> 
	<para> To edit place data, switch to the Places View and select the
	desired entry in the list of places. Double-click on that entry or
	click the <guibutton>Edit</guibutton> icon on the toolbar to invoke the 
	following <guilabel>Place Editor</guilabel> dialog: </para>

	<!-- ==== Figure: Place Editor dialog ==== -->
	<figure id="edit-plc-fig"> 
	<title>Place Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-plc.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Place Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para> The top of the window shows the <guilabel>Place Editor</guilabel> 
	title of the dialog. The main part of the window displays seven 
	notebook tabs containing different categories of available information. 
	You can bring any tab to the top for viewing or editing by clicking on 
	the appropriate tab heading. The bottom part has 
	<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. 
	Clicking the <guibutton>OK</guibutton> button at any time will apply all the 
	changes made in all tabs and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data in any tab were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 
	
	<para>
	The tabs provide the following information categories of 
	place data:
	</para>

	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para>The  
	<guilabel>General</guilabel> tab allows editing of the most general
	information about the place: the title which labels it in the database, 
	city, church parish, county, state, country, longitude, and latitude. 
	This information can be typed in the appropriate text entry fields. 
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Other names</guilabel></term>
		<listitem><para> 
	The <guilabel>Other names</guilabel> tab displays information concerning 
	other names by which the place might be known and the controls 
	allowing their modification. The bottom part displays the list of all 
	other names of the place stored in the database. The top part shows 
	the details of the currently selected name in the list (if any). 
	The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Delete</guibutton> allow 
	you to correspondingly add, modify, and remove a name record 
	from the database. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	a name is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Note</guilabel></term>
		<listitem>
	<para>The <guilabel>Note</guilabel> tab displays any notes concerning 
	the place. To add a note or modify existing notes simply edit the 
	text in the text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Sources</guilabel></term>
		<listitem><para> 
	The <guilabel>Sources</guilabel> tab displays information about sources 
	relevant to this place and controls allowing its modification. 
	The central part displays the list of all such source references 
	stored in the database. The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Delete</guibutton> allow 
	you to correspondingly add, modify, and remove a source reference  
	to this place. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	a source reference is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Gallery</guilabel></term>
		<listitem>
	<para>The <guilabel>Gallery</guilabel> tab displays information about 
	media objects associated with the given place and the controls 
	allowing its modification. The central part shows the list of all 
	such media objects. For media objects which are valid image files 
	previews of images are displayed. For other objects such as audio 
	files, movie files, etc., a generic &app; icon is displayed instead. 
	The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Remove</guibutton> allow
	you to correspondingly add, modify, and remove a media object reference 
	to this source. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Remove</guibutton> buttons become available only when 
	a media object is selected from the list. 
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Internet</guilabel></term>
		<listitem>
	<para>The <guilabel>Internet</guilabel> tab displays information about 
	Internet addresses relevant to the place and controls
	allowing its modification. The bottom part displays the list of all 
	such Internet addresses stored in the database. The top part shows the
	details of the currently selected addresses in the list (if any). 
	The buttons <guibutton>Add...</guibutton>,
	<guibutton>Edit...</guibutton>,  and <guibutton>Delete</guibutton> 
	allow you to correspondingly add, modify, and remove an Internet address 
	record from the database. The button <guibutton>Go</guibutton> allows
	you to open a web-page with the corresponding address with your default 
	browser. Note that the <guibutton>Edit...</guibutton>, 
	<guibutton>Delete</guibutton>, and <guibutton>Go</guibutton> buttons 
	become available only when an address is selected from the list.
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>References</guilabel></term>
		<listitem>
	<para>The <guilabel>References</guilabel> tab displays information about 
	database records that refer to this place. If the place is not 
	referenced from any database record, the tab shows an empty list. 
	If the place is referenced from many records, the tab will list 
	all of them. This information cannot be modified from 
	the <guilabel>Place Editor</guilabel> dialog. Instead, the
	corresponding database record (e.g. birth event) has to be brought
	up and its place reference edited. </para>
		</listitem></varlistentry>
	</variablelist>

      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-media"> 
        <title>Edit Media Data</title> 
	<para> To edit media data, switch to the Media View and select the
	desired entry in the list of sources. Double-click on that entry or
	click <guibutton>Edit</guibutton> on the toolbar to invoke the 
	following <guilabel>Edit Media Properties</guilabel> dialog: </para>

 	<!-- ==== Figure: Edit Media Properties dialog ==== -->
	<figure id="edit-media-fig"> 
	<title>Edit Media Properties dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-media.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Edit Media Properties dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
	
	<para> The top of the window shows the dialog title. Below the title  
	is the preview of an object and the summary of its properties (ID, 
	path, and object type). The central part of the window displays four 
	notebook tabs containing different categories of available information. 
	You can bring any tab to the top for viewing or editing by clicking on 
	the appropriate tab heading. The bottom part has 
	<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. 
	Clicking the <guibutton>OK</guibutton> button at any time will apply all the 
	changes made in all tabs and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data in any tab were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 
	
	<para>
	The tabs provide the following information categories of 
	media object data:
	</para>

	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para>The  
	<guilabel>General</guilabel> tab allows editing the title which labels 
	this object in the database. The title can be typed in the appropriate 
	text entry field. If the object is not local (i.e. the corresponding
	file does not reside under &app; database directory), the
	<guibutton>Make a local copy</guibutton> button is available. 
	Click it to copy the media into the &app; database directory. This will 
	increase the amount of disk space consumed by the &app; database. However, 
	if the external file is deleted or removed, &app; will still be able 
	to use the local copy.  </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Attributes</guilabel></term>
		<listitem>
	<para>The <guilabel>Attributes</guilabel> tab displays information about 
	the attributes of the media object and controls allowing its
	modification. The bottom part displays the list of all such 
	attributes stored in the database. The top part shows the details 
	of the currently selected attribute in the list (if any). The buttons
	<guibutton>Add...</guibutton>, <guibutton>Edit...</guibutton>, 
	and <guibutton>Delete</guibutton> allow you to correspondingly add, 
	modify, and remove an attribute record from the database. 
	Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	an attribute is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Notes</guilabel></term>
		<listitem>
	<para>The <guilabel>Notes</guilabel> tab displays information about the 
	notes concerning the media object. These could be any notes which do 
	not naturally fit into the Parameter-Value pairs available to 
	Attributes. To add a note or modify existing notes simply edit the 
	text in the text entry field. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>References</guilabel></term>
		<listitem>
	<para>The <guilabel>References</guilabel> tab displays information about 
	database records that refer to this media object. If the object is not 
	referenced from any database record, the tab shows an empty list. 
	If the object is referenced from many records, the tab will list 
	all of them. The list can be ordered by any of its column headers:
	<guilabel>Type</guilabel>, <guilabel>Object</guilabel>, or
	<guilabel>Value</guilabel>. This information cannot be modified from
	the <guilabel>Media Object Properties Editor</guilabel> dialog. 
	Instead, the corresponding database record (e.g. birth event) has to 
	be brought up and its media object reference edited in the gallery 
	tab. </para>
		</listitem></varlistentry>
	</variablelist>

      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-ev"> 
        <title>Edit Events</title> 
	<para> Events are edited through the following <guilabel>Event
	Editor</guilabel> dialog: </para> 

 	<!-- ==== Figure: Event Editor dialog ==== -->
	<figure id="edit-ev-fig"> 
	<title>Event Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-ev.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Event Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para> The top of the window shows the dialog title including the name
	of the person whose event is being edited. The central part of the 
	window displays four notebook tabs containing different categories of 
	available information. You can bring any tab to the top for viewing or 
	editing by clicking on the appropriate tab heading. The bottom part has 
	<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. 
	Clicking the <guibutton>OK</guibutton> button at any time will apply all the 
	changes made in all tabs and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data in any tab were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 
	
	<para>The tabs provide the following information categories of 
	the event data: </para>

	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para>The  
	<guilabel>General</guilabel> tab allows editing of the most general
	information about the event: its type, date, place, cause, and
	description. The type can be selected from available types listed 
	in the <guilabel>Event type </guilabel> drop-down menu. The rest 
	of the information can be typed in the appropriate text entry fields. 
	Check the <guilabel>Private record</guilabel> box to mark this event
	record as private. This will give you a chance to omit this event from
	being included in reports, if you choose so among the report 
	generation options. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Sources</guilabel></term>
		<listitem><para>The  
	<guilabel>Sources</guilabel> tab displays information about sources 
	relevant to this event and controls allowing its modification. 
	The central part displays the list of all such sources references 
	stored in the database. The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Delete</guibutton> 
	allow you to correspondingly add, modify, and remove a source reference  
	to this event. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	a source reference is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Note</guilabel></term>
		<listitem>
	<para>The <guilabel>Note</guilabel> tab displays any notes concerning 
	the event. To add a note or modify existing notes simply edit the 
	text in the text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Witnesses</guilabel></term>
		<listitem><para>The 
	<guilabel>Witnesses</guilabel> tab displays information about witnesses 
	relevant to this event and controls allowing its modification. 
	The central part displays the list of all such witnesses 
	stored in the database. The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Delete</guibutton> 
	allow you to correspondingly add, modify, and remove a witness reference  
	to this event. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	a witness reference is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-si"> 
        <title>Edit Source Information</title> 
	<para> When adding source references to events, places, etc., 
	the following dialog appears: </para>

 	<!-- ==== Figure: Source Information dialog ==== -->
	<figure id="edit-si-fig"> 
	<title>Source Information dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-si.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Source Information dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para> The top of the window shows the dialog title. The central part 
	displays the source information. The bottom part has 
	<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons.  
	Clicking the <guibutton>OK</guibutton> button at any time will apply all the 
	changes made and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 

	<para> The source can be selected from available sources listed in the
	<guilabel>Title</guilabel> drop-down menu. If the source you are
	referencing is not present in the database yet, you can enter it into
	the database. To do this, click the <guibutton>New...</guibutton> button 
	and enter source information into the invoked <guilabel>Source 
	Editor</guilabel> dialog. You can also set the details specific for 
	this particular reference: confidence, volume/file/page. date, text, 
	and comments. Choose the confidence 
	level from the <guilabel>Confidence</guilabel> drop-down menu. 
	The rest of the details can be typed in the appropriate text entry
	fields. </para>

      </sect3>
      
      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-an"> 
        <title>Edit Alternate Names</title> 
	<para> Alternate names are edited through the following 
	<guilabel>Alternate Names Editor</guilabel> dialog: </para>

 	<!-- ==== Figure: Alternate Names Editor dialog ==== -->
	<figure id="edit-an-fig"> 
	<title>Alternate Names Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-an.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Alternate Names Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
	
	<para> The top of the window shows the dialog title including the name
	of the person whose alternate name is being edited. The central part 
	of the window displays three notebook tabs containing different 
	categories of available information. You can bring any tab to the 
	top for viewing or editing by clicking on the appropriate tab heading. 
	The bottom part has <guibutton>OK</guibutton> and 
	<guibutton>Cancel</guibutton> buttons. Clicking the 
	<guibutton>OK</guibutton> button at any time will apply all the 
	changes made in all tabs and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data in any tab were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 
	
	<para>The tabs provide the following information categories of 
	the alternate name data: </para>

 	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para>The 
	<guilabel>General</guilabel> tab allows editing of general
	information about the alternate name: given name, family name, family 
	prefix, suffix, title, and type of the name. The information can be 
	typed in the appropriate text entry fields. The family name and the 
	type can be also selected from available choices listed in the 
	appropriate drop-down menus. 
	Check the <guilabel>Private record</guilabel> box to mark this name
	record as private. This will give you a chance to omit this name from
	being included in reports, if you choose so among the report 
	generation options. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Sources</guilabel></term>
		<listitem><para>The 
	<guilabel>Sources</guilabel> tab displays information about sources 
	relevant to this name and controls allowing its modification. 
	The central part displays the list of all such sources' references 
	stored in the database. The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Delete</guibutton> 
	allow you to correspondingly add, modify, and remove a source reference  
	to this name. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	a source reference is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Note</guilabel></term>
		<listitem>
	<para>The <guilabel>Note</guilabel> tab displays any notes concerning 
	the name. To add a note or modify existing notes simply edit the 
	text in the text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>

     </sect3>
      
      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-at"> 
        <title>Edit Attributes</title> 
	<para> Attributes are edited through the following 
	<guilabel>Attribute Editor</guilabel> dialog: </para>

 	<!-- ==== Figure: Attribute Editor dialog ==== -->
	<figure id="edit-at-fig"> 
	<title>Attribute Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-at.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Attribute Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para> The top of the window shows the dialog title including the name
	of the person whose attribute is being edited. The central part 
	of the window displays three notebook tabs containing different 
	categories of available information. You can bring any tab to the 
	top for viewing or editing by clicking on the appropriate tab heading. 
	The bottom part has <guibutton>OK</guibutton> and 
	<guibutton>Cancel</guibutton> buttons. Clicking the 
	<guibutton>OK</guibutton> button at any time will apply all the 
	changes made in all tabs and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data in any tab were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 
	
	<para>The tabs provide the following information categories of 
	the attribute data: </para>

 	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para>The 
	<guilabel>General</guilabel> tab allows editing of the most general
	information about the attribute: name of the attribute and its value. 
	The information can be typed in the appropriate text entry fields. 
	The attribute name can also be selected from available choices (if any) 
	listed in the <guilabel>Attribute </guilabel> drop-down menu. 
	Check the <guilabel>Private record</guilabel> box to mark this 
	attribute record as private. This will give you a chance to omit 
	this attribute from being included in the reports, if you choose 
	so among the report generation options. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Sources</guilabel></term>
		<listitem><para>The 
	<guilabel>Sources</guilabel> tab displays information about sources 
	relevant to this attribute and controls allowing its modification. 
	The central part displays the list of all such sources references 
	stored in the database. The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Delete</guibutton> 
	allow you to correspondingly add, modify, and remove a source reference  
	to this attribute . Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	a source reference is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Note</guilabel></term>
		<listitem>
	<para>The <guilabel>Note</guilabel> tab displays any notes concerning 
	the attribute . To add a note or modify existing notes simply edit the 
	text in the text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>
      </sect3>
      
      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-ad"> 
        <title>Edit Addresses</title> 
	<para> Addresses are edited through the following 
	<guilabel>Address Editor</guilabel> dialog: </para>

 	<!-- ==== Figure: Address Editor dialog ==== -->
	<figure id="edit-ad-fig"> 
	<title>Address Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-ad.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Address Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
	
	<para> The top of the window shows the dialog title including the name
	of the person whose address is being edited. The central part 
	of the window displays three notebook tabs containing different 
	categories of available information. You can bring any tab to the 
	top for viewing or editing by clicking on the appropriate tab heading. 
	The bottom part has <guibutton>OK</guibutton> and 
	<guibutton>Cancel</guibutton> buttons. Clicking the 
	<guibutton>OK</guibutton> button at any time will apply all the 
	changes made in all tabs and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window without 
	applying any changes. If any of the data in any tab were modified, 
	the alert window will appear with the choices of closing the dialog 
	without saving changes, canceling the initial cancel request, or saving 
	the changes. </para> 
	
	<para>The tabs provide the following information categories of 
	the address data: </para>

 	<variablelist>
		<varlistentry><term><guilabel>General</guilabel></term>
		<listitem><para>The 
	<guilabel>General</guilabel> tab allows editing of the most general
	information about the address: date, street address, city or county, 
	state or province, country, and the postal code. The information can 
	be typed in the appropriate text entry fields. 
	Check the <guilabel>Private record</guilabel> box to mark this address 
	record as private. This will give you a chance to omit this address 
	from being included in reports, if you choose so among the report 
	generation options. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Sources</guilabel></term>
		<listitem><para>The 
	<guilabel>Sources</guilabel> tab displays information about sources 
	relevant to this address and controls allowing its modification. 
	The central part displays the list of all such sources references 
	stored in the database. The buttons <guibutton>Add...</guibutton>, 
	<guibutton>Edit...</guibutton>, and <guibutton>Delete</guibutton> 
	allow you to correspondingly add, modify, and remove a source reference  
	to this address. Note that the <guibutton>Edit...</guibutton> and 
	<guibutton>Delete</guibutton> buttons become available only when 
	a source reference is selected from the list. </para>
		</listitem></varlistentry>
	</variablelist>

	<variablelist>
		<varlistentry><term><guilabel>Note</guilabel></term>
		<listitem>
	<para>The <guilabel>Note</guilabel> tab displays any notes concerning 
	the address. To add a note or modify existing notes simply edit the 
	text in the text entry field.
	</para>
		</listitem></varlistentry>
	</variablelist>

      </sect3>
      
      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-wit"> 
        <title>Edit Witnesses</title> 
	<para> Witnesses are edited through the following 
	<guilabel>Witness Editor</guilabel> dialog: </para>

 	<!-- ==== Figure: Witness Editor dialog ==== -->
	<figure id="edit-wi-fig"> 
	<title>Witness Editor dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-wi.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Witness Editor dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->
	
	<para> The top of the window shows the dialog title. The central part 
	of the window displays information about the witness. The bottom part 
	has <guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. 
	Clicking the <guibutton>OK</guibutton> button at any time will apply all the 
	changes made and close the dialog window. Clicking the 
	<guibutton>Cancel</guibutton> button at any time will close the window 
	without applying any changes. If any of the data were 
	modified, the alert window will appear with the choices of closing 
	the dialog without saving changes, canceling the initial cancel 
	request, or saving the changes. </para> 
	
	<para>The witness name can be entered in two ways, depending upon 
	whether the witness is a person already stored in the database or 
	not (unrelated person). </para> 
	
	<variablelist>
		<varlistentry><term>Person from the database</term>
		<listitem><para> 
	If the person's data are stored in a database, check <guilabel>Person 
	is in the database</guilabel> box. Then click the 
        <guibutton>Select</guibutton> button to evoke <guilabel>Select
        Person</guilabel> dialog. Choose the person from that dialog and 
        click the <guibutton>OK</guibutton> button. The <guilabel>Person</guilabel> 
        text field will display the name of the person you selected. 
        Note: even though the person's name is displayed in the 
        <guilabel>Person</guilabel> field, it is not available for direct
        editing. 
	</para></listitem></varlistentry>
	</variablelist>
	
	<variablelist>
		<varlistentry><term>Unrelated person</term>
		<listitem><para> 
	If the person is not in the database, make sure that 
	<guilabel>Person is in the database</guilabel> box is unchecked. 
	Then enter the name or any description of a person into the
	<guilabel>Person</guilabel> text entry field. This information 
	is stored as entered, and this is the only place it is stored.
	In other words, there is no reference to that person in the entire 
	database except for this witness reference. If the person is in fact
	a member of the database, it is advised to use the former method.
	</para>
		</listitem></varlistentry>
	</variablelist>
	
	<para> The <guilabel>Comment</guilabel> text area allows you to enter 
	any comments concerning the witness. To add a comment or to modify 
	existing comments simply edit the text in the text area.
	</para>

      </sect3>
      
       <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="adv-merge"> 
        <title>Merge People</title> 
	<para> Sometime two people entries in the database turn out to be 
        describing the same person. When this happens, merging people is 
        a useful useful way of correcting the situation. </para>
        
        <para> To make a merge, exactly two people have to be selected in the
        People View. This is accomplished by selecting one person and then
        selecting another person while holding down <keycap>Ctrl</keycap> key.
        </para>
        
        <para> When exactly two people are selected, choose
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Merge...</guimenuitem></menuchoice>
        to evoke <guilabel>Merge</guilabel> dialog. The dialog allows you to
        retain the data from either person as the primary data for the new
        (merged) person. The data from the other person can be kept as alternate
        data if you so choose. If you would like to continue editing data of 
        a newly merged person, click the <guibutton>Merge and edit</guibutton>
        button. </para>
      </sect3>

   </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="gramps-nav"> 
       <title>Navigation</title> 
	<para> As long as any database is open, &app; is focused on a 
	single person usually referred to as an Active person. This 
	allows you to view or modify the data concerning this person, 
	his or her immediate family, etc. Navigating in the database (i.e. 
	moving from person to person) is in fact nothing else but changing 
	the Active person. This section describes many alternative ways
	to navigate through the database using both the complex and the 
        convenient interfaces &app; provides. All these ways eventually 
        accomplish the same thing, but some are more convenient than others, 
        depending what you are doing in &app; at the moment. </para>
       
      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-people"> 
        <title>Using the People View </title> 
	<para> The most intuitive way to select an active person is 
	to use the People View (see <xref linkend="people-view"/>). 
        When in the People View, just select the 
	name of the desired person from the list by clicking that list 
	entry. The person you have selected becomes active. The statusbar 
	updates to reflect the change of the active person. </para> 
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-family"> 
        <title>Using the Family View</title> 
	<para> When in the Family View (see <xref linkend="family-view"/>), 
        you can easily navigate between the members of the displayed family 
        as follows: </para>

	<itemizedlist>
	<listitem><para>To make the currently selected spouse the active person, 
	click the double-arrow button to the right of the active person box. 
	</para></listitem>
	
	<listitem><para>To make the currently selected parents the active family
	(thereby making father the active person and mother the selected
	spouse), click the right-arrow button to the right of the active person's
	parents box. </para></listitem> 
	
	<listitem><para>To make the currently selected spouse's parents 
	the active family (thereby making father the active person and mother 
	the selected spouse), click the right-arrow button to the right of the 
	spouse's parents box.</para></listitem>
	
	<listitem><para>To make the currently selected child the active person, 
	click the left-arrow button to the right of the children box. 
	</para></listitem>

	</itemizedlist>
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-pedigree"> 
        <title>Using the Pedigree View</title> 
	<para> The Pedigree View (see <xref linkend="pedigree-view"/>) also 
        allows you to move along the family tree. 
	The benefit of this method is that you can see more than one 
	generation of the family tree. Also, you can jump directly from a
	great-grandson to a great-grandfather without going through the 
	intermediate generations. </para>

	<para> Note that after changing the active person in the Pedigree 
	View, the display is re-adjusted to show four generations, starting 
	from the newly selected Active person. When in the Pedigree View, you 
	can easily navigate between the members of the displayed family tree 
	as follows: </para> 

	<itemizedlist>
	<listitem><para>To make any displayed person the active person, 
	double-click the line that connects to the left side of the
	corresponding box. </para></listitem>

	<listitem><para>To make a child of the currently active person (if any) 
	the active person, click the left arrow button to the left of the
	corresponding box. If there is more than one child, the button expands
	to the menu listing the children to choose from. </para></listitem> 

	<listitem><para>To move the whole family tree one generation back,
	click on the corresponding right arrow button on the right-hand side 
	of the display area. Clicking the upper button will move the tree 
	along the paternal line. Clicking the lower button will move the 
	tree along the maternal line. </para>

	<para> Clicking either of these buttons is completely equivalent to
	double-clicking the lines connecting to the left of the corresponding
	boxes for father and mother. </para></listitem>
	</itemizedlist>

      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-default"> 
        <title>Setting the Default Person</title> 
	<para> One and only one person in the database can be selected as the 
	default person. Once the default person is selected, moving to that
	person becomes a matter of a single click, regardless of which view 
	you are using at the moment. </para>

	<para> To set the default person, first navigate to that person using 
	any method you like. Then choose 
	<menuchoice><guimenu>Settings</guimenu>
	<guimenuitem>Default Person</guimenuitem></menuchoice>. Once this is 
	done, you can move to the default person from anywhere in the 
	database by simply clicking the <guibutton>Home</guibutton> icon 
        on the toolbar. </para>
	
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-bookmk"> 
        <title>Bookmarking People</title> 
	<para> Similar to setting the default person, you can bookmark other 
        people from the database to simplify further navigation. To bookmark 
        a person, first navigate to that person, then choose 
	<menuchoice><guimenu>Bookmarks</guimenu>
	<guimenuitem>Add bookmark</guimenuitem></menuchoice>. To move to that
	person from anywhere in the database, choose 
	<menuchoice><guimenu>Bookmarks</guimenu>
	<guisubmenu>Go to bookmark</guisubmenu>
	<guimenuitem><replaceable>Person's name</replaceable></guimenuitem>
	</menuchoice>. </para>
	
	<para> You can manage your bookmarks by choosing 
	<menuchoice><guimenu>Bookmarks</guimenu>
	<guimenuitem>Edit bookmarks...</guimenuitem></menuchoice>. This opens
	the following <guilabel>Edit Bookmarks</guilabel> dialog with the 
	list of	bookmarks and the controls to modify this list. </para>
	
 	<!-- ==== Figure: Edit Bookmarks dialog ==== -->
	<figure id="edit-bm-fig"> 
	<title>Edit Bookmarks dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/edit-bm.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Edit Bookmarks dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-find-people"> 
        <title>Finding People</title> 
	<para> To find a person in a database, choose 
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice> 
        when in the People View, Family View, or Pedigree View. This opens a 
        <guilabel>Find Person</guilabel> dialog which can be used for searching
        forward and backward. </para>
	
	<para> If the search is successful, the found person becomes an active
        person and the display adjusts according to the new active person and the
        current view. </para>
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-find-sources"> 
        <title>Finding Sources</title> 
	<para> To find a source in a database, choose 
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice> 
        when in the Sources View. This opens a <guilabel>Find Source</guilabel>
        dialog which can be used for searching forward and backward. If the
        search is successful, the found source becomes highlighted. </para> 
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-find-places"> 
        <title>Finding Places</title> 
	<para> To find a place in a database, choose 
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice> 
        when in the Places View. This opens a <guilabel>Find Place</guilabel> 
        dialog which can be used for searching forward and backward. If the 
        search is successful, the found place becomes highlighted. </para> 
      </sect3>

      <!-- ================ Usage Sub-subsection ================ -->
      <sect3 id="gramps-nav-find-media"> 
        <title>Finding Media Objects</title> 
	<para> To find a media object in a database, choose 
        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice> 
        when in the Media View. This opens a <guilabel>Find Media Objects</guilabel> 
        dialog which can be used for searching forward and backward. If the 
        search is successful, the found media object becomes highlighted. </para> 
      </sect3>

   </sect2>
   
    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="gen-reports"> 
        <title>Generating Reports</title> 
	<para> Reports are the most common form of the output produced by
	genealogical research. The majority of genealogical software puts a lot
	of emphasis on developing nicely looking reports. &app; is no 
	exception in this regard: it offers a choice of a variety of reports. 
	&app; can generate reports in a multitude of open formats, both 
	text based and graphical. &app; can also produce screen based reports 
	that are convenient for viewing a summary of your database. 
	Finally, &app; can generate a web site suitable for immediate 
	posting on the Internet. All these are almost infinitely flexible: 
        if you wish to modify or extend the default format of &app; report 
	you can design and choose the style for each of your reports. </para>

	<para> All reports can be accessed through the menu by choosing
	<menuchoice><guimenu>Reports</guimenu>
	<guisubmenu><replaceable>Report Type</replaceable></guisubmenu>
	<guimenuitem><replaceable>Particular 
	Report</replaceable></guimenuitem></menuchoice>. Alternatively, 
	you can browse the complete selection of available reports along 
	with their brief descriptions in a <guilabel>Report 
	Selection</guilabel> dialog evoked by clicking the 
	<guibutton>Reports</guibutton> icon on the toolbar. 
	</para>


      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="rep-graph"> 
	<title>Graphical Reports</title> 
	<para> Graphical reports represent information in forms of charts 
	and graphs. Most of the options are common among graphical reports, 
	therefore they will be described only once, at the end of this 
	section. The few options which are specific to a given report will be 
	described directly in that report's entry.</para>

	<para>The following graphical reports are currently 
	available in &app;: </para>
	
	<variablelist>

	<varlistentry><term>Ancestor Chart</term>
	<listitem><para>This report generates the chart of people who are
	ancestors of the Active person. Specific options include 
	the number of generations considered and the format of the displayed 
	entries. </para></listitem>
	</varlistentry>

	<varlistentry><term>Descendant Graph</term>
	<listitem><para>This report generates a graph of people who are
	descendants of the Active person. Specific options include 
	the format of the displayed entries. </para></listitem>
	</varlistentry>

	<varlistentry><term>Relationship Graph</term>
	<listitem><para>This report creates a complex relationship graph in 
	GraphViz format. The GraphViz <command>dot</command> tool can 
	transform the graph into postscript, jpeg, png, vrml, svg, and many
	other formats. GraphViz tools are freely available from the 
	<ulink url="http://www.graphviz.org" type="http">GraphViz 
	site</ulink>. Specific options for this report 
	include filter and number of generations considered, as well as 
	several GraphViz-specific options related to pagination, color, 
	and details of the graph. </para></listitem>
	</varlistentry>

	<varlistentry><term>Timeline Graph</term>
	<listitem><para>This report outputs the list of people with their
	lifetimes represented by intervals on a common chronological scale. 
	Specific options include filter, sorting method, and the title of 
	the report. </para></listitem>
	</varlistentry>

	</variablelist>

	<para>Common options for graphical reports are the filename of the
	output, the format of the output, selected style, page size and 
	orientation. </para>

      </sect3>

      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="rep-text"> 
	<title>Text Reports</title> 
	<para> Text reports represent the desired information as formatted 
	text. Most of the options are common among text reports, 
	therefore they will be described only once, at the end of this 
	section. The options which are specific to a given report will be 
	described directly in that report's entry.</para>
	
	<para>The following text reports are currently 
	available in &app;:</para>

	<variablelist>

	<varlistentry><term>Ahnentafel Report</term>
	<listitem><para>This report lists the active person and his or her 
	ancestors along with their vital data. The people are numbered in a 
	special way which is an established standard called Ahnentafel. 
	The active person is given number 1. His or her father and mother 
	have numbers 2 and 3, respectively. This rule holds for every person 
	while going back in generations: father's parents are numbered 4 and 5, 
	and mother's parents are numbered 6 and 7, fathers always numbered 
	with even and mothers with odd numbers. Therefore, for any person 
	having number N in this tree, the numbers of father and mother 
	are 2N and 2N+1, respectively. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term>Ancestors Report</term>
	<listitem><para>This report produces a detailed description 
	of ancestors of the active person. The highlights of this report
        include specific layout, images of children, present and former 
        spouses, and source citations. Specific options: number 
	of backward generations to consider, whether to cite sources, 
        and whether to break pages between generations. </para></listitem>
	</varlistentry>

	<varlistentry><term>Complete Individual Report</term>
	<listitem><para>This report provides individual summaries similar to
	that of the Individual Summary report. The advantage of this report 
	is the specific filter option. Depending on the filter choice (active
	person only, his or her descendants, his or her ancestors, or entire
	database), the report may contain from one to many individual 
	summaries. Another option for this report is the inclusion of 
	source information when listing events. </para></listitem>
	</varlistentry>

	<varlistentry><term>Descendant Report</term>
	<listitem><para>This report produces a brief description 
	of descendants of the active person. Specific options: number 
	of forward generations to consider. </para></listitem>
	</varlistentry>

	<varlistentry><term>Detailed Ancestral Report</term>
	<listitem><para>This report covers in detail the ancestors of the
	active person. It includes vital data (birth and death) as well as 
	marriages. Specific options: number of backward generations 
	to consider, as well as a variety of options regarding the exact 
	contents to include. </para></listitem>
	</varlistentry>

	<varlistentry><term>Detailed Descendant Report</term>
	<listitem><para>This report covers in detail the descendants of the
	active person. It includes vital (birth and death) information as well as 
	marriages. Specific options: number of forward generations 
	to consider. </para></listitem>
	</varlistentry>

	<varlistentry><term>FTM Style Ancestral Report</term>
	<listitem><para>This report creates an ancestral report similar to 
        that produced by the Family Tree Maker (tm) program. It covers in detail the 
        active person and his/her ancestors It includes vital information 
        as well as marriages, children, and notes.  Specific options: number 
        of backward generations to consider. </para></listitem>
	</varlistentry>

	<varlistentry><term>FTM Style Descendant Report</term>
	<listitem><para>This report creates a descendant report similar to 
        that produced by the Family Tree Maker (tm) program. It covers in detail the 
        active person and his/her descendants. It includes vital information 
        as well as marriages, children, and notes. Specific options: 
        number of forward generations to consider. </para></listitem>
	</varlistentry>

	<varlistentry><term>Family Group Report</term>
	<listitem><para>This creates a family group report, showing
	information on a set of parents and their children. Specific 
	options: the spouse (available only if the active person has more
	than one spouse). </para></listitem>
	</varlistentry>

	<varlistentry><term>Individual Summary</term>
	<listitem><para>This report produces a detailed summary on the 
	active person. The report includes all the facts known to the 
	database about that person. </para></listitem>
	</varlistentry>

	</variablelist>

	<para>Common options for text reports are the filename of the
	output, the format of the output, selected style, page size and 
	orientation. For HTML reports, there is no page information. 
	Instead, HTML options include the choice of the HTML template, 
	either available in &app; or a custom template defined by you. </para>

      </sect3>

      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="rep-books"> 
	<title>Books</title> 
	<para> Currently, the only available report under this category
        is the Book Report. </para>

	<para> The Book Report creates a single document (i.e. a Book) 
        containing a collection of graphical and textual reports.
        However, as of version &appversion; the Text reports are available 
        for inclusion in books. Nevertheless, this allows for a very rich set 
        of documents that &app; can produce. 
        </para>

	<para> When Book Report is selected, the following book configuration
        dialog appears: </para>

 	<!-- ==== Figure: Book Report dialog ==== -->
	<figure id="rep-book-fig"> 
	<title>Book Report dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/bookreport.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Book Report dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para> The <guilabel>Book name</guilabel> text entry field is used to
        save the book (a set of configured selections) for future use.
        The pane on the left side lists the items available for inclusion in the 
        book. The pane on the right side lists the currently selected items in
        the order they will appear in the book. </para>
        
	<para> The top set of buttons between the panes operates on the 
        selected book item. Click the <guibutton>Add</guibutton> button to add selected 
        item from the available list to the current book. Click the 
        <guibutton>Remove</guibutton> button to remove an item from the current book.
        Use <guibutton>Up</guibutton> and <guibutton>Down</guibutton> to change
        the items order in the current book. Click the <guibutton>Setup</guibutton>
        button to configure the options of the selected item of the current book. 
        </para>
        
	<para> The bottom set of buttons between the panes operates on the 
        whole book. Click the <guibutton>Clear</guibutton> button to clear all items from
        the current book. Click the <guibutton>Save</guibutton> button to save the current
        book (under the name typed in the <guilabel>Book name</guilabel> text
        entry field) for future use. Note that saving the book also saves the 
        configuration for each item. Click the <guibutton>Open</guibutton> button to load
        the book from the list of previously saved books. Finally, click the 
        <guibutton>Edit books</guibutton> button to evoke the editable list of
        available books.  
        </para>

	<para> The configuration dialogs evoked by <guibutton>Setup</guibutton>
        are item-specific. If you choose not to configure the item, sane
        defaults will be used for all needed options. The common option for 
        almost all book items is the center person: the person on whom the
        item is centered. Thanks to this option, you can create a book with
        items centered on different people (e.g. your mom's and dad's 
        ancestors as separate chapters). By default, the center person is set to
        the active person. </para> 

      </sect3>

      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="rep-view"> 
	<title>View Reports</title> 
	<para> View reports represent overall summaries of the database 
	information available immediately for on-screen viewing. 
	The following view reports are currently available in &app;:</para>

	<variablelist>

	<varlistentry><term>Number of ancestors</term>
	<listitem><para>This report displays the number of ancestors of the
	active person. </para></listitem>
	</varlistentry>

 	<varlistentry><term>Summary of the database</term>
	<listitem><para>This report displays the overall statistics concerning
	number of individuals of each gender, various incomplete entries
	statistics, as well as family and media statistics. </para></listitem>
	</varlistentry>

	</variablelist>
     </sect3>

      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="rep-web"> 
	<title>Web Page</title> 

	<para> This report generates web pages, either for a selected 
	individual (active person) or a set of individuals. The options 
	for this report are broken down into contents, privacy, and advanced 
	options. The contents options include the filter (determine the 
	scope of the database to consider), number of generations to consider, 
	destination directory for the images, and a link to the index page.
	Privacy options allow you to omit private records, restrict 
	information on living people, to skip images (either all or only 
        those of living people), and to omit comments and text in source 
        information. Finally, the advanced options allow you to include 
        the optional &app; ID, create a GENDEX index, and specify the 
        extension of the resulting files. </para>

      </sect3>

   </sect2>

    <!-- ================ Usage Subsection ================================ -->
    <sect2 id="gramps-tools"> 
        <title>Running Tools</title> 
	<para> &app; tools allow you to perform various types of analyses
	of your genealogical data. Typically, the tools do not produce 
	output in form of printouts or files. Instead, they produce screen
	output immediately available for the researcher. However, when
	appropriate, you can save the results of running a tool into a file. 
	Tools present one of the major strengths of &app; compared to the most
	genealogical software. </para> 
	
	<para>The tools can be accessed through the menu by choosing 
	<menuchoice><guimenu>Tools</guimenu>
	<guisubmenu><replaceable>Tool Section</replaceable></guisubmenu>
	<guimenuitem><replaceable>Particular 
	Tool</replaceable></guimenuitem></menuchoice>. Alternatively, 
	you can browse the complete selection of available tools along 
	with their brief descriptions in a <guilabel>Tool 
	Selection</guilabel> dialog evoked by clicking the 
	<guibutton>Tools</guibutton> icon on the toolbar. </para>

      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="tools-ae"> 
	<title>Analysis and Exploration</title> 
	<para> This section contains tools which analyze and explore the
	database, but do not alter it. The following analysis and exploration
	tools are currently available in &app;: </para>

	<variablelist>

	<varlistentry><term>Compare individual events</term>
	<listitem><para>This tool compares events across the selected group of
	people. The people for this comparison are chosen with the use of 
	custom filters. The custom filters can be created in the Custom Filter
	Editor (see <xref linkend="tools-util"/>). The resulting table produced
	by this tool can be saved as a spreadsheet. </para></listitem>
	</varlistentry>

 	<varlistentry><term>Interactive descendant browser</term>
	<listitem><para>This tool builds a tree with the active person being 
	the root. Children branch from their parents in the usual manner. 
	Use this tool for a quick glance of a person's descendants. 
	</para></listitem>
	</varlistentry>

	</variablelist>
      </sect3>

      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="tools-db"> 
	<title>Database Processing</title> 
	<para> This section contains tools which may modify your database. 
	The modifications will only be performed upon your explicit consent. 
	The tools from this section are used mostly for finding and correcting
	errors in the data. The following database processing tools are 
	currently available in &app;:</para>

	<variablelist>

 	<varlistentry><term>Check and repair database</term>
	<listitem><para>This tool checks the database for integrity problems, 
	fixing the problems it can. Specifically, the tool is checking for:</para>
	<itemizedlist>
		<listitem><para>Broken family links. These are the cases when 
		a person's record refers to a family while the family's record 
		does not refer to that person, and vice versa.
		</para></listitem>

		<listitem><para>Missing media objects. The missing media 
		object is the object whose file is referenced in the database 
		but does not exist. This can happen when the file is 
		accidentially deleted, renamed, or moved to another location.
		</para></listitem>

		<listitem><para>Empty families. These are the family entries 
		which have no reference to any person as their member. 
		</para></listitem>

		<listitem><para>Parent relationship. This checks all families
		to ensure that father and mother are not mixed up. The check 
		is also made that parents have different gender. If they have 
		common gender then their relationship is renamed to "Partners".
		</para></listitem>

	</itemizedlist>
	</listitem>
	</varlistentry>

 	<varlistentry><term>Extract information from names</term>
	<listitem><para>This tool searches the entire database and attempts 
	to extract titles and nicknames that may be embedded in a person's 
	<guilabel>Given name</guilabel> field. 
	</para></listitem>
	</varlistentry>

 	<varlistentry><term>Find possible duplicate people</term>
	<listitem><para>This tool searches the entire database, looking 
	for the entries that may represent the same person. 
	</para></listitem>
	</varlistentry>

 	<varlistentry><term>Rename personal event types</term>
	<listitem><para>This tool allows all the events of a certain name
	to be renamed to a new name. 
	</para></listitem>
	</varlistentry>

 	<varlistentry><term>Reorder &app; IDs</term>
	<listitem><para>This tool reorders the &app; IDs according to the
	defaults of &app;.
	</para></listitem>
	</varlistentry>

	</variablelist>

      </sect3>

      <!-- =============== Usage Sub-subsection ================ -->
      <sect3 id="tools-util"> 
	<title>Utilities</title> 
	<para> </para>

 	<para> This section contains tools allowing you to perform a simple 
	operation on a portion of data. The results can be saved in your
	database, but they will not modify your existing data. 
	The following utilities are currently available in &app;:</para>

	<variablelist>

 	<varlistentry><term>Custom Filter Editor</term>
	<listitem><para>The Custom Filter Editor builds custom filters 
	that can be used to select people included in reports, exports, 
	and other tools and utilities. This is in fact a very powerful tool 
	in genealogical analysis.</para> 
	
	<para>When you launch it, the <guilabel>User defined filters</guilabel> 
	dialog appears that lists all the filters (if any) previously defined 
	by you. Click the <guibutton>Add...</guibutton> button to define a new filter. 
	Once you have designed your filters, you can edit, test, and delete 
	selected filters using the <guibutton>Edit...</guibutton>, 
	<guibutton>Test...</guibutton>, and <guibutton>Delete...</guibutton> 
	buttons, respectively. All the filters displayed in the list will be 
	automatically saved along with your database and will be available 
	with subsequent sessions of &app;. </para>
	
	<para>Clicking the <guibutton>Add...</guibutton> button invokes the 
	following <guilabel>Define filter</guilabel> dialog: </para>
	
 	<!-- ==== Figure: Define filter dialog ==== -->
	<figure id="cfe-df-fig"> 
	<title>Define filter dialog</title> 
	<screenshot><mediaobject><imageobject><imagedata 
		fileref="figures/cfe-df.png" format="PNG"/></imageobject>
	<textobject> 
	<phrase>Shows Define filter dialog. </phrase>
	</textobject></mediaobject></screenshot></figure>
	<!-- ==== End of Figure ==== -->

	<para> Type the name for your new filter into the 
	<guilabel>Name</guilabel> field. Enter any comment that would help you
	identify this filter in the future into the <guilabel>Comment</guilabel>
	field. Add as many rules to the <guilabel>Rule list</guilabel> as you
	would like to your filter using <guibutton>Add...</guibutton> button. 
	Check <guilabel>Return values that do not match the filter rules
	(invert)</guilabel> to negate the filter rule (e.g. inverting "has a
	common ancestor with I1" rule will match everyone who does not have a
	common ancestor with that person). If the filter has more than one rule, 
	select one of the <guilabel>Rule operations</guilabel>. This allows you
	to choose whether all rules must apply, only one (either) rule must 
	apply, or exactly one (either) rule must apply, in order for the filter 
	to generate a match. If your filter has only one rule, this selection 
	has no effect. </para>
	
	<para> Note that a filter you've already designed may be used as a rule
	for another filter. This gives you nearly infinite flexibility in
	custom-tailoring your selection criteria that can be later used in 
	most of the exports, reports and some of the tools (such as comparing
	individual events). </para></listitem>
	</varlistentry>

 	<varlistentry><term>Generate SoundEx codes</term>
	<listitem><para>This utility generates SoundEx codes for the names of
	people in the database. Please visit the <ulink 
	url="http://www.archives.gov/research_room/genealogy/census/soundex.html" 
	type="http">NARA Soundex Indexing page</ulink> to learn more about 
	Soudex Indexing System.
	</para></listitem>
	</varlistentry>

 	<varlistentry><term>Relationship calculator</term>
	<listitem><para>This utility calculates the relationship between 
	two people from the database. 
	</para></listitem>
	</varlistentry>

 	<varlistentry><term>Verify the database</term>
	<listitem><para>This utility allows you to verify the database based 
	on the set of criteria specified by you. This tool is different from 
	the previously described Check tool in the following. The Check tool
	detects inconsistencies in the database structure. The Verify tool, 
	however, is detecting the records that do not satisfy your particualr 
	criteria. </para>

	<para>For example, you may want to make sure that nobody in your 
	database had children at the age of 98. Based on common sense, such 
	a record would indicate an error. However, it is not a consistency 
	error in the database. Besides, someone might have a child at the of 
	98 (albeit this rarely happens). The Verify tool will display 
	everything that violates your criteria so that you can check whether 
	the record is erroneous or not. The ultimate decision is yours.
	</para></listitem>
	</varlistentry>

	</variablelist>

     </sect3>

    </sect2>

  </sect1> <!-- ================ End Usage ============== -->

<!-- ================ Customization ================================ -->

  <sect1 id="gramps-prefs"> 
    <title>Settings</title> 
    <para>To configure &app;, choose 
      <menuchoice><guimenu>Settings</guimenu>
      <guimenuitem>Preferences...</guimenuitem></menuchoice>. 
      The <guilabel>Preferences</guilabel> dialog contains the following 
      categories: </para>
      
      <itemizedlist>
      <listitem><para><xref linkend="gramps-prefs-usage"/></para></listitem>
      <listitem><para><xref linkend="gramps-prefs-display"/></para></listitem>
      <listitem><para><xref linkend="gramps-prefs-db"/></para></listitem>
      </itemizedlist>

<!-- =============== Customization Subsection ================ -->
    <sect2 id="gramps-prefs-usage"> 
      <title>Usage</title> 
	<para> This category contains preferences relevant to the 
	general usage of &app;. It has the following subcategories:</para>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-usage-find"> 
        <title>Find</title> 

	<variablelist>

	<varlistentry><term><guilabel>Enable autocompletion</guilabel></term>
	<listitem><para>If this box is checked, &app; will attempt to complete
	the text as you type it into text entry fields such as family name,
	place of birth, etc. Completion is attempted based on the match 
	between the beginning of the text being typed and the corresponding 
	data already stored in the database. 
	</para></listitem>
	</varlistentry>

	</variablelist>

      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-usage-report"> 
        <title>Report Preferences</title> 

	<variablelist>

	<varlistentry><term><guilabel>Preferred text format</guilabel></term>
	<listitem><para> Select the preferred format for text reports 
	from the available formats listed in this menu. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Preferred graphical format</guilabel></term>
	<listitem><para> Select the preferred format for graphical reports 
	from the available formats listed in this menu.
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Preferred paper size</guilabel></term>
	<listitem><para> Select the preferred paper size used for reports 
	from the available sizes listed in this menu.
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Default report directory</guilabel></term>
	<listitem><para> Choose the default directory for the reports using the 
	<guibutton>Browse...</guibutton> button or type it in the text entry
	field. </para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Default web site directory</guilabel></term>
	<listitem><para> Choose the default directory for the web site using the 
	<guibutton>Browse...</guibutton> button or type it in the text entry
	field. </para></listitem>
	</varlistentry>

	</variablelist>

      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-usage-res"> 
        <title>Researcher Information</title> 

	<variablelist>

	<varlistentry><term><guilabel>Researcher information</guilabel></term>
	<listitem><para> Enter your personal information in the corresponding
	text entry fields. Although &app; requests information about you, 
	this information is used only so that &app; can create valid GEDCOM 
	output files. A valid GEDCOM file requires information about the file's 
	creator. If you choose, you may leave the information empty, however 
	none of your exported GEDCOM files will be valid. 
	</para></listitem>
	</varlistentry>

	</variablelist>

      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-usage-guess"> 
        <title>Data Guessing</title> 

	<variablelist>
	
	<varlistentry><term><guilabel>Surname guessing</guilabel></term>
	<listitem><para> This option is not currently implemented. 
	</para></listitem>
	</varlistentry>

	</variablelist>

      </sect3>

    </sect2>

<!-- =============== Customization Subsection ================ -->
    <sect2 id="gramps-prefs-display"> 
      <title>Display</title> 
	<para> This category contains preferences relevant to  
	displaying database records and controls in &app;. 
	It has the following subcategories:</para>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-display-gen"> 
        <title>General</title> 

	<variablelist>
	
	<varlistentry><term><guilabel>Always display the LDS ordinance tabs</guilabel></term>
	<listitem><para> Check this box to have LDS ordinance tabs displayed. 
	If you do not know what LDS is then you probably should not check it. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Show index numbers in child list</guilabel></term>
	<listitem><para> 
	This option is not currently implemented.
	</para></listitem>
	</varlistentry>

	</variablelist>
      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-display-date"> 
        <title>Dates and Calendar</title> 

	<variablelist>
	
	<varlistentry><term><guilabel>Display: Date format</guilabel></term>
	<listitem><para> Select the display format for the dates
	from the available formats listed in this menu. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Name format</guilabel></term>
	<listitem><para> Select the display format for the names  
	from the available formats listed in this menu. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Entry: Date format</guilabel></term>
	<listitem><para> Select the entry format for the dates
	from the available formats listed in this menu. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Show calendar format selection menu</guilabel></term>
	<listitem><para> Check this box to enable the calendar format selection 
	menu when you are entering dates in the <guilabel>Event 
	Editor</guilabel> dialog. 
	</para></listitem>
	</varlistentry>

	</variablelist>
      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-display-bars"> 
        <title>Toolbar and Statusbar</title> 
	<variablelist>
	
	<varlistentry><term><guilabel>Toolbar</guilabel></term>
	<listitem><para> Select the desired appearance of the toolbar icons
	using the radio buttons. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Statusbar</guilabel></term>
	<listitem><para> Select the desired contents displayed in the 
	statusbar using the radio buttons. 
	</para></listitem>
	</varlistentry>

	</variablelist>
      </sect3>

    </sect2>

<!-- =============== Customization Subsection ================ -->
    <sect2 id="gramps-prefs-db"> 
      <title>Database</title> 
	<para> This category contains preferences relevant to the 
	database itself. It has the following subcategories: </para>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-db-gen"> 
        <title>General</title> 

	<variablelist>
	
	<varlistentry><term><guilabel>Automatically load last database</guilabel></term>
	<listitem><para> Check this box to automatically load the last open
	database on startup. </para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Do not compress XML data file</guilabel></term>
	<listitem><para> Check this box to disable compression of the XML
	data file. Compression significantly reduces the file size. While it 
	creates an overhead in performance (some processor cycles must be spent
	to decompress the file before use), this overhead is extremely small. 
	Now that the compression-related bugs have long been fixed, there is 
	virtually no reason to disable data file compression. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Capitalize surnames</guilabel></term>
	<listitem><para> Check this box to capitalize surnames entered into the
	database. </para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Autosave interval</guilabel></term>
	<listitem><para> Set the interval (in minutes) after which &app; will
	automatically save your database. Setting the interval to zero (0) 
	disables autosaving. </para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Default database directory</guilabel></term>
	<listitem><para> Choose the default directory in which &app; starts
	looking when saving the database using the <guibutton>Browse...</guibutton> 
	or type its path into the text entry field. </para></listitem>
	</varlistentry>

	</variablelist>
      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-db-media"> 
        <title>Media Objects</title> 

	<para>Before describing preferences for media objects, let us
	review the background on local and non-local objects. A local object 
	is the object whose file is stored inside the same directory in which 
	the &app; database file resides. A non-local object is stored 
	elsewhere, so that the database has only the reference to the file's 
	location and some records of the object's properties. </para>
	
	<para>You may choose to store your media objects either locally 
	or externally. Making your objects local will increase the amount 
	of disk space consumed by the &app; database directory. However, 
	if the external file is deleted or removed, &app; will still be able 
	to use the local copy. In contrast, leaving your objects non-local 
	will decrease the disk space requirements. However, losing the 
	original file will render your media object unusable.
	</para>
	
	<para>Note that exporting your database to any format will complie
	all medial objects, no matter whether they are local or not. 
	Specifially, export to gramps package will include all the media 
	object files in the package and change the references accordingly. 
	Export to CD will copy all media object files to the directory under 
	the <guilabel>burn:///</guilabel> location in Nautilus and change the 
	references accordingly. Finally, export to GEDCOM will place all 
	media object files next to the GEDCOM file with the approrpiate 
	changes in the path names. 
	</para>
	
	<variablelist>

	<varlistentry><term><guilabel>Drag and drop from an external 
	source</guilabel></term>
	<listitem><para> Choose between a reference and a local copy made when
	the object is dropped into the gallery. The reference saves disk 
	space as it does not copy the object. The local copy makes your 
	database portable as it does not depend on an external file. Consult
	your needs to make best choice.</para> 
	
	<para>Check the <guilabel>Display global properties editor when 
	object is dropped</guilabel> box to invoke the global properties 
	editor after you drop an external object into the gallery. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Drag and drop from an internal 
	source</guilabel></term>
	<listitem><para> Check the <guilabel>Display local properties editor 
	when object is dropped</guilabel> box to invoke the local properties 
	editor after you drop an internal object into the gallery. 
	</para></listitem>
	</varlistentry>

	</variablelist>
      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-db-id"> 
        <title>&app; internal IDs</title> 

	<variablelist>

	<varlistentry><term><guilabel> GRAMPS ID prefixes</guilabel></term>
	<listitem><para> Enter ID prefixes for various kinds of database 
	entries into the corresponding text entry fields. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Allow internal GRAMPS ID numbers to be
	edited</guilabel></term>
	<listitem><para> Check this box to enable editing of the internal &app;
	ID numbers. Unless you know what you are doing, leave it unchecked.
	</para></listitem>
	</varlistentry>

	</variablelist>
      </sect3>

  <!-- =============== Customization Sub-subsection ================ -->
      <sect3 id="prefs-db-rcs"> 
        <title>Revision Control</title> 

	<variablelist>

	<varlistentry><term><guilabel>Use revision control</guilabel></term>
	<listitem><para> Check this box to enable &app; to use the revision control
	system for your database. If you choose this option, select the
	particular revision control system from the menu. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Prompt for comment on save</guilabel></term>
	<listitem><para> Check this box to instruct &app; to prompt you to enter
	the comment when you save the database. 
	</para></listitem>
	</varlistentry>

	</variablelist>

      </sect3>

    </sect2>

  </sect1> <!-- ================ End Customization ================== -->

<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default. 
     You can use it to describe known bugs and limitations of the 
	  program if there are any - please be frank and list all
     problems you know of. 
  
  <sect1 id="mayapp-bugs">
  <title>Known Bugs and Limitations</title>
  <para> </para>
 </sect1>
-->
<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. 
      Alternatively, you can put this information in the title page.-->
  <sect1 id="gramps-about"> 
    <title>About &app;</title> 
    <para> &app; was written by Donald N. Allingham
      (<email>dallingham@users.sourceforge.net</email>). 
      To find more information about &app;, please visit the 
      <ulink url="http://gramps.sourceforge.net" type="http">GRAMPS Project 
      Web page</ulink>. </para>
    <para>
      To report a bug or make a suggestion regarding this application or
      this manual, follow the directions in this 
      <ulink url="ghelp:gnome-feedback"  type="help">document</ulink>.
    </para>

    <para> This program is distributed under the terms of the GNU
      General Public license as published by the Free Software
      Foundation; either version 2 of the License, or (at your option)
      any later version. A copy of this license can be found at this
      <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
      COPYING included with the source code of this program. </para>

  </sect1> 
</article>