A little advance

svn: r1339

doc/gramps-manual/C/gramps.xml

@@ -184,7 +184,7 @@
       your analysis and correlation using the speed, power, and accuracy of your
       computer instead of pencils and unmanageable reams of paper. </para>
     </sect2>
-  </sect1> 
+  </sect1> <!-- ================ End Intro ================================ -->
 	
 <!-- =========== Getting Started ============================== -->
 
@@ -294,7 +294,7 @@
 
       </sect3>
     </sect2>
-  </sect1>
+  </sect1> <!-- ================ End Getting Started ======================== -->
   
 <!-- ================ Main Window ================================ -->
   <sect1 id="gramps-mainwin"> 
@@ -623,7 +623,7 @@
       </sect3>
 
     </sect2>
-  </sect1> 
+  </sect1>  <!-- ================ End Main Window ===================== -->
 
 
 <!-- ================ Usage ================================ -->
@@ -631,12 +631,12 @@
     <title>Usage</title> 
     <para>As commonly encountered in everyday life, in
     <application>&app;</application> there is usually more than one way to
-    accomplish something. The alternatives to some actions will therefore be
+    accomplish something. The alternatives to some actions will therefore 
-    listed as appropriate.</para> 
+    be listed as appropriate.</para> 
 
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="open-db"> 
-      <title>To Open a Database</title> 
+      <title>Opening Database</title> 
       <para>To open a database, either choose <menuchoice>
       <guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
       or click <guibutton>Open</guibutton> button on the Toolbar. 
@@ -663,7 +663,7 @@
 
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="new-db"> 
-      <title>To Start a New Database</title> 
+      <title>Starting New Database</title> 
       <para>To start a new database, choose <guimenu>File</guimenu>
       <guimenuitem>New</guimenuitem></menuchoice>. You will then be 
       prompted with the <guilabel>Save Database</guilabel> dialog asking 
@@ -674,7 +674,7 @@
 
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="save-db"> 
-      <title>To Save a Database</title> 
+      <title>Saving Database</title> 
       <para>To save changes made to your database, choose <guimenu>File</guimenu>
       <guimenuitem>Save</guimenuitem></menuchoice> or click
       <guibutton>Save</guibutton> on the Toolbar. The Status line will then 
@@ -684,7 +684,7 @@
 
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="import-gedcom"> 
-      <title>To Import GEDCOM Data</title> 
+      <title>Importing GEDCOM Data</title> 
       <para>Importing GEDCOM data allows you to incorporate the data created in 
       other genealogical programs into your currently 
       open <application>&app;</application> database. 
@@ -713,7 +713,7 @@
       
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="export-gedcom"> 
-      <title>To Export GEDCOM Data</title> 
+      <title>Exporting GEDCOM Data</title> 
       <para>Exporting GEDCOM data allows you to share any portion of you 
       <application>&app;</application> database with other researchers 
       by way of standard GEDCOM files. To export into GEDCOM file, 
@@ -766,12 +766,70 @@
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="gramps-edit"> 
       <title>Editing</title> 
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-edit-pers"> 
+        <title>Edit Personal Data</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-edit-rel"> 
+        <title>Edit Relationship Data</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-edit-child"> 
+        <title>Edit Children Data</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-edit-parent"> 
+        <title>Edit Parental Data</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-edit-sources"> 
+        <title>Edit Sources</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-edit-places"> 
+        <title>Edit Places</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-edit-media"> 
+        <title>Edit Media Objects</title> 
+      </sect3>
+
     </sect2>
 
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="gramps-nav"> 
        <title>Nevigation</title> 
+       
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-nav-default"> 
+        <title>Setting Default Person</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-nav-bookmk"> 
+        <title>Bookmarking People</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-nav-family"> 
+        <title>Using Family View</title> 
+      </sect3>
+
+      <!-- ================ Usage Sub-subsection ================ -->
+      <sect3 id="gramps-nav-pedigree"> 
+        <title>Using Pedigree View</title> 
+      </sect3>
+
    </sect2>
+   
     <!-- ================ Usage Subsection ================================ -->
     <sect2 id="gen-reports"> 
         <title>Generating Reports</title> 
@@ -781,9 +839,203 @@
         <title>Running Tools</title> 
     </sect2>
 
+  </sect1> <!-- ================ End Usage ============== -->
+
+<!-- ================ Customization ================================ -->
+
+  <sect1 id="gramps-prefs"> 
+    <title>Settings</title> 
+    <para>To configure <application>&app;</application>, choose 
+      <menuchoice><guimenu>Settings</guimenu>
+      <guimenuitem>Preferences</guimenuitem></menuchoice>. 
+      The <guilabel>Preferences</guilabel> dialog contains the 
+      following sections seen as the corresponding tree elements:</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> 
+    </sect2>
 
 [ FIXME: STOPPED HERE ] 
+    
+    
+  </sect1> <!-- ================ End Customization ================== -->
 
