gramps/doc/gramps-manual/C/gramps-manual.sgml

<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
<!ENTITY version "0.6.0"> <!-- replace with application version -->
]>

<!-- =============Document Header ============================= -->

<article id="index"> <!-- please do not change the id -->

  <artheader>
    <title>GRAMPS User Manual</title>
    <copyright>
      <year>2001</year>
      <holder>Donald N. Allingham</holder>
    </copyright>

  <!-- translators: uncomment this:

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

   -->

  <!-- do not put authorname in the header except in copyright - use
  section "authors" below -->

  <!-- Use this legal notice for online documents which depend on -->
  <!-- core GNOME packages.                                       -->
  <legalnotice id="legalnotice">
    <para>
    Permission is granted to copy, distribute and/or modify this document
    under the terms of the <ulink type="help" 
    url="gnome-help:fdl"><citetitle>GNU Free Documentation
    License</citetitle></ulink>, Version 1.1 or any later version 
    published by the Free Software Foundation with no Invariant Sections, 
    no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
    can be found <ulink type="help" url="gnome-help:fdl">here</ulink>.
    </para>
    <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
    </para>
  </legalnotice>

  <!-- Use this legal notice for documents which are placed on  -->
  <!-- the web, shipped in any way other than online documents  -->
  <!-- (eg. PS, PDF, or RTF), or which do not depend on the     -->
  <!-- core GNOME distribution.                                 -->
  <!--                                                          -->
  <!-- If you use this version, you must place the following    -->
  <!-- line in the document declaration at the top of your      -->
  <!-- document:                                                -->
  <!--   <!ENTITY FDL SYSTEM "fdl.sgml">                        -->
  <!-- and the following line at the bottom of your document    -->
  <!-- after the last </sect1>.                                 -->
  <!--   &FDL;                                                  -->
  <!--
  <legalnotice id="legalnotice">
    <para>
    Permission is granted to copy, distribute and/or modify this document
    under the terms of the <link linkend="fdl"><citetitle>GNU
    Free Documentation License</citetitle></link>, Version 1.1 or any later
    version published by the Free Software Foundation with no Invariant
    Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the
    license can be found in <xref linkend="fdl">.
    </para>
    <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
    </para>
  </legalnotice>
 -->

  <!-- This is the manual version, not application version. --> 
    <releaseinfo>
       This is version 1.1 of the GRAMPS manual.
    </releaseinfo>

  </artheader>

 <!-- ============= Document Body ============================= -->

 <!-- ============= Introduction ============================== -->
  <sect1 id="intro">
    <title>Introduction</title>
    <para>
    <application>GRAMPS</application> is an acronym for the
    Genealogical Research and Analysis Management Programming System.
    It 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 a
    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 of
    the data contained in the various reports.  GRAMPS, on the other
    hand, attempts to provide all of the common capabilities of these
    programs, but, more importantly, to provide a capability not
    common to these programs.  This is the ability to input any bits
    and pieces of information directly into GRAMPS 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, 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>
    <para>
    To run <application>GRAMPS</application>, select
      <menuchoice>
	<guisubmenu>Programs</guisubmenu>
	<guisubmenu>Applications</guisubmenu>
	<guimenuitem>gramps</guimenuitem>
      </menuchoice>
    from the <guimenu>Main Menu</guimenu>, or type
    <command>gramps</command> on the command line.
    </para>
    <para>
    This document describes version &version; of
    <application>GRAMPS</application>.
    </para>
  </sect1>

 <!-- ================ Usage ================================ -->
 <!-- This section should describe basic usage of the application. -->

  <sect1 id="firsttime">
    <title>Running GRAMPS for the first time.</title>
    <para>
    The first time you run the program,
    <application>GRAMPS</application> will display its Getting Started
    screens.
    </para>
    <figure id="druidpg1">
      <title>Getting Started screen, page 1</title>
      <screenshot>
	<screeninfo>Getting Started screen, page 1</screeninfo>
	<graphic fileref="druidpg1" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <para>
    The second page of the start-up screens will prompt you for
    some personal information. This information is optional, and
    can be changed at any time. The information will be used to
    establish your copyright on the information, and to provide
    information needed for valid GEDCOM exporting.
    </para>
    <figure id="druidpg2">
      <title>Getting Started screen, page 2</title>
      <screenshot>
	<screeninfo>Getting Started screen, page 2</screeninfo>
	<graphic fileref="druidpg2" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
  </sect1>

  <sect1 id="gettingstarted">
    <title>Getting Started</title>
    <para>
    Starting <application>GRAMPS</application> opens the
    <interface>Main window</interface>, shown in <xref
    linkend="mainwindow-fig">. The window is at first empty.
    </para>
    <figure id="mainwindow-fig">
      <title>GRAMPS Main Window</title>
      <screenshot>
	<screeninfo>GRAMPS Main Window</screeninfo>
	<graphic fileref="mainwin" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <sect2 id="startimport">
      <title>Importing data</title>
      <para>
      If you already have a family file created using another
      genealogy program you can import your GEDCOM file into GRAMPS.
      To do this you select <menuchoice> <guimenu>File</guimenu>
      <guisubmenu>Import</guisubmenu> <guimenuitem>Import from
      GEDCOM</guimenuitem> </menuchoice>.  The <interface>GEDCOM
      Import</interface> box will open. Select <guibutton>New
      Database</guibutton> and click the
      <guibutton>Browse...</guibutton> button to select your saved
      GEDCOM file (<replaceable>filename.ged</replaceable>). Click
      <guibutton>OK</guibutton> to select the file and then click
      <guibutton>OK</guibutton> to import the file. The
      <interface>GEDCOM Import Status</interface> will tell you what
      the importer is doing and a little bit about your file (file
      location, which program created it, the version, Encoding,
      Number of Families, Number of People, and the Number of Errors).
      Once the Importer is done, you can click
      <guibutton>Close</guibutton> and start editing/adding to your
      file.
      </para>
    </sect2>
    <sect2 id="noimport">
      <title>Entering Data</title>
      <para>
      If you have never used a genealogy program or you do not have a
      GEDCOM file to import, you can start creating your database
      right away. From the main window click the <guibutton>Add
      Person</guibutton> button and the <interface>Edit
      Person</interface> dialog will open.  Enter in the information
      you have on the first person.  Start with their general
      information (Name, Birth and Death Date/Place) and then move on
      to the <interface>Names</interface>,
      <interface>Events</interface>,
      <interface>Attributes</interface>,
      <interface>Addresses</interface>, <interface>Notes</interface>,
      <interface>Gallery</interface>, and
      <interface>Internet</interface> tabs and fill in the known
      information you have.  Some of the information you enter has a
      <guibutton>Source</guibutton> button and/or a
      <guibutton>Note</guibutton> button.  These buttons are there to
      add more information (<guibutton>Source</guibutton> button to
      add the source of where you acquired the information and the
      <guibutton>Note</guibutton> button to add more detail to the
      information)
      </para>
    </sect2> 
  </sect1>

 <!-- ========= Basic Usage =========================== -->

  <sect1 id="personlist">
    <title>People View</title>
    <para>
    The People View window is the initial view seen on the main
    window.  It displays the name, gender, birth date, and death
    date of all individuals in the database.  At any time, you can
    return to this view either by pressing the
    <guibutton>People</guibutton> button at the top of the screen, or
    by choosing the
      <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>People</guimenuitem> 
      </menuchoice>
    entry from the menus.
    </para> 
    <figure id="peopleview-fig">
      <title>People View</title>
      <screenshot>
	<screeninfo>People View</screeninfo>
	<graphic fileref="peoplelist" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <sect2 id="seleditindv">
      <title>Selecting and Editing Individuals</title>
      <para>
      The People View lists the individuals in the database. An
      individual can be selected as the active person by clicking on
      an entry in the list. Once a person has been selected as the
      active person, the person's name appears in the status bar in
      the lower left hand corner of the window.
      </para>
      <para>
      Once the active person has been selected, pressing the
      <guibutton>Edit Person</guibutton> button will display the
      <interface>Edit Person</interface> dialog allowing you to edit
      the individual's personal information.  If the <guibutton>Edit
      Person</guibutton> button is pressed without an active person
      being set, a blank <interface>Edit Person</interface> dialog is
      presented, allowing you to enter a new person.
      </para>
      <para>
      Double-clicking on a entry in the list will set the active
      person and bring up the individual in the <interface>Edit
      Person</interface> dialog.
      </para>
      <para>
      Pressing the <guibutton>Add Person</guibutton> button will
      display a blank <interface>Edit Person</interface> dialog,
      allowing you to add a new person to the database.
      </para>
      <para>
      If the <guibutton>Delete Person</guibutton> button is pressed,
      the active person and all of the personal information related to
      the active person are removed from the database.
      </para>
    </sect2>
    <sect2>
      <title>Applying Filters</title>
      <para>
      <application>GRAMPS</application> allows you to apply filters to
      the People View. When a filter is applied, the People View will
      only display the entries matching the filter. All of the entries
      remain in the database, but are temporarily hidden.
      </para>
      <para>
      There are three parts to a filter. The first part is the
      selection of the filter to be applied. A filter is selected from
      the option menu directly above the People View.  The second part
      is an option qualifier. This qualifier provides more specific
      information for the filter. Many filters do not require the
      qualifier, and it will be grayed out if not needed.  The third
      part of the filter is the invert selection.  When this option is
      selected, <application>GRAMPS</application> will display the
      entries that do not match the filter.
      </para>
      <para>
      A filter is not applied until the <guibutton>Apply</guibutton>
      button is pressed.  The filter will remain in effect until the
      next time the <guibutton>Apply</guibutton> button is pressed.
      </para>
    </sect2>
    <sect2>
     <title>Sorting</title>
      <para>
      Four columns are shown in the People View display. The entries
      in the list can be sorted by three of the fields: Name, Birth
      Date, or Death Date.  Clicking on the column label will cause
      the list to be re-sorted by that column.  Arrows on the label
      indicate whether the list is sorted by ascending or descending
      order.
      </para>
      <para>
      If the list is already sorted by a particular column, clicking
      on the same column label will switch the sorting order.  For
      example, if the list is currently sorted in ascending order by
      Name, clicking on the Name column header will re-sort the list
      in descending order.
      </para>
    </sect2>
  </sect1>
  <sect1 id="editpersondata">
    <title>Editing a person's data</title>
    <para>
    A person's personal information can be edited in the
    <interface>Edit Person</interface> dialog.
    </para>
    <sect2>
      <title>General Information Tab</title>
      <figure id="ep_general-fig">
        <title>General Information Tab</title>
        <screenshot>
	  <screeninfo>General Information Tab</screeninfo>
	  <graphic fileref="ep_general" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The General Information tab contains the basic information about
      the person. This includes the person's name, gender, birth
      information, and death information.
      </para>
      <para>
      If images have been associated with the person, the primary
      image is displayed on the right side of the window.
      </para>
    </sect2>
    <sect2>
      <title>Alternate Names Tab</title>
      <figure id="ep_names-fig">
        <title>Alternate Names Tab</title>
        <screenshot>
	  <screeninfo>Alternate Names Tab</screeninfo>
	  <graphic fileref="ep_altname" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      It is possible for people to use more than one name during their
      lifetime. These may be legal name changes, or just informal
      names. An example would be a person changing his or her name due
      to marriage or adoption. <application>GRAMPS</application>
      allows multiple alternate names to be specified for each person.
      </para>
      <para>
      The <interface>Alternate Names</interface> tab allows additional
      names to be added or removed from list. Clicking the
      <guibutton>Add</guibutton> button allows a new name to be added
      to the list. The <guibutton>Edit/View</guibutton> allows the
      selected alternate name to be edited. The
      <guibutton>Delete</guibutton> button removes the selected name.
      </para>
    </sect2>
    <sect2 id="eventtab">
      <title>Events Tab</title>
      <para>
      The <interface>Events</interface> tab allows information about
      various events in a person's life to be
      recorded. <application>GRAMPS</application> provides a list of
      common events, but allows you to name an event anything that you
      choose.
      </para>
      <para>
      An event consists of the name of an event (such as "Baptism" or
      "Education"), a date or date range on which the event occurred,
      the place where the event occurred, and a description of the
      event. A note or a source may also be attached to the event.
      </para>
      <para>
      Events have the concept of privacy and confidence associated
      with them. An event may be marked as "Private". When generating
      reports or exporting to other formats, you will be allowed to
      either include or exclude private records. This will allow you
      to limit information provided to others.
      </para>
      <para>
      <application>GRAMPS</application> allows you to specify your
      confidence in the information you have. By default, a confidence
      level of "Normal" is associated with each event. This can be
      increased ("High" or "Very High") or decreased ("Low" or
      "Very Low") to indicate the confidence you have in the
      information. For example, if Aunt Martha thinks that her
      grandmother was born in a particular year, you may wish to mark
      this with a lower level of confidence than if you had a copy of
      her grandmother's birth certificate.
      </para>
      <figure id="ep_event-fig">
        <title>Events Tab</title>
        <screenshot>
	  <screeninfo>Events Tab</screeninfo>
	  <graphic fileref="ep_event" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The <interface>Event</interface> tab displays information about
      the currently selected event at the top of the window. Below
      this information is a list of the events that have been
      previously entered. Clicking on one of the events in the list
      selects the event, and displays its information at the top of
      the window.
      </para>
      <para>
      An event may be added by clicking the <guibutton>Add</guibutton>
      button. This displays a form that allows you to enter the
      information about the particular event. The
      <guibutton>Edit/View</guibutton> button allows to view or to
      alter the information of the currently displayed event. The
      <guibutton>Delete</guibutton> button allows you to delete the
      currently displayed event.
      </para>
    </sect2>
    <sect2 id="attrtab">
      <title>Attributes Tab</title>
      <para>
      Attributes are similar to events, but are for information items
      that do not necessarily have the concept of a place or a
      date. An example would be a person's Social Security Number or
      national origin. Attributes consist of an attribute name and its
      value.
      </para>
      <para>
      Like events, attributes may also have a note, source, privacy
      marker, and confidence level associated with them.
      </para>
      <figure id="ep_attributes-fig">
        <title>Attributes Tab</title>
        <screenshot>
	  <screeninfo>Attributes Tab</screeninfo>
	  <graphic fileref="ep_attributes" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The <interface>Attribute</interface> tab displays information
      about the currently selected attribute at the top of the
      window. Below this information is a list of the attributes that
      have been previously entered. Clicking on one of the attributes
      in the list selects the attribute, and displays its information at
      the top of the window.
      </para>
      <para>
      An attribute may be added by clicking the
      <guibutton>Add</guibutton> button. This displays a form that
      allows you to enter the information about the particular
      attribute. The <guibutton>Edit/View</guibutton> button allows to
      view or to alter the information of the currently displayed
      attribute. The <guibutton>Delete</guibutton> button allows you to
      delete the currently displayed attribute.
      </para>
    </sect2>
    <sect2 id="addrtab">
      <title>Addresses Tab</title>
      <para>
      Addresses are used to record information about where a person
      has lived. Addresses are different from
      <application>GRAMPS'</application> concept of a place. An
      address, as <application>GRAMPS</application> sees, it consists
      of an equivalent of a mailing address and the date or date range
      when the person lived at the address.
      </para>
      <para>
      Like events and attributes, addresses may also have a note,
      source, privacy marker, and confidence level associated with
      them.
      </para>
      <figure id="ep_address-fig">
        <title>Addresses Tab</title>
        <screenshot>
	  <screeninfo>Addresses Tab</screeninfo>
	  <graphic fileref="ep_address" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The <interface>Address</interface> tab displays information
      about the currently selected address at the top of the
      window. Below this information is a list of the addresses that
      have been previously entered. Clicking on one of the addresses
      in the list selects the address, and displays its information at
      the top of the window.
      </para>
      <para>
      An address may be added by clicking the
      <guibutton>Add</guibutton> button. This displays a form that
      allows you to enter the information about the particular
      address. The <guibutton>Edit/View</guibutton> button allows to
      view or to alter the information of the currently displayed
      address. The <guibutton>Delete</guibutton> button allows you to
      delete the currently displayed address.
      </para>
    </sect2>
    <sect2 id="notestab">
      <title>Notes Tab</title>
      <para>
      In addition to the notes that may be attached to any particular
      event, attribute, or address, <application>GRAMPS</application>
      has a generic note attached to the person.
      </para>
      <figure id="ep_notes-fig">
        <title>Notes Tab</title>
        <screenshot>
	  <screeninfo>Notes Tab</screeninfo>
	  <graphic fileref="ep_notes" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The note window is a free-form edit window, allowing you to
      enter any information that you want.
      </para>
    </sect2>
    <sect2 id="gallerytab">
      <title>Gallery Tab</title>
      <para>
      The <interface>Gallery</interface> tab allows you to associate
      files (known in <application>GRAMPS</application> as media
      objects) with a particular person. These files are typically
      images or photographs, but may be of any filetype, such as (but
      not limited to) sound files and word processing documents.
      </para>
      <figure id="ep_gallery-fig">
        <title>Gallery Tab</title>
        <screenshot>
	  <screeninfo>Gallery Tab</screeninfo>
	  <graphic fileref="ep_gallery" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      <application>GRAMPS</application> provides a central repository
      for all media objects in the Media View. This allows the same
      media object to appear in multiple galleries.  Adding a media
      object to a gallery actually adds the object to the Media View,
      and makes a local reference in the gallery. 
      </para>
      <para>
      While each media object can have a note and attributes attached
      to it, each gallery can add its own notes and attributes to the
      reference in its gallery. This allows media objects to have
      global and local properties. For example, a photo of a family
      reunion may have many people in it. A global note may describe
      the picture in general, identifying the place and date.  When
      this object is added to a gallery, you can attach a note to the
      reference in the gallery adding some specific information, such
      as &quot;Aunt Martha is the third person from the right in the
      second row&quot;. Clicking the <guibutton>Edit
      Properites</guibutton> allows you to edit the local properties.
      </para>
      <figure id="localmedia">
        <title>Local Media Properties</title>
        <screenshot>
	  <screeninfo>Local Media Properties</screeninfo>
	  <graphic fileref="localmedia" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The first object in the gallery is considered to be the primary
      image. If this object is an image, it will appear on the
      <interface>General Information</interface> tab, and will be the
      primary image used by report generators. An image can be made
      the default at any time by selecting the thumbnail image and
      dragging it to the first position in the gallery. In this same
      manner, the order of the images can be changed using the same
      drag and drop technique.
      </para>
      <para>
      Objects may be added to the gallery in several ways. By clicking
      the <guibutton>Add Media Object</guibutton> button, a dialog box
      is presented which allows you to choose an object from the file
      system.  This method adds a new object to the Media View and
      creates a reference in the gallery.  Objects may also be added
      by either dragging and dropping from one gallery to another, or
      by dragging from the Media View to a gallery. In this case, a
      new media object is not created, but a reference to an existing
      media object is made in the gallery, sharing the same media
      object between galleries. Finally, new objects may be added to a
      gallery and the Media View by dragging and dropping from a file
      manager (such as <application>Nautilus</application> or
      <application>Konqueror</application>) or a web browser (such as
      <application>Galeon</application>,
      <application>Mozilla</application>, or
      <application>Konqueror</application>) into a gallery.
      </para>
      <para>
      Media objects can be removed from a gallery by clicking the
      <guibutton>Delete Media Object</guibutton> button. This action
      only removes the reference to the current gallery. It does not
      remove the media object from the Media View or from any other
      galleries that are referencing it.
      </para>
      <para>
      Right clicking on a selected object brings up a menu.
      </para>
      <variablelist><title>Menu options</title>
        <varlistentry>
	  <term>View in default viewer</term>
	  <listitem>
	    <para>
	    Allows you to view an object image using GNOME's default
	    viewer for the file type.
	    </para>
	  </listitem>
	</varlistentry>
        <varlistentry>
	  <term>Edit with the GIMP</term>
          <listitem>
	    <para>
	    Launches the <application>gimp</application> program,
	    allowing you to edit the image. This option only shows up
	    if the media object is an image.
	    </para>
	  </listitem>
	</varlistentry>
        <varlistentry>
	  <term>Edit Object Properties</term>
          <listitem>
	    <para>
	    Allows you to change the attributes and note attached to the
	    media object.
	    </para>
	  </listitem>
        </varlistentry>
        <varlistentry>
	  <term>Convert to local copy</term>
	  <listitem>
	    <para>
	    This option is only displayed if the media is a reference
	    to a file that is not controlled by
	    <application>GRAMPS</application>. Selecting the option
	    causes <application>GRAMPS</application> to make its own
	    copy of the media object.
	    </para>
	  </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
    <sect2 id="internettab">
      <title>Internet Tab</title>
      <para>
      Frequently, information about a person is available on the
      internet, frequently on someone else's web site. With multiple
      people researching the same family, it is desirable to keep track
      of internet sites that contain information about someone in your
      database. This allows you to keep track of the web sites you 
      can periodically check them for any addition information.
      </para>
      <figure id="ep_internet-fig">
        <title>Internet Tab</title>
        <screenshot>
	  <screeninfo>Internet Tab</screeninfo>
	  <graphic fileref="ep_internet" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The <interface>Internet</interface> tab displays information about
      the currently selected internet address at the top of the window. Below
      this information is a list of the internet address that have been
      previously entered. Clicking on one of the events in the list
      selects the event, and displays its information at the top of
      the window.
      </para>
      <para>
      Clicking on the internet address displayed at the top part of
      the window will cause <application>GRAMPS</application> to attempt
      to display the site using the GNOME default browser.
      </para>
      <para>
      An internet address may be added by clicking on the
      <guibutton>Add</guibutton> button. This displays a form that
      allows you to enter the information about the internet
      address. This information consists of the web address (URL) and
      a description of the location.  The
      <guibutton>Edit/View</guibutton> button allows to view or alter
      the information of the currently displayed internet address. The
      <guibutton>Delete</guibutton> button allows you to delete the
      currently displayed internet address.
      </para>
    </sect2>
  </sect1>
  <sect1 id="familyview">
    <title>Family View</title>
    <para>
    The Family View window displays the spouses, parents, and children
    of the active person. At any time, you can return to this view
    either by pressing the <guibutton>Family</guibutton> button at the
    top of the screen, or by choosing the
      <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Family View</guimenuitem> 
       </menuchoice>
    entry from the menus. 
    </para>
    <figure id="familyview-fig">
      <title>Family View</title>
      <screenshot>
	<screeninfo>Family View</screeninfo>
	<graphic fileref="familyview" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <para>
    In the Family View, the family information related to the active
    person is displayed. This information falls into two categories:
    families in which the person is a child, and families in which the
    person is a spouse or parent.
    </para>
    <sect2 id="ap_parents">
      <title>Relationships to Parents</title>
      <para>
      On the right hand side of the window displays the parents of the
      active person. By default, a birth relationship is
      assumed. <application>GRAMPS</application> supports multiple
      family relationships for each person. For example, a person may
      have natural birth parents and adopted parents. In this case, an
      option menu will appear below the parents names, allowing you to
      choose which set of parents you wish to view.
      </para>
      <para> 
      Pressing the <guibutton>Add/Edit Parents</guibutton>
      allows you to choose the active person's parents and specify the
      person's relationship to the parents.
      </para>
      <para>
      Pressing the <guibutton>Delete Parents</guibutton> does not
      remove the parents from the database, but instead deletes the
      relationship between the active person and the currently displayed
      parents.
      </para>
      <para>
      To right of the names of the parents are two "arrow"
      buttons. Selecting the button next to the father changes the
      father to the active person, and displays the fathers
      information in the Family View window. Similarly, selecting the
      button next to the mother changes the mother to the active
      person.
      </para>
      <para>
      To the left of the parents' names are buttons indicating the
      relationship to the active person. These are typically labeled
      "Father" and "Mother", but in some cases may simply be labeled
      "Parent". Pressing one of these buttons will display the
      <interface>Edit Person</interface> for the corresponding person.
      </para>
    </sect2>
    <sect2 id="sp_relationships">
      <title>Marriage/Relationship Information</title>
      <para>
      On the left side of the window, below the active person's name,
      is the information related to the person's marriages and
      relationships.  If the person has one or no relationships, the
      spouse will appear within a non-editable text box. If more than
      one relationship exists, the text box will be replaced with an
      option menu that allows you to select the relationship to view.
      </para>
      <para>
      Between the active person and the relationship information is a
      button with two arrows. Pressing this button will exchange the
      active person and spouse on the display. The currently displayed
      spouse will become the active person, and the family information
      on the right hand side of the screen will change to reflect
      this.
      </para>
      <para>
      Pressing the <guibutton>Spouse</guibutton> next to the spouse's
      name will display the currently displayed spouse's information
      in an <interface>Edit Person</interface> dialog, allowing you
      change the information
      </para>
      <para>
      Pressing the <guibutton>Add</guibutton> located below the entry
      for the spouse's name allows a new relationship to be
      added. This gives you the opportunity to select and existing
      person or to add a new person as the new spouse. The type of
      relationship can also be specified. All relationship types,
      except "Partners" require that the spouses be of opposite
      sex. The "Partners" relationship type requires that the spouses
      be of the same sex.
      </para>
      <para>
      Pressing the <guibutton>Edit</guibutton> button allows you to
      edit the information related to the marriage. The information
      includes events, attributes, and images.
      </para>
      <para>
      The <guibutton>Remove</guibutton> button removes the current
      spouse from the relationship. If no children exist in the
      relationship, the entire relationship is removed. If children
      exist in the relationship, the current spouse is removed,
      and the children remain in a family with the active person as the
      only parent.
      </para>
    </sect2>
    <sect2 id="sp_children">
      <title>Children of a Relationship</title>
      <para>
      The bottom of the window contains the list of children related
      to the active person and the currently selected spouse. Clicking
      on an entry in the list makes that child the active child.
      </para>
      <para>
      Clicking the <guibutton>Add New Child</guibutton> creates a new
      child and adds him or her as a child of the current
      relationship. Clicking the <guibutton>Add Existing
      Child</guibutton> allows you to select an existing person and
      assign the person as a child of the current
      relationship. Clicking the <guibutton>Remove Child</guibutton>
      removes the active child from the current relationship, but does
      not delete the person from the database.
      </para>
      <para>
      Double clicking on an entry in the list brings up the
      <interface>Edit Person</interface> dialog for the child.
      </para>
      <para>
      You are able to make the selected child the active person by
      clicking the arrow button next to the child list. The
      highlighted child in the child list becomes the active person.
      </para>
    </sect2>
  </sect1>
  <sect1 id="pedigreeview">
    <title>Pedigree View</title>
    <para>
    The Pedigree View window displays the active person, the active
    person's parents, and the active parent's grandparents in a
    somewhat graphical manner. At any time, you can return to this
    view either by pressing the Pedigree button at the top of the
    screen, or by choosing the
      <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Pedgree</guimenuitem> 
      </menuchoice>
    entry from the menus.
    </para>
    <figure id="pedigreeview-fig">
      <title>Pedigree View</title>
      <screenshot>
	<screeninfo>Pedigree View</screeninfo>
	<graphic fileref="pedegreeview" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <para>
    Moving the mouse over a displayed name will display additional
    information about a person, including their date of birth and date
    of death. Double-clicking the box will display the <interface>Edit
    Person</interface> dialog box for the person. Holding down the
    Shift key while double clicking will will make that person the
    active person.
    </para>
    <para>
    Navigation around the tree can be accomplished several
    ways. Clicking on the arrow next to the active person will display
    a menu listing the children of the active person. Selecting a
    person from this list will change the active person to the
    selected child, effectively shifting the pedigree view to the
    left, or down one generation. Clicking one of the arrow buttons on
    the left side of the screen will make the select either the active
    person's father (top button) or mother (bottom button),
    effectively shifting the pedigree view to the right, or up one
    generation. If the active person does not have any children, then
    the button on the left-hand side of the screen will not
    appear. Similarly, if the active person does have a father or
    mother, the corresponding button on the right-hand side of the
    screen will not appear.
    </para>
    <figure id="navfigure-fig">
      <title>Navigation</title>
      <screenshot>
	<screeninfo>Navigation</screeninfo>
	<graphic fileref="pedegreesel" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <para>
    As a quick short cut, double clicking on a line between two people
    will make the person on the right-hand side of the line the active
    person. <xref linkend="navfigure-fig"> shows navigation using this
    method. When the mouse is over one of the lines connecting
    individuals, the line widens and becomes highlighted. In this
    case, double clcking on the line would make Hjalmar Smith the
    active person.
    </para>
  </sect1>

  <sect1 id="sourcelist">
    <title>Source View</title>
    <para>
    The Source View window displays the different sources that have
    been entered into the database. At any time, you can return to
    this view either by pressing the <guibutton>Sources</guibutton>
    button at the top of the screen, or by choosing the
      <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Sources</guimenuitem> 
      </menuchoice>
    entry from the menus.
    </para>
    <figure id="sourceview-fig">
      <title>Source list</title>
      <screenshot>
	<screeninfo>Source View</screeninfo>
	<graphic fileref="sourcelist" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <para>
    From this screen you are able to Add and Edit sources. Currently,
    deleting of sources is not available. This will be implemented in
    a future version.
    </para>
  </sect1>

  <sect1 id="placelist">
    <title>Place View</title>
    <para>
    The Place View window displays the different sources that have
    been entered into the database. At any time, you can return to
    this view either by pressing the <guibutton>Places</guibutton>
    button at the top of the screen, or by choosing the
      <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Places</guimenuitem> 
      </menuchoice>
    entry from the menus.
    </para>
    <figure id="placeview-fig">
      <title>Place View</title>
      <screenshot>
	<screeninfo>Place View</screeninfo>
	<graphic fileref="placelist" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <para>
    From this screen you are able to Add, Edit, and Delete places.
    </para>
  </sect1>

  <sect1 id="mediaview">
    <title>Media View</title>
    <para>
    The Media View window displays the files associated with the
    database.  Typically, these files are images, but
    <application>GRAMPS</application> allows you to attach any type of
    file to the database. <application>GRAMPS</application> refers to
    attached files as media objects.  You can access the Media View at
    any time by either pressing the <guibutton>Media</guibutton>
    button at the top of the screen, or by choosing the
      <menuchoice>
        <guimenu>View</guimenu>
        <guimenuitem>Media</guimenuitem> 
      </menuchoice>
    entry from the menus.
    </para>
    <figure id="mediaview-fig">
      <title>Media View</title>
      <screenshot>
	<screeninfo>Media View</screeninfo>
	<graphic fileref="mediaview" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <sect2>
      <title>Media Objects</title>
      <para>
      Media objects can be either local or external to a
      <application>GRAMPS</application> database. If
      <application>GRAMPS</application> is told to import an object as
      alocal object, it will make its own copy of the file in the
      database directory. If the object is not imported as a local
      object, the original file is used.
      </para>
      <para>
      There are advantages and disadvantages to both methods. If the
      object is local, then if the original file is moved or deleted,
      then <application>GRAMPS</application> will still have its own
      copy. However, this is at the price of having two copies of the
      file. If the file is not imported as a local object, then a copy
      is not made, saving disk space. However, altering or deleting
      the original copy will affect the
      <application>GRAMPS</application> database.
      </para>
    </sect2>
    <sect2>
      <title>Adding a Media Object</title>
      <para>
      Media objects can be imported in several ways. Adding an object
      to any gallery adds the object to the Media View. The gallery is
      will actually contain a reference to the object in the Media
      View. 
      </para>
      <para>
      Objects may also be added using the <guibutton>Add Media
      Object</guibutton> button. This will add the object to the Media
      View, but not to any gallery. When you select the file to be
      added, a preview will be displayed in the preview window. The
      the file is an image, the image will be displayed. Otherwise, an
      icon representing the file type will be displayed. In the dialog
      box, you may choose to either import the object as a local
      object, or leave it as an external object.
      <figure id="addmedia">
        <title>Add Media Object Dialog Box</title>
        <screenshot>
	  <screeninfo>Add Media Object Dialog Box</screeninfo>
	  <graphic fileref="addmedia" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      </para>
      <para>
      Finally, you may drag-and-drop an object from either a file
      manager or a web browser. If the object is dropped into a
      gallery, then a reference is made in the gallery, and the object
      appears in the Media View. If the object is dropped directly
      into the Media View, then it appears in the Media View, but will
      not appear in a gallery. Currently, all objects imported via
      drag-and-drop are imported as external (not local) objects.
      </para>
    </sect2>
    <sect2>
      <title>Making a Reference to a Media Object</title>
      <para>
      Once an object is in the Media View, it is possible to make a
      reference to it in any gallery. You may place the object in as
      many galleries as you like, and only one copy of the file will
      exist.
      </para>
      <para>
      To make a reference to a media object in a gallery, you may
      simply drag-and-drop the object from the Media View directly to
      a gallery. The object will then appear in the
      gallery. Similarly, you may drag-and-drop from one gallery to
      another gallery, and a new object reference is created in the
      target gallery.
      </para>
    </sect2>
    <sect2>
      <title>Changing a Media Object's Properties</title>
      <para>
      Media objects have global and local properties. The title of the
      object is a global property. It may only be changed from the
      Media View, and it will affect all references. An object also
      has a global note and a set of user defined global attributes.
      A reference in a gallery may a have a local note and local
      attributes as well. All references share the global properties,
      but each gallery has its own set of notes a attributes.
      </para>
      <para>
      The global note can be used to provide a general
      description. For example, in a family reunion image, you may
      wish to use the global note to indicate the place, date, and
      occasion of the photograph. In a local note in Aunt Martha's
      gallery, you may wish to add a local note indicating that
      &quot;Aunt Martha is the third person from the right in the
      second row&quot;.
      </para>
      <para>
      The global properties may be changed by selecting the
      <guibutton>Edit Media Object</guibutton> button.
      <figure id="globalmedia">
        <title>Edit a Media Object's Global Properties</title>
        <screenshot>
	  <screeninfo>Edit a Media Object's Global Properties</screeninfo>
	  <graphic fileref="globalmedia" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      </para>
    </sect2>
  </sect1>

  <sect1 id="bookmarks">
    <title>Bookmarking People</title>
    <para>
    <application>GRAMPS</application> supports two mechanisms to
    quickly find people - the home person and bookmarks.
    </para>
    <sect2 id="homeperson">
      <title>Home Person</title>
      <para>
      The home person is the default person of the database. Upon
      loading the database, <application>GRAMPS</application> will set
      the active person to the default person. At any time, clicking
      the <guibutton>Home</guibutton> button will return the active
      person to the home person.
      </para>
      <para>
      The home person can be set by choosing
        <menuchoice>
	  <guimenu>Settings</guimenu>
	  <guimenuitem>Set Default Person</guimenuitem>
	</menuchoice>.
      </para>
    </sect2>
    <sect2 id="bkmarks">
      <title>Bookmarks</title>
      <para>
      Bookmarks work similar to bookmarks in HTML browsers.  They
      allow you to quickly jump to a person, making that person the
      active person. This allows you to avoid searching for them
      everytime you want to add/change something in their information.
      </para>
      <figure id="gotobookmark">
        <title>Using Bookmarks</title>
        <screenshot>
	  <screeninfo>Using Bookmarks</screeninfo>
  	  <graphic fileref="gotobookmark" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      Choosing
        <menuchoice>
	  <guimenu>Bookmarks</guimenu>
	  <guimenuitem>Add Bookmark</guimenuitem>
        </menuchoice>
      adds the current active person to the bookmark list. The person
      will then appear in the bookmark list, allowing you to quickly
      select the person.
      </para>
      <para>
      Choosing
        <menuchoice>
	  <guimenu>Bookmarks</guimenu>
	  <guimenuitem>Go to Bookmark</guimenuitem>
        </menuchoice>
      displays a submenu which allows you to choose a person who was
      previously bookmarked. Selecting a person from this menu will
      make that person the active person.
      </para>
      <para>
      Choosing
        <menuchoice>
	  <guimenu>Bookmarks</guimenu>
	  <guimenuitem>Edit Bookmarks</guimenuitem>
        </menuchoice>
      displays a dialog box that allows you to reorder or delete
      bookmarks in the list.
      </para>
      <figure id="editbookmark">
        <title>Editing Bookmarks</title>
        <screenshot>
	  <screeninfo>Editing Bookmarks</screeninfo>
  	  <graphic fileref="editbookmarks" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
    </sect2>
  </sect1>

  <sect1 id="revisoncontrol">
    <title>Using Revision Control</title>
    <para>
    Revision control allows you to keep a history of the changes that
    you have made to your database. Instead of needing to keep
    multiple sets of back up files, a single revision control database
    is maintained. At any point, you can revert back to a previously
    saved version.
    </para>
    <para>
    <application>GRAMPS</application> uses the standard
    <application>RCS</application> system to handle revisions.
    </para>
    <para>
    Revison control is enabled in the Revision Control tab of the
    preferences dialog. Once enabled, every save is logged into the
    revision control database. If you have enabled prompting for a
    comment, then a dialog box will be displayed on every save asking
    you to provide a comment about the changes you have made.
      <figure id="revcomment">
        <title>Providing a revision control comment</title>
        <screenshot>
	  <screeninfo>Providing a revision control comment</screeninfo>
  	  <graphic fileref="savecomment" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
    </para>
    <sect2>
      <title>Reverting to a previous version</title>
      <para>
      If revision control has been enabled, you have the option of
      reverting to a previous version of the database. Selecting the
      check box will allow you to select a previous version.
      <figure id="opendb">
        <title>Opening a database</title>
        <screenshot>
	  <screeninfo>Opening a database</screeninfo>
  	  <graphic fileref="opendb" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      </para>
      <para>
      If the check box has be selected, <application>GRAMPS</application>
      will display a dialog box that will allow you to choose which version 
      you would like to view. The dialog box displays the version number, the
      date the version was saved, who saved the database, and any comment supplied 
      when the datbase was saved.
      <figure id="revcontrol">
        <title>Choosing a revision</title>
        <screenshot>
	  <screeninfo>Choosing a revision</screeninfo>
  	  <graphic fileref="revcontrol" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      </para>
      <para>
      Choosing a previous revision does not replace your current
      database. If you do not save the retrieved database, it will not
      replace the current version. If for some reason you accidentally
      save the retrieved database when you did not want to replace the
      current version, you can always use the revison control
      mechanism to get back the version you replaced.
      </para>
      <para>
      Revision control is applied only to the database itself, not to
      any media objects have been associated with the database.
      </para>
    </sect2>
  </sect1>

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

  <sect1 id="prefs">
    <title>Customization</title>
    <para>
    To change the application settings, select
      <menuchoice>
        <guimenu>Settings</guimenu>
        <guimenuitem>Preferences...</guimenuitem>
       </menuchoice>.  This opens the
    <interface>Preferences</interface> dialog, shown in <xref
    linkend="prefs_gen">.
    </para>

    <sect2 id="prefs_tab0">
      <title>General Preferences</title>
      <figure id="prefs_gen">
        <title>Preferences Dialog</title>
        <screenshot>
          <screeninfo>Preferences Dialog</screeninfo>
          <graphic fileref="prefs_gen" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The General Preferences tab contains basic information to
      control the operation of <application>GRAMPS</application>.
      </para>
      <variablelist>
        <title>General Preferences options</title>
	<varlistentry>
  	  <term>Automatically load last database</term>
          <listitem>
            <para>
	    With this selected it will automatically load your last
	    database.
            </para>
          </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Do not compress XML data file</term>
          <listitem>
            <para>
	    <application>GRAMPS</application> normally compresses its
	    data file to conserve disk space. If you do not whish to
	    have the file compressed, selecting this option will cause
	    <application>GRAMPS</application> to leave the file
	    uncompressed.  This may be desirable if other applications
	    need to process the generated XML file.
  	    </para>
          </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Use tabbed pages</term>
          <listitem>
            <para>
	    When this is selected there will be a row of tabs below
	    the tool bars for the Person View, Family View, Pedigree
	    View, and Sources View.
	    </para>
          </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Display GRAMPS ID in list</term>
          <listitem>
            <para>
	    This will add a new column to the Person View with the
	    <application>GRAMPS</application> ID for each individual.
	    </para>
          </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Allow internal GRAMPS ID numbers to be edited</term>
          <listitem>
            <para>
	    This option allows advanced users to edit the internal
	    <application>GRAMPS</application> indentification strings
	    for certain entries.
	    </para>
          </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Display attribute on Edit Person form</term>
          <listitem>
	    <para>
	    Selecting this and adding a comment/word will add that
	    comment/word to the Identification part of the Edit Person
	    view.
            </para>
          </listitem>
	</varlistentry>
      </variablelist>
    </sect2>    
    <sect2 id="prefs_tab1">
      <title>Formats</title>
      <figure id="prefs_fmt">
        <title>Formats</title>
        <screenshot>
          <screeninfo>Formats Tab</screeninfo>
          <graphic fileref="prefs_fmt" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      The <interface>Formats</interface> tab allows you to change the
      display formats of several different typs of data. This includes
      dates and names.
      </para>
      <variablelist>
        <title>Formats Preferences options</title>
	<varlistentry>
  	  <term>Display Formats</term>
          <listitem>
            <para>
	    Allows you to choose your preferences for displaying dates
	    and names. Options exist for several different date
	    formats. Names can be displayed with either the given name
	    or the surname first. This option typically does not
	    affect lists that are sorted by last name, in which case
	    the surname is displayed first.
            </para>
          </listitem>
	</varlistentry>
	<varlistentry>
  	  <term>Entry Formats</term>
          <listitem>
            <para>
	    Numerical date formats can be ambiguous. Some people enter
	    the day, month, and year (European style), while others
	    prefer month, day, year (American style). Selecting the
	    option here informs <application>GRAMPS</application> how
	    it should interpret numerical dates.
            </para>
          </listitem>
	</varlistentry>
      </variablelist>
    </sect2>
    <sect2 id="prefs_tab2">
      <title>Appearance Preferences</title>
      <figure id="prefs_appear">
        <title>Preferences Dialog</title>
        <screenshot>
          <screeninfo>Appearance Preferences Dialog</screeninfo>
          <graphic fileref="prefs_appear" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <variablelist>
        <title>Appearance Preferences</title>
        <varlistentry>
	  <term>Custom Colors</term>
          <listitem>
	    <para>
	    Enabling custom colors allows you to choose foreground and
	    background colors for the Person View list. A different
	    color combinations may be chosen for odd and even
	    rows. This may make the display easier to read. It should
	    be noted that it may slow down redisplays of the window if
	    a large number (thousands) of people are in the list.
            </para>
          </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Status Bar</term>
          <listitem>
            <para>
	    Allows you to change the information displayed in the
            status bar at the bottom of the window.  There are three
            (3) preferences from which to chose.  The first is Active
            person's name only - this will display the active person's
            name only in the status bar.  The second is Active
            person's name and GRAMPS ID - This will display the name
            and ID for the active person ( [I9] Edwin Michael Smith ).
            The last option is Active person's name and attribute -
            this is just like the second option but shows the
            attribute you specified in the General Preferences
            section.
            </para>
          </listitem>
	</varlistentry>
	<varlistentry>
	  <term>List Display Options</term>
  	  <listitem>
	    <para>
  	    Allows you to control what gets displayed in lists. You can
  	    control if alternate names are displayed in the lists, or
  	    if the lists will contain detail flags to indicate
  	    additional information (such as the presence of notes,
  	    sources, or images).
            </para>
          </listitem>
	</varlistentry>
      </variablelist>
    </sect2>
    <sect2 id="prefs_tab3">
      <title>Researchers Preferences</title>
      <figure id="prefs_research">
        <title>Researcher Information Dialog</title>
        <screenshot>
          <screeninfo>Researcher Information Dialog</screeninfo>
          <graphic fileref="prefs_research" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      This is where you are able to change the information you entered
      when you started GRAMPS for the first time and was asked to
      enter in some information. (This information shows up in your
      GEDCOM files as being the researcher/author of the file)
      </para>
    </sect2>
    <sect2 id="prefs_tab4">
      <title>Report Preferences</title>
      <figure id="prefs_report">
        <title>Report Preferences Dialog</title>
        <screenshot>
          <screeninfo>Report Preferences Dialog</screeninfo>
          <graphic fileref="prefs_report" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      Many of the reports that <application>GRAMPS</application>
      produces can be generated in different file formats and
      different paper sizes. Selecting a <guilabel>Preferred Output
      Format</guilabel> and a <guilabel>Preferred Output
      Format</guilabel> tells the report generator your
      preferences. It should be noted that a report generator might
      not support all possible formats.
      </para>
    </sect2>
    <sect2 id="prefs_tab5">
      <title>Directories Preferences</title>
      <figure id="prefs_dir">
        <title>Directory Preferences Dialog</title>
        <screenshot>
          <screeninfo>Directory Preferences Dialog</screeninfo>
          <graphic fileref="prefs_dir" format="png" srccredit="Don Allingham">
          </graphic>
        </screenshot>
      </figure>
      <para>
      This allows you to set the default directories for your databases,
      reports, and Web Sites.
      </para>
    </sect2>
  </sect1>

 <!-- ============= Generating Reports ============================= -->

  <sect1 id="genreports">
    <title>Generating Reports</title>
    <para>
    <application>GRAMPS</application> can produce a wide variety of
    reports. A new report generator can be written by the user without
    modifying the main program. For this reason, there may be more
    reports available than are documented by this manual.
    </para>
    <figure id="report-fig">
      <title>Report Generation Dialog</title>
      <screenshot>
        <screeninfo>Report Generation Dialog</screeninfo>
        <graphic fileref="reportsel" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <para>
    Unlike many genealogy programs, <application>GRAMPS</application>
    does not directly print reports. Instead,
    <application>GRAMPS</application> produces reports in formats that
    are understood by other programs.  These formats include
    OpenOffice, AbiWord, PDF, and HTML, among others. This allows the
    generated reports to be modified after they are generated, stored
    for use at a later time, or e-mailed to another person.
    </para>
    <para>
    After selecting the report you would like generated there are
    options you must select.  In the Save As option specify your file
    name (use /full path/filename to specify a different directory
    than in your Default Report Directory preference in the
    preferences).  The next step is to select the Report Format.
    After choosing the Format you can select the style you would like
    to use for your report (this does not apply to the HTML format).
    You can Add/Edit/Delete a style for that particular report by
    clicking the <guibutton>Style Editor</guibutton> button.
    Selecting one of those options you can then change the font (font
    face, size, color, and options) for each Paragraph Style along
    with the Paragraph Options (Alignment, background color, margins,
    and dorders).  Once you are satisfied with the style you are ready
    to proceed with the generation of your report.  The next step is
    to choose the options (if any for that specific report) and then
    Choose the Template (for HTML format only) and click OK.  Your
    report will now be in default report directory (unless otherwise
    specified). 
    </para>
    <sect2 id="htmltemplates">
      <title>Using HTML templates</title>
      <para>
      Many programs exist to convert GEDCOM files into HTML files that
      can be viewed in a web browser. Most of these programs generate
      HTML files according to their own predefined style. Since most
      people have a style that they prefer, they are left with the
      option of modifying hundreds of files by hand.
      </para>
      <para>
      To solve this problem, <application>GRAMPS</application> allows
      the user to specify a template to be used for generating HTML
      files.  At the time the report is generated, if HTML is selected
      as the target format, the user can select an HTML template to be
      used.  Since the template is chosen at report generation time, a
      different template may be chosen each time, allowing the user to
      change the appearance of the generated files at any time.
      Nearly any existing HTML file can be used as an HTML template
      for <application>GRAMPS</application>.
      </para>
      <para>
      When a file has been established as the HTML template file,
      <application>GRAMPS</application> uses the template for each
      file that it generates. <application>GRAMPS</application> starts
      each file by copying data from the template until it reaches the
      HTML comment, which it uses as a marker.  At that point,
      <application>GRAMPS</application> inserts its data into the
      output file. <application>GRAMPS</application> the continues
      reading the until it reaches a second comment that tells it to
      resume copying from the template.
      </para>
      <para>
      <application>GRAMPS</application> uses the string
      <function>&lt;!-- START --&gt;</function> to indicate where it
      should start inserting its information, and the string
      <function>&lt;!-- STOP --&gt;</function> to indicate where it
      should resume copying data from the template.  The effect is
      that <application>GRAMPS</application> will create a new
      document, replacing everything between the <function>&lt;!--
      START --&gt;</function> and <function>&lt;!-- STOP
      --&gt;</function> comments with the report information.
      </para>
      <para>
      The comment markers should be at the beginning of a line in the
      HTML template file.  Adding the comments to an existing HTML
      document will not affect the original HTML document in any way.
      </para>
      <para>
      If no HTML template is specified, or if the specified template
      cannot be read, <application>GRAMPS</application> will use a
      default, predefined template.
      </para>
      <figure id="templateexample">
        <title>Sample HTML Template Example</title>
        <programlisting>
