<?xml version="1.0" encoding="UTF-8"?>

<!--
	  User Manual for Gramps - a GTK+/GNOME based genealogy program

	  Copyright (C) 2003  Alexander Roitman

	  Permission is granted to copy, distribute and/or modify this
	  document under the terms of the GNU Free Documentation
	  License (GFDL), 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 is included in the file COPYING-DOCS 
          distributed with this manual.
-->

<!-- $Id$ -->

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

  <sect1 id="gramps-prefs"> 
    <title>Settings</title> 
    <para>To configure &app;, choose 
      <menuchoice><guimenu>Edit</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>Family name guessing</guilabel></term>
	<listitem><para> This option affects the initial family name of a 
	child when he/she is added to the database. NOTE: this option only
	affects the initial family name guessed by &app; when the 
	<guilabel>Edit Person</guilabel> dialog is launched. You can modify
	that name the way you see fit. Set this option to the value that you 
	will most frequently use, as it will save you a lot of typing.</para>
	
	<para>If <guilabel>None</guilabel> is selected, no guessing will be 
	attempted. Selecting <guilabel>Father's surname</guilabel> will use
	the family name of the father. Selecting <guilabel>Combination of 
	mother's and father's surname</guilabel> will use the father's name 
	followed by the mother's name. Finally, <guilabel>Icelandic 
	style</guilabel> will use the father's given name followed by the 
	&quot;sson&quot; suffix (e.g. the son of Edwin will be guessed as 
	Edwinsson).
	</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>Default view</guilabel></term>
	<listitem><para> This determines which view will appear when you 
        start &app;. Choose between Person and Family views. 
	</para></listitem>
	</varlistentry>

	<varlistentry><term><guilabel>Family view style</guilabel></term>
	<listitem><para> This selects between the two available styles of the Family 
        view layout. The <guilabel>Left to right</guilabel> style is similar to the 
        Family Tree Maker (tm), while the <guilabel>Top to bottom</guilabel> is
        similar to the Reunion. 
	</para></listitem>
	</varlistentry>

	<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.  This will allow you to select different 
	calendars when editing the dates. 
	</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
	from the menu. Selecting <guilabel>GNOME Settings</guilabel> will use
	the overall settings selected for your GNOME desktop. 
	</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>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 compile
	all medial objects, no matter whether they are local or not. 
	Specifically, 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 appropriate 
	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 ================== -->