+      <variablelist> 
+	<varlistentry> 
+	  <term> 
+	    <guilabel>Interpolation type</guilabel> </term> 
+	  <listitem> 
+	    <para>Use this drop-down list box to specify the
+	      interpolation method that
+	      &app; uses when the
+	      application resizes images. Select one of the following
+	      options:</para>
+	    <itemizedlist> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Nearest neighbor</guilabel> </para> 
+		<para>This method of interpolation takes a location in the
+		  original image and replicates the pixel that is
+		  nearest to this location. When 
+		  you zoom in on an image, the pixels are
+		  replicated. When you zoom out of an 
+		  image, the image loses some of its detail. </para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Bilinear</guilabel> </para> 
+		<para>This is a simple and fast method of interpolation. When
+		  you zoom in on an image, &app; uses up to four
+		  adjacent pixels to compute the colors of the new
+		  pixels. When you zoom out of 
+		  an image, &app; averages regions of color in the
+		  existing image to compute the colors of the pixels. </para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Hyperbolic</guilabel> </para> 
+		<para>This is a high-quality, slow method of interpolation. The
+		  application performs interpolation on the image in
+		  the manner described in 
+		  Digital Image Warping by George Wolberg.</para> 
+	      </listitem> 
+	    </itemizedlist> 
+	    <para>Default: 
+	      <guilabel>Nearest neighbor</guilabel>.</para> 
+	  </listitem> 
+	</varlistentry> 
+	<varlistentry> 
+	  <term> 
+	    <guilabel>Transparency type</guilabel> </term> 
+	  <listitem> 
+	    <para>Use this drop-down list box to specify how
+	      &app; displays transparent or partially opaque
+	      backgrounds in images. Select one of the following options:</para> 
+	    <itemizedlist> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Dark checks</guilabel> </para> 
+		<para>This option displays black and dark gray checks.</para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Midtone checks</guilabel> </para> 
+		<para>This option displays dark gray and light gray
+		  checks.</para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Light checks</guilabel> </para> 
+		<para>This option displays light gray and white checks.</para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Black only</guilabel> </para> 
+		<para>This option displays solid black.</para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Gray only</guilabel> </para> 
+		<para>This option displays solid gray.</para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>White only</guilabel> </para> 
+		<para>This option displays solid white.</para> 
+	      </listitem> 
+	    </itemizedlist> 
+	    <para>Default: 
+	      <guilabel>Dark checks</guilabel>.</para> 
+	  </listitem> 
+	</varlistentry> 
+	<varlistentry> 
+	  <term> 
+	    <guilabel>Check size</guilabel> </term> 
+	  <listitem> 
+	    <para>Use this drop-down list box to specify the size of the checks
+	      to use to display transparent or partially opaque
+	      backgrounds in images. This 
+	      option is only relevant if you choose 
+	      <guilabel>Dark checks</guilabel>, 
+	      <guilabel>Midtone checks</guilabel>, or 
+	      <guilabel>Light checks</guilabel> from the 
+	      <guilabel>Transparency type</guilabel> drop-down list box.
+	      Select one of the following options:</para> 
+	    <itemizedlist> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Small</guilabel></para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Medium</guilabel></para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Large</guilabel></para> 
+	      </listitem> 
+	    </itemizedlist> 
+	    <para>Default: 
+	      <guilabel>Small</guilabel>.</para> 
+	  </listitem> 
+	</varlistentry> 
+	<varlistentry> 
+	  <term> 
+	    <guilabel>Dither type</guilabel> </term> 
+	  <listitem> 
+	    <para>Use this drop-down list box to specify the dithering method
+	      to use to display images. Dithering is a technique that
+	      is used to simulate 
+	      colors in the original image file but that your system
+	      can not display. Select 
+	      one of the following options:</para> 
+	    <itemizedlist> 
+	      <listitem> 
+		<para> 
+		  <guilabel>None</guilabel> </para> 
+		<para>This option does not use dithering. </para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Normal (pseudocolor)</guilabel> </para> 
+		<para>This option performs dithering on pseudocolor displays,
+		  which use a limited palette of colors. </para> 
+	      </listitem> 
+	      <listitem> 
+		<para> 
+		  <guilabel>Maximum (high color)</guilabel> </para> 
+		<para>This option performs dithering on pseudocolor and high
+		  color displays. </para> 
+	      </listitem> 
+	    </itemizedlist> 
+	    <para>Default: 
+	      <guilabel>None</guilabel>.</para> 
+	  </listitem> 
+	</varlistentry> 
+	<varlistentry> 
+	  <term> 
+	    <guilabel>Two-pass scrolling</guilabel> </term> 
+	  <listitem> 
+	    <para>Select this option to render an image in two passes
+	      when you scroll the image quickly. The first pass
+	      renders a low quality version of the image. The second
+	      pass renders a full quality version of the image over
+	      the low quality version. Two-pass scrolling enables you
+	      to view at least a low quality version of the image at
+	      all times regardless of how quickly you scroll the
+	      image. 
+	    </para>
+	    <para>Default: unselected.</para> 
+	  </listitem> 
+	</varlistentry> 
+      </variablelist> 
+    </sect2>
 
 
 
@@ -1304,18 +1556,19 @@
       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.-->
+      manual, this is the place to put it. 
-  <sect1 id="myapp-about"> 
+      Alternatively, you can put this information in the title page.-->
+  <sect1 id="gramps-about"> 
     <title>About &app;</title> 
-    <para> &app; was written by GNOME-HACKER
+    <para> &app; was written by Donald N. Allingham
-      (<email>hacker@gnome.org</email>). To find more information about
+      (<email>dallingham@users.sourceforge.net</email>). 
-      &app;, please visit the 
+      To find more information about &app;, please visit the 
-      <ulink url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
+      <ulink url="http://gramps.sourceforge.net" type="http">GRAMPS Project 
-	page</ulink>. </para>
+      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>.
+      <ulink url="ghelp:gnome-feedback"  type="help">document</ulink>.
     </para>
 
     <para> This program is distributed under the terms of the GNU