&lt;HTML&gt;
&lt;HEAD&gt;
&lt;TITLE&gt;
This is my Title
&lt;/TITLE&gt;
&lt;/HEAD&gt;
&lt;BODY BGCOLOR="#FFFFFF"&gt;
&lt;P&gt;
This is a simple template.  This text will appear in the html output.
&lt;/P&gt;
&lt;!-- START --&gt;
&lt;P&gt;
This is where GRAMPS will place its report information. Any 
information between the two comments, including this paragraph,
will not appear in the GRAMPS generated output.
&lt;/P&gt;
&lt;!-- STOP --&gt;
&lt;P&gt;
This text, since it appears after the stop comment, will also
appear in every GRAMPS generated file.
&lt;/P&gt;
&lt;/BODY&gt;
&lt;/HTML&gt;
        </programlisting>
      </figure>
    </sect2>
  </sect1>

 <!-- ============= Running Tools ============================= -->

  <sect1 id="runtools">
    <title>Running Tools</title>
    <para>
    <application>GRAMPS</application> supports standard and user
    written tools. These tools can operate on the database to perform
    a specified task.
    </para>
    <figure id="tools-fig">
      <title>Tool Selection Dialog</title>
      <screenshot>
        <screeninfo>Tool Selection Dialog</screeninfo>
        <graphic fileref="toolsel" format="png" srccredit="Don Allingham">
        </graphic>
      </screenshot>
    </figure>
    <variablelist>
      <title>Analysis and Exploration</title>
      <varlistentry>
        <term>Compare individual events</term>
        <listitem>
	  <para>
	  Aids in the analysis of data by allowing the development of
	  custom filters that can be applied to the database to find
	  similar events.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>Interactive descendant browser</term>
	<listitem>
	  <para>
	  Provides a browsable hierarchy based on the active person.
	  </para>
	</listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <title>Data Processing</title>
      <varlistentry>
        <term>Check and repair database</term>
        <listitem>
	  <para>
	  Checks the database for integrity problems, fixing the
	  problems that it can.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term>Extract information from names</term>
	<listitem>
	  <para>
	  Searches the entire database and attempts to extract titles
	  and nicknames that may be embedded in a person's given name
	  field.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term>Merge people</term>
	<listitem>
	  <para>
	  Searches the entire database, looking for individual entries
	  that may represent the same person.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term>Rename personal event types</term>
	<listitem>
	  <para>
	  Allows all the events of a certain name to be renamed to a
	  new name.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term>Reorder GRAMPS ID's</term>
	<listitem>
	  <para>
	  Reorders the GRAMPS ID's according to GRAMPS' default rules.
	  </para>
	</listitem>
      </varlistentry>
    </variablelist>
    <variablelist>
      <title>Utilities</title>
      <varlistentry>
        <term>Generate SoundEx codes</term>
        <listitem>
	  <para>
	  Generates SoundEx codes for names.
	  </para>
	</listitem>
      </varlistentry>
      <varlistentry>
        <term>Relationship calculator</term>
	<listitem>
	  <para>
	  Calulates the relationship between two people.
	  </para>
	</listitem>
      </varlistentry>
    </variablelist>
  </sect1>

 <!-- ============= Bugs ================================== 

  <sect1 id="bugs">
    <title>Known Bugs and Limitations</title>
    <para>
    This application has no known bugs.
    </para>
  </sect1>
-->

<!-- ============= Authors ================================ -->

  <sect1 id="authors">
    <title>Authors</title>
    <para>
    <application>GRAMPS</application> was written by Don Allingham
    (<email>dallingham@users.sourceforge.net</email>). To find more
    information about <application>GRAMPS</application>, please visit
    the <ulink url="http://gramps.sourceforge.net" type="http">GRAMPS
    Web page</ulink>.
    </para>
    <para>
    This manual was written by Don Allingham
    (<email>dallingham@users.sourceforge.net</email>), Larry Allingham
    (<email>llkla@erinet.com</email>), and Shawn Ann Griffith
    (<email>shawnann1@home.com</email>).
    </para>

<!-- For translations: uncomment this:

    <para>
    Latin translation was done by ME
    (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
    suggestions regarding this translation to SOMEWHERE.
    </para>
-->

  </sect1>

<!-- ============= Application License ============================= -->

  <sect1 id="license">
    <title>License</title>
    <para>
    This program is free software; you can redistribute it and/or
    modify it under the terms of the <ulink type="help"
    url="gnome-help:gpl"> <citetitle>GNU General Public
    License</citetitle></ulink> as published by the Free Software
    Foundation; either version 2 of the License, or (at your option)
    any later version.
    </para>
    <para>
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <citetitle>GNU General Public License</citetitle> for more
    details.
    </para>
    <para>
    A copy of the <citetitle>GNU General Public License</citetitle> is
    included as an appendix to the <citetitle>GNOME Users
    Guide</citetitle>.  You may also obtain a copy of the
    <citetitle>GNU General Public License</citetitle> from the Free
    Software Foundation by visiting <ulink type="http"
    url="http://www.fsf.org">their Web site</ulink> or by writing to
    <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
    </address>
    </para>
  </sect1>
</article>