Cyclone-Team/gramps
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* doc/gramps-manual/C/authors.xml: Add file.

Browse Source 
* doc/gramps-manual/C/bugs.xml: Add file.
* doc/gramps-manual/C/preface.xml: Add file.
* doc/gramps-manual/C/Makefile.am: Ship new files.
* doc/gramps-manual/C/cmdline.xml: Convert to book.
* doc/gramps-manual/C/custom.xml: Convert to book.
* doc/gramps-manual/C/faq.xml: Convert to book.
* doc/gramps-manual/C/filtref.xml: Convert to book.
* doc/gramps-manual/C/getstart.xml: Convert to book.
* doc/gramps-manual/C/gramps-manual.xml: Convert to book.
* doc/gramps-manual/C/keybind.xml: Convert to book.
* doc/gramps-manual/C/legal.xml: Change license to GPL.
* doc/gramps-manual/C/mainwin.xml: Convert to book.
* doc/gramps-manual/C/usage.xml: Convert to book.
* COPYING-DOCS: Change license to GPL.


svn: r4032
This commit is contained in:
Alex Roitman
2005-02-15 02:35:26 +00:00
parent 9860e05cc2
commit 6566037cdd
16 changed files with 609 additions and 800 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
doc/gramps-manual/C/Makefile.am
View File

@@ -4,12 +4,15 @@ lang = C
omffile = gramps-manual-C.omf
entities = legal.xml\
getstart.xml\
preface.xml\
mainwin.xml\
usage.xml\
custom.xml\
faq.xml\
keybind.xml\
filtref.xml\
cmdline.xml
cmdline.xml\
bugs.xml\
authors.xml
include $(top_srcdir)/doc/xmldocs.make
dist-hook: app-dist-hook

44
doc/gramps-manual/C/authors.xml Normal file
View File

@@ -0,0 +1,44 @@
<appendix id="gramps-about">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2005 Alexander Roitman
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<title>About GRAMPS</title>
<para> &app; was written by Donald N. Allingham
(<email>dallingham@users.sourceforge.net</email>).
To find more information about &app;, please visit the
<ulink url="http://gramps.sourceforge.net" type="http">GRAMPS Project
Web page</ulink>. </para>
<para>
To report a bug or make a suggestion regarding this application or
this manual, use the help menu in &app;, or follow the directions
in this <ulink url="ghelp:gnome-feedback" type="help">document</ulink>.
</para>
<para> This program is distributed under the terms of the GNU
General Public license as published by the Free Software
Foundation; either version 2 of the License, or (at your option)
any later version. A copy of this license can be found at this
<ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
COPYING included with the source code of this program. </para>
</appendix>

27
doc/gramps-manual/C/bugs.xml Normal file
View File

@@ -0,0 +1,27 @@
<appendix id="mayapp-bugs">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2005 Alexander Roitman
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<title>Known Bugs and Limitations</title>
</appendix >

40
doc/gramps-manual/C/cmdline.xml
View File

@@ -1,22 +1,28 @@
<?xml version="1.0" encoding="UTF-8"?>
<appendix id="append-cmdline">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="append-cmdline">
<title>Command line reference</title>
<para>This appendix provides the reference to the command line
capabilities available when launching &app; from the terminal. </para>
@@ -37,7 +43,7 @@
</para>
<sect3 id="cmdline-options">
<sect1 id="cmdline-options">
<title>Available options</title>
<para>Here is the list of the command line options in &app;:
@@ -159,10 +165,10 @@
</variablelist>
</sect3>
</sect1>
<sect3 id="cmdline-operation">
<sect1 id="cmdline-operation">
<title>Operation</title>
<para>The order of <command>-i</command>, <command>-o</command>,
@@ -185,9 +191,9 @@
or or to stderr (if these are not handled). Use usual shell redirections
of stdout and stderr to save messages and errors in files.</para>
</sect3>
</sect1>
<sect3 id="cmdline-examples">
<sect1 id="cmdline-examples">
<title>Examples</title>
<para>To import four databases (whose formats can be determined from
their names) and then check the resulting database for errors, one may
@@ -242,6 +248,6 @@
<para>Finally, to start normal interactive session type:</para>
<para> <command>gramps </command></para>
</sect3>
</sect1>
</sect2>
</appendix>

85
doc/gramps-manual/C/custom.xml
View File

@@ -1,24 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="gramps-prefs">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- ================ Customization ================================ -->
<sect1 id="gramps-prefs">
<title>Settings</title>
<para>To configure &app;, choose
<menuchoice><guimenu>Edit</guimenu>
@@ -33,13 +36,13 @@
</itemizedlist>
<!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-usage">
<sect1 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">
<sect2 id="prefs-usage-find">
<title>Find</title>
<variablelist>
@@ -55,10 +58,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-report">
<sect2 id="prefs-usage-report">
<title>Report Preferences</title>
<variablelist>
@@ -95,10 +98,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-res">
<sect2 id="prefs-usage-res">
<title>Researcher Information</title>
<variablelist>
@@ -115,10 +118,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-guess">
<sect2 id="prefs-usage-guess">
<title>Data Guessing</title>
<variablelist>
@@ -144,19 +147,19 @@
</variablelist>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-display">
<sect1 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">
<sect2 id="prefs-display-gen">
<title>General</title>
<variablelist>
@@ -188,10 +191,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-date">
<sect2 id="prefs-display-date">
<title>Dates and Calendar</title>
<variablelist>
@@ -223,10 +226,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-bars">
<sect2 id="prefs-display-bars">
<title>Toolbar and Statusbar</title>
<variablelist>
@@ -244,18 +247,18 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-db">
<sect1 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">
<sect2 id="prefs-db-gen">
<title>General</title>
<variablelist>
@@ -288,10 +291,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-media">
<sect2 id="prefs-db-media">
<title>Media Objects</title>
<para>Before describing preferences for media objects, let us
@@ -346,10 +349,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-id">
<sect2 id="prefs-db-id">
<title>GRAMPS internal IDs</title>
<variablelist>
@@ -368,10 +371,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-rcs">
<sect2 id="prefs-db-rcs">
<title>Revision Control</title>
<variablelist>
@@ -391,8 +394,8 @@
</variablelist>
</sect3>
</sect2>
</sect2>
</sect1>
</sect1> <!-- ================ End Customization ================== -->
</chapter>

29
doc/gramps-manual/C/faq.xml
View File

@@ -1,22 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<appendix id="faq">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="faq">
<title>Frequently Asked Questions</title>
<para>This appendix contains the list of questions that frequently come
up in mailing list discussions and forums. This list is by no means
@@ -380,4 +385,4 @@ potential of your great idea :-)
</variablelist>
</sect2>
</appendix>

56
doc/gramps-manual/C/filtref.xml
View File

@@ -1,23 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<appendix id="append-filtref">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2004 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="append-filtref">
<title>Filter rules reference</title>
<para>This appendix lists of all the filter rules currently defined
in &app;. Each of these rules is available for use when creating custom
@@ -25,7 +29,7 @@
</para>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-general">
<sect1 id="filtref-general">
<title>General filters</title>
<para>This category includes the following most general rules:</para>
@@ -85,10 +89,10 @@
</variablelist>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-event">
<sect1 id="filtref-event">
<title>Event filters</title>
<para>This category includes the following rules that match people
based on their recorded events:</para>
@@ -160,10 +164,10 @@
</variablelist>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-family">
<sect1 id="filtref-family">
<title>Family filters</title>
<para>This category includes the following rules that match people
based on their family relationships:</para>
@@ -204,10 +208,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-ancestral">
<sect1 id="filtref-ancestral">
<title>Ancestral filters</title>
<para>This category includes the following rules that match people
based on their ancestral relations to other people:</para>
@@ -270,10 +274,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-descendant">
<sect1 id="filtref-descendant">
<title>Descendant filters</title>
<para>This category includes the following rules that match people
based on their descendant relations to other people:</para>
@@ -330,10 +334,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-relat">
<sect1 id="filtref-relat">
<title>Relationship filters</title>
<para>This category includes the following rules that match people
based on their mutual relationship:</para>
@@ -356,10 +360,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-misc">
<sect1 id="filtref-misc">
<title>Miscellaneous filters</title>
<para>This category includes the following rules which do not
naturally fit into any of the above categories:</para>
@@ -389,6 +393,6 @@
</varlistentry>
</variablelist>
</sect3>
</sect1>
</sect2>
</appendix>

73
doc/gramps-manual/C/getstart.xml
View File

@@ -1,28 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="gramps-getting-started">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- =========== Getting Started ============================== -->
<sect1 id="gramps-getting-started">
<title>Getting Started</title>
<!-- ================ Getting Started Subsection ====== -->
<sect2 id="gramps-start">
<sect1 id="gramps-start">
<title>To Start GRAMPS</title>
<para>You can start &app; in the following ways:</para>
<variablelist>
@@ -50,10 +54,10 @@
</para></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<!-- ================ Getting Started Subsection ==== -->
<sect2 id="run-1st-time">
<sect1 id="run-1st-time">
<title>Running GRAMPS for the first time</title>
<para>
The first time you run the program, GRAMPS will display its
@@ -87,10 +91,10 @@
<guilabel>Usage</guilabel> category.
</para>
</sect2>
</sect1>
<!-- ================ Getting Started Subsection -->
<sect2 id="choose-db-start">
<sect1 id="choose-db-start">
<title>Choosing a database on startup</title>
<para>If &app; is started without any
database to open, the following window will appear prompting you to
@@ -128,40 +132,11 @@
created by &app; when you start a new database and is updated each time
the database is saved. </para>
</sect2>
</sect1>
<!-- ================ Getting Started Sub-subsection
<sect3 id="zodb-support">
<title>Optional ZODB support</title>
<para>If either StandaloneZODB or Zope is installed on your system,
&app; will give you the third option of
creating a new ZODB database. You can choose to start your new database
in either XML or ZODB format. Both formats have their strong and weak
points.</para>
<para>XML stands for eXtensible Markup Language, and is a human readable
structured description of data. It could be easily parsed by other
programs should the need occur. It stores only the data itself. Its weak
point is the relatively low speed of processing large data files. </para>
<para>ZODB stands for Zope Object Database and provides the full-fledged
database support. ZODB files are not human readable. They contain a
certain overhead to assist working with large data structures. However,
ZODB provides a significant speed-up when the database size is large (over
a few thousand people). </para>
<para>Its is hard to tell which format is better, since this is a typical
trade-off situation. If you are starting your research then you are likely
to be fine with the regular XML database. If you have tons of data to
import describing thousands upon thousands of people, then you are
probably better off with ZODB. </para>
</sect3>
-->
<!-- ================ Getting Started Subsection ==== -->
<sect2 id="get-help">
<sect1 id="get-help">
<title>Obtaining Help</title>
<para> At any time, the following items are available for immediate aid
from the <menuchoice><guimenu>Help</guimenu></menuchoice> menu: </para>
@@ -205,6 +180,6 @@
</varlistentry>
</variablelist>
</sect2>
</sect1>
</sect1> <!-- ================ End Getting Started ======================== -->
</chapter>

187
doc/gramps-manual/C/gramps-manual.xml
View File

@@ -3,22 +3,36 @@
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2004 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "1.2.0">
<!ENTITY manrevision "2.7.0">
<!ENTITY date "February 2005">
<!ENTITY app "GRAMPS">
<!ENTITY preface SYSTEM "preface.xml">
<!ENTITY getstart SYSTEM "getstart.xml">
<!ENTITY mainwin SYSTEM "mainwin.xml">
<!ENTITY usage SYSTEM "usage.xml">
@@ -27,10 +41,9 @@
<!ENTITY keybind SYSTEM "keybind.xml">
<!ENTITY filtref SYSTEM "filtref.xml">
<!ENTITY cmdline SYSTEM "cmdline.xml">
<!ENTITY appversion "1.0.0">
<!ENTITY manrevision "2.5">
<!ENTITY date "February 2004">
<!ENTITY app "<application>GRAMPS</application>">
<!ENTITY bugs SYSTEM "bugs.xml">
<!ENTITY authors SYSTEM "authors.xml">
<!-- Information about the entities
The legal.xml file contains legal information, there is no need to edit the file.
Use the appversion entity to specify the version of the application.
@@ -46,14 +59,14 @@
Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<book id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
<articleinfo>
<bookinfo>
<title>GRAMPS Manual V&manrevision;</title>
<copyright> <year>2001</year> <holder>Donald N. Allingham</holder> </copyright>
<copyright> <year>2003-2004</year> <holder>Alex Roitman</holder> </copyright>
<copyright> <year>2003-2005</year> <holder>Alex Roitman</holder> </copyright>
<!-- translators: uncomment this:
@@ -69,9 +82,8 @@
<publisher> <publishername> GRAMPS Project </publishername> </publisher>
&legal;
<!-- This file contains link to license for the documentation (GNU FDL), and
other legal stuff such as "NO WARRANTY" statement. Please do not change
any of this. -->
<!-- This file contains link to license for the documentation (GNU GPL), and
other legal stuff such as "NO WARRANTY" statement. -->
<authorgroup>
<author>
@@ -106,7 +118,7 @@
-->
</authorgroup>
<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- According to GNU GPL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document. If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
@@ -129,6 +141,15 @@
<para role="publisher">GRAMPS Project</para>
</revdescription>
</revision>
<revision>
<revnumber>GRAMPS Manual V2.5</revnumber>
<date>February 2004</date>
<revdescription>
<para role="author">Alex Roitman
<email>shura@alex.neuro.umn.edu</email></para>
<para role="publisher">GRAMPS Project</para>
</revdescription>
</revision>
<revision>
<revnumber>GRAMPS Manual V2.4</revnumber>
<date>December 2003</date>
@@ -210,118 +231,28 @@
</para>
<!-- Translators may also add here feedback address for translations -->
</legalnotice>
</articleinfo>
</bookinfo>
<indexterm zone="index"> <primary>GRAMPS</primary> </indexterm>
<indexterm zone="index"> <primary>gramps</primary> </indexterm>
<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<sect1 id="gramps-intro">
<title>Introduction</title>
<para> &app; is a genealogical
application. &app; is an acronym for the
Genealogical Research and Analysis Management Programming System. To put
it shortly, it allows you to store, edit, and research genealogical data
using your computer. Its functionality is somewhat common to other
genealogical programs. However, &app; offers some unique features. </para>
<sect2 id="why-gramps">
<title>Why GRAMPS?</title>
<para> &app; was conceived under the concept
that most genealogy programs were designed to provide the researcher the
capability to input information related to a particular family tree.
Most of these programs have allowed for the arranging and storing of
information consistent with the GEDCOM standards. They usually provide
means for displaying descendant or ancestral relationships by means of
graphical displays, charts, or reports. These may be augmented with
pictures or other media to enhance the data. Most provide for inputting
data on unconnected individuals/families that may or may not have a
relationship to the primary surname being researched. Various other
enhancements may also be provided in the genealogical program that
allows for different degrees of importing and exporting data from other
programs and printing the data contained in the various reports. </para>
<!-- Preface -->
&preface;
<!-- Regular chapters -->
&getstart; <!-- Getting Started -->
&mainwin; <!-- Main window -->
&usage; <!-- Usage -->
&custom; <!-- Customization -->
<!-- Appendices -->
&faq; <!-- FAQ -->
&keybind; <!-- Keybindings reference -->
&filtref; <!-- Filter rule reference -->
&cmdline; <!-- Command line reference -->
&bugs; <!-- Bugs and problems -->
&authors; <!-- About authors -->
<para> &app;, on the other hand, attempts to
provide all of the common capabilities of these programs, but, more
importantly, to provide an additional capability of integration not common
to these programs. This is the ability to input any bits and pieces of
information directly into &app; and
rearrange/manipulate any/all data events in the entire data base (in any
order or sequence) to assist the user in doing research, analysis and
correlation with the potential of filling relationship gaps. In short, it
is a tool that provides a way to input all your research into one place and
do your analysis and correlation using the speed, power, and accuracy of
your computer instead of pencils and unmanageable reams of paper. </para>
</sect2>
</sect1> <!-- ================ End Intro ================================ -->
&getstart; <!-- Getting Started -->
&mainwin; <!-- Main window -->
&usage; <!-- Usage -->
&custom; <!-- Customization -->
<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default.
You can use it to describe known bugs and limitations of the
program if there are any - please be frank and list all
problems you know of.
-->
<sect1 id="mayapp-bugs">
<title>Known Bugs and Limitations</title>
<para>Currently, &app; loads all data into memory, which tends to bog
down the system for large databases (over 15000 people for a typical
system). This will be addressed with the 1.2 release by incorporating
a database backend. The database backend should dramatically improve
both speed and memory usage. </para>
<para>Direct printing is not currently supported. This is planned to be
fixed after the stable 1.0 release by using gnome-print architechture.</para>
<para>PS and PDF reports output garbage in place of unicode characters.
This should also be solved when we move to gnome-print. In the meantime,
a decent workaround is to produce reports in OpenOffice.org format and then
export into PDF from withing OpenOffice.org application.</para>
</sect1>
<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
author's name(s), web page, license, feedback address. This
section is optional: primary place for this info is "About.." box of
the program. However, if you do wish to include this info in the
manual, this is the place to put it.
Alternatively, you can put this information in the title page.-->
<sect1 id="gramps-about">
<title>About GRAMPS</title>
<para> &app; was written by Donald N. Allingham
(<email>dallingham@users.sourceforge.net</email>).
To find more information about &app;, please visit the
<ulink url="http://gramps.sourceforge.net" type="http">GRAMPS Project
Web page</ulink>. </para>
<para>
To report a bug or make a suggestion regarding this application or
this manual, use the help menu in &app;, or follow the directions
in this <ulink url="ghelp:gnome-feedback" type="help">document</ulink>.
</para>
<para> This program is distributed under the terms of the GNU
General Public license as published by the Free Software
Foundation; either version 2 of the License, or (at your option)
any later version. A copy of this license can be found at this
<ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
COPYING included with the source code of this program. </para>
</sect1> <!-- ============= End About ============================= -->
<!-- ============= Appendices ================================== -->
<sect1 id="appendices">
<title>Appendices</title>
&faq; <!-- FAQ -->
&keybind; <!-- Keybindings reference -->
&filtref; <!-- Filter rule reference -->
&cmdline; <!-- Command line reference -->
</sect1>
</article>
</book>

39
doc/gramps-manual/C/keybind.xml
View File

@@ -1,30 +1,33 @@
<?xml version="1.0" encoding="UTF-8"?>
<appendix id="append-keybind">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="append-keybind">
<title>Keybindings reference</title>
<para>This appendix contains the list of keybindings that are not
displayed in menus of &app;.
</para>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="keybind-people">
<sect1 id="keybind-people">
<title>People View</title>
<para>The following bindings are available in the People View:</para>
@@ -48,11 +51,10 @@
</tgroup>
</informaltable>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="keybind-family">
<sect1 id="keybind-family">
<title>Family View</title>
<para>The bindings available in the Family View depend on where the
focus is. The following tables list the bindings for all focus
@@ -258,7 +260,6 @@
</variablelist>
</sect3>
</sect2>
</sect1>
</appendix>

34
doc/gramps-manual/C/legal.xml
View File

@@ -1,19 +1,22 @@
<legalnotice id="legalnotice">
<para>
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. You can find
a copy of the GFDL at this <ulink type="help"
url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
distributed with this manual.
</para>
<para> This manual is part of a collection of GNOME manuals
distributed under the GFDL. If you want to distribute this
manual separately from the collection, you can do so by
adding a copy of the license to the manual, as described in
section 6 of the license.
This manual is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
</para>
<para>
This manual 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
GNU General Public License for more details.
</para>
<para>
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
</para>
<para>
@@ -27,7 +30,7 @@
<para>
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
UNDER THE TERMS OF THE GNU GENERAL PUBLIC LICENSE
WITH THE FURTHER UNDERSTANDING THAT:
<orderedlist>
@@ -73,4 +76,3 @@
</orderedlist>
</para>
</legalnotice>

68
doc/gramps-manual/C/mainwin.xml
View File

@@ -1,23 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="gramps-mainwin">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2004 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- ================ Main Window ================================ -->
<sect1 id="gramps-mainwin">
<title>Main Window</title>
<para>When you open a database (either existing or brand new),
the following window is displayed.</para>
@@ -84,7 +88,7 @@
</variablelist>
<!-- ================ Main Window Subsection -->
<sect2 id="gramps-views">
<sect1 id="gramps-views">
<title>Views</title>
<para>Views are the various ways to display different aspects of
genealogical information, as described below. Since the relevant
@@ -96,7 +100,7 @@
switching between the Views.</para>
<!-- ================ Main Window Sub-subsection -->
<sect3 id="view-modes">
<sect2 id="view-modes">
<title>Switching Views and Viewing Modes</title>
<para>Depending on the state of the <menuchoice>
<guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem>
@@ -139,10 +143,10 @@
<guimenuitem>Sidebar</guimenuitem>
</menuchoice> from the &app; menu.</para>
</sect3>
</sect2>
<!-- ================ Main Window Sub-subsection -->
<sect3 id="people-view">
<sect2 id="people-view">
<title>People View</title>
<para>When &app; first opens a database,
the View is set to the People View (<xref linkend="side-nofilt-fig"/>
@@ -170,7 +174,7 @@
heading. </para>
<!-- ================ Main Window Sub-sub-subsection -->
<sect4 id="filters">
<sect3 id="filters">
<title>Filters</title>
<para>Genealogical databases may contain huge numbers of people.
Since the long lists are hard for humans to handle,
@@ -219,10 +223,10 @@
checking <menuchoice> <guimenu>View</guimenu>
<guimenuitem>Filter</guimenuitem> </menuchoice> menu item and check
what kind of filtering is currently set.</para>
</sect4>
</sect3>
<!-- ================ Main Window Sub-sub-subsection -->
<sect4 id="alpha-tabs">
<sect3 id="alpha-tabs">
<title>Alphabetical Tabs</title>
<para>&app; offers another way of
managing long lists of people -- alphabetical tabs. Upon loading a
@@ -234,12 +238,12 @@
characters -- all the entries not assigned to any other tab end up
in <guilabel>Other</guilabel>. In particular, people with no family
name will appear under this category.</para>
</sect4>
</sect3>
</sect3>
</sect2>
<!-- ================ Main Window Sub-subsection -->
<sect3 id="family-view">
<sect2 id="family-view">
<title>Family View</title>
<para>Family View displays the family information of a currently
selected (or Active) person. Specifically, this view shows the
@@ -329,10 +333,10 @@
</textobject></mediaobject></screenshot></figure>
<!-- ==== End of Figure ==== -->
</sect3>
</sect2>
<!-- ================ Main Window Sub-subsection -->
<sect3 id="pedigree-view">
<sect2 id="pedigree-view">
<title>Pedigree View</title>
<!-- ==== Figure: Pedigree View ==== -->
@@ -430,10 +434,10 @@
reference.
</para>
</sect3>
</sect2>
<!-- ================ Main Window Sub-subsection -->
<sect3 id="sources-view">
<sect2 id="sources-view">
<title>Sources View</title>
<!-- ==== Figure: Sources View ==== -->
@@ -456,10 +460,10 @@
<guilabel>Author</guilabel> of the source. Any column can be
used for sorting the list. The usual rules apply: one click for
ascending order, another click for descending order.</para>
</sect3>
</sect2>
<!-- ================ Main Window Sub-subsection -->
<sect3 id="places-view">
<sect2 id="places-view">
<title>Places View</title>
<!-- ==== Figure: Places View ==== -->
@@ -481,10 +485,10 @@
<guilabel>City</guilabel>, <guilabel>County</guilabel>,
<guilabel>State</guilabel>, and <guilabel>Country</guilabel>. All of
these columns can be used for sorting by the usual sorting rules. </para>
</sect3>
</sect2>
<!-- ================ Main Window Sub-subsection -->
<sect3 id="media-view">
<sect2 id="media-view">
<title>Media View</title>
<!-- ==== Figure: Media View ==== -->
@@ -505,7 +509,7 @@
Path to the Media Object. The top part of the GRAMPS window shows
a preview (if available) and information about the Media
Object. </para>
</sect3>
</sect2>
</sect2>
</sect1> <!-- ================ End Main Window ===================== -->
</sect1>
</chapter>

126
doc/gramps-manual/C/preface.xml Normal file
View File

@@ -0,0 +1,126 @@
<preface id="gramps-preface">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2005 Alexander Roitman
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<title>Preface</title>
<para> &app; is a genealogical
application. &app; is an acronym for the
Genealogical Research and Analysis Management Programming System. To put
it shortly, it allows you to store, edit, and research genealogical data
using your computer. Its functionality is somewhat common to other
genealogical programs. However, &app; offers some unique features. </para>
<sect1 id="why-gramps">
<title>Why GRAMPS?</title>
<para> &app; was conceived under the concept
that most genealogy programs were designed to provide the researcher the
capability to input information related to a particular family tree.
Most of these programs have allowed for the arranging and storing of
information consistent with the GEDCOM standards. They usually provide
means for displaying descendant or ancestral relationships by means of
graphical displays, charts, or reports. These may be augmented with
pictures or other media to enhance the data. Most provide for inputting
data on unconnected individuals/families that may or may not have a
relationship to the primary surname being researched. Various other
enhancements may also be provided in the genealogical program that
allows for different degrees of importing and exporting data from other
programs and printing the data contained in the various reports. </para>
<para> &app;, on the other hand, attempts to
provide all of the common capabilities of these programs, but, more
importantly, to provide an additional capability of integration not common
to these programs. This is the ability to input any bits and pieces of
information directly into &app; and
rearrange/manipulate any/all data events in the entire data base (in any
order or sequence) to assist the user in doing research, analysis and
correlation with the potential of filling relationship gaps. In short, it
is a tool that provides a way to input all your research into one place and
do your analysis and correlation using the speed, power, and accuracy of
your computer instead of pencils and unmanageable reams of paper. </para>
</sect1>
<sect1 id="whats-new">
</sect1>
<sect1 id="typography">
<title>Typographical conventions</title>
<para>
In this book, we some words are marked with special typography:
<simplelist>
<member><application>Applications</application></member>
<member><command>Commands</command> you type at the command
line</member>
<member><filename>Filenames</filename></member>
<member><replaceable>Replaceable text</replaceable></member>
<member><guilabel>Labels</guilabel> for buttons and other
portions of the graphical interface</member>
<member> Menu selections look like this:
<menuchoice>
<guimenu>Menu</guimenu>
<guisubmenu>Submenu</guisubmenu>
<guimenuitem>Menu Item</guimenuitem>
</menuchoice>
</member>
<member><guibutton>Buttons</guibutton> you can
click</member>
<member><userinput>Anything you type
in</userinput></member>
</simplelist>
</para>
<para>
We also provide assorted bits of additional information in tips
and notes, as follows.
<tip id="example-tip">
<title>Tip</title>
<para>
Tips and bits of extra information will look like
this.
</para>
</tip>
<note id="example-note">
<title>Note</title>
<para>
Notes will look like this.
</para>
</note>
</para>
<para>
Finally, we have warnings, in cases where you should be careful:
<warning id="example-warning">
<title>Example Warning</title>
<para>
This is what a warning looks like. If there's a chance
you'll run into trouble, we'll warn you beforehand.
</para>
</warning>
</para>
</sect1>
</preface>

220
doc/gramps-manual/C/usage.xml
View File

@@ -1,23 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="gramps-usage">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2004 Alexander Roitman
Copyright (C) 2003-2005 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.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document 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
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- ================ Usage ================================ -->
<sect1 id="gramps-usage">
<title>Usage</title>
<para>As commonly encountered in everyday life, in
&app; there is usually more than one way to
@@ -25,7 +29,7 @@
be listed as appropriate.</para>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="new-db">
<sect1 id="new-db">
<title>Starting a New Database</title>
<para>To start a new database, choose <menuchoice><guimenu>File</guimenu>
<guimenuitem>New</guimenuitem></menuchoice>. You will then be
@@ -33,10 +37,10 @@
to specify the name under which the new database will be stored.
Choose an <replaceable>empty directory</replaceable> for your new
database (create one if necessary). </para>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="open-db">
<sect1 id="open-db">
<title>Opening a Database</title>
<para>To open a database, either choose <menuchoice>
<guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
@@ -63,10 +67,10 @@
possible copies
of media objects. Such a directory is created by &app; when you start
a new database and is updated each time the database is saved. </para>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="save-db">
<sect1 id="save-db">
<title>Saving a Database</title>
<para>To save changes made to your database, choose <menuchoice>
<guimenu>File</guimenu>
@@ -74,10 +78,10 @@
<guibutton>Save</guibutton> button on the Toolbar. The statusbar will then
display the <guilabel>Saving <replaceable>databasename</replaceable>...</guilabel>
message, and the progressbar will advance as the saving progresses.</para>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="import-data">
<sect1 id="import-data">
<title>Importing Data</title>
<para>Importing allows you to incorporate the data from other
databases into your currently open &app; database. Currently,
@@ -179,10 +183,10 @@
</itemizedlist>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="export-data">
<sect1 id="export-data">
<title>Exporting Data</title>
<para>Exporting allows you to share any portion of your &app; database
@@ -317,10 +321,10 @@
</itemizedlist>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="gramps-edit-quick">
<sect1 id="gramps-edit-quick">
<title>Editing Data: Quick Start</title>
<para> Editing any portion of data allows you to amend and/or
modify information stored in the database. The available editing
@@ -338,7 +342,7 @@
</para>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-add-pers">
<sect2 id="gramps-add-pers">
<title>To Add a Person</title>
<para> To add a person to the database, switch to the People View
(<xref linkend="side-nofilt-fig"/>) and then click the
@@ -355,10 +359,10 @@
and select <guilabel>Add...</guilabel> or <guilabel>Edit...</guilabel>
from the invoked context menu.
</para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-spec-rel">
<sect2 id="gramps-spec-rel">
<title>To Specify a Relationship</title>
<para>To specify a relationship, first switch to the Family View
(<xref linkend="family-fig"/>). Then click one of the two top buttons on
@@ -387,10 +391,10 @@
menu available upon right-clicking into the spouse box. Also, most of the
above function are available from the items of this context menu.
</para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-spec-par">
<sect2 id="gramps-spec-par">
<title>To Specify Parents</title>
<para>To specify parents of an active person, first switch to the
Family View (<xref linkend="family-fig"/>). Then click the
@@ -415,10 +419,10 @@
the corresponding parents' box and double-click. All these functions can
also be performed by right-clicking on the parents' box and selecting
an appropriate item from the context menu. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-spec-ch">
<sect2 id="gramps-spec-ch">
<title>To Specify Children</title>
<para>To specify children of an active person, switch to the
Family View (<xref linkend="family-fig"/>) and then click either the
@@ -442,10 +446,10 @@
into the children box. Also, most of the above function are available from
the items of this context menu.
</para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-add-img">
<sect2 id="gramps-add-img">
<title>To Add Images</title>
<para>You can add images (as well as other media objects) to
individual people, events, sources, places, as well as images
@@ -498,10 +502,10 @@
delete it from Media View by first selecting it and then
clicking the <guibutton>Remove</guibutton> icon on the toolbar. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-edit-src-plc">
<sect2 id="gramps-edit-src-plc">
<title>To Edit Sources and Places</title>
<para> To add a source or a place to the database, switch to
@@ -519,11 +523,11 @@
may double-click on the entry to edit it.
</para>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="gramps-edit-complete">
<sect1 id="gramps-edit-complete">
<title>Editing Data: Complete Description</title>
<para> This section provides a complete description of all editing
options for all pieces of data in the &app; database. It refers mainly
@@ -533,7 +537,7 @@
the <xref linkend="append-keybind"/>.</para>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-pers">
<sect2 id="adv-pers">
<title>Edit Personal Information</title>
<para> Editing of personal data can be performed in the
following ways: </para>
@@ -933,10 +937,10 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-dates">
<sect2 id="adv-dates">
<title>Edit Dates</title>
<para> Anywhere in &app; where the date
is entered or edited, the following rules apply:</para>
@@ -999,10 +1003,10 @@
</itemizedlist>
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-rel">
<sect2 id="adv-rel">
<title>Edit Relationship Data</title>
<para> Editing of relationship data is performed in the following
<guilabel>Marriage/Relationship Editor</guilabel> dialog which appears
@@ -1180,10 +1184,10 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-src">
<sect2 id="adv-src">
<title>Edit Source Data</title>
<para> To edit source data, switch to the Sources View and select the
desired entry in the list of sources. Double-click on that entry or
@@ -1290,11 +1294,11 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-plc">
<sect2 id="adv-plc">
<title>Edit Place Data</title>
<para> To edit place data, switch to the Places View and select the
desired entry in the list of places. Double-click on that entry or
@@ -1450,10 +1454,10 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-media">
<sect2 id="adv-media">
<title>Edit Media Data</title>
<para> To edit media data, switch to the Media View and select the
desired entry in the list of sources. Double-click on that entry or
@@ -1561,10 +1565,10 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-ev">
<sect2 id="adv-ev">
<title>Edit Events</title>
<para> Events are edited through the following <guilabel>Event
Editor</guilabel> dialog: </para>
@@ -1663,10 +1667,10 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-si">
<sect2 id="adv-si">
<title>Edit Source Information</title>
<para> When adding source references to events, places, etc.,
the following dialog appears: </para>
@@ -1701,10 +1705,10 @@
The rest of the details can be typed in the appropriate text entry
fields. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-an">
<sect2 id="adv-an">
<title>Edit Alternate Names</title>
<para> Alternate names are edited through the following
<guilabel>Alternate Names Editor</guilabel> dialog: </para>
@@ -1790,10 +1794,10 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-at">
<sect2 id="adv-at">
<title>Edit Attributes</title>
<para> Attributes are edited through the following
<guilabel>Attribute Editor</guilabel> dialog: </para>
@@ -1877,10 +1881,10 @@
</para>
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-ad">
<sect2 id="adv-ad">
<title>Edit Addresses</title>
<para> Addresses are edited through the following
<guilabel>Address Editor</guilabel> dialog: </para>
@@ -1965,10 +1969,10 @@
</listitem></varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-wit">
<sect2 id="adv-wit">
<title>Edit Witnesses</title>
<para> Witnesses are edited through the following
<guilabel>Witness Editor</guilabel> dialog: </para>
@@ -2030,10 +2034,10 @@
existing comments simply edit the text in the text area.
</para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-merge">
<sect2 id="adv-merge">
<title>Merge People</title>
<para> Sometime two people entries in the database turn out to be
describing the same person. When this happens, merging people is
@@ -2052,10 +2056,10 @@
data if you so choose. If you would like to continue editing data of
a newly merged person, click the <guibutton>Merge and edit</guibutton>
button. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="adv-merge-places">
<sect2 id="adv-merge-places">
<title>Merge Places</title>
<para> Sometime two place entries in the database turn out to be
describing the same place. When this happens, merging places is
@@ -2073,12 +2077,12 @@
the new (merged) place. Alternatively, you may type in other data
for the new place, if you click <guilabel>Other</guilabel> radio
button.</para>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="gramps-nav">
<sect1 id="gramps-nav">
<title>Navigation</title>
<para> As long as any database is open, &app; is focused on a
single person usually referred to as an Active person. This
@@ -2092,7 +2096,7 @@
depending what you are doing in &app; at the moment. </para>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-people">
<sect2 id="gramps-nav-people">
<title>Using the People View </title>
<para> The most intuitive way to select an active person is
to use the People View (see <xref linkend="people-view"/>).
@@ -2100,10 +2104,10 @@
name of the desired person from the list by clicking that list
entry. The person you have selected becomes active. The statusbar
updates to reflect the change of the active person. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-family">
<sect2 id="gramps-nav-family">
<title>Using the Family View</title>
<para> When in the Family View (see <xref linkend="family-view"/>),
you can easily navigate between the members of the displayed family
@@ -2147,10 +2151,10 @@
navigation options. The detailed reference to the keybindings
is found in the <xref linkend="append-keybind"/>.</para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-pedigree">
<sect2 id="gramps-nav-pedigree">
<title>Using the Pedigree View</title>
<para> The Pedigree View (see <xref linkend="pedigree-view"/>) also
allows you to move along the family tree.
@@ -2186,10 +2190,10 @@
boxes for father and mother. </para></listitem>
</itemizedlist>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-default">
<sect2 id="gramps-nav-default">
<title>Setting the Home Person</title>
<para> One and only one person in the database can be selected as the
Home person. Once the Home person is selected, moving to that
@@ -2208,11 +2212,11 @@
right click.
</para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-history">
<sect2 id="gramps-nav-history">
<title>Using history-based tools</title>
<para> &app; also features a powerful set of history-based navigation
tools. These tools are similar to those commonly used in web browsers.
@@ -2227,10 +2231,10 @@
popup menu with corresponding portion of the history. Select any item
from the menu to jump directly to it. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-bookmk">
<sect2 id="gramps-nav-bookmk">
<title>Bookmarking People</title>
<para> Similar to setting the Home person, you can bookmark other
people from the database to simplify further navigation. To bookmark
@@ -2259,10 +2263,10 @@
</textobject></mediaobject></screenshot></figure>
<!-- ==== End of Figure ==== -->
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-find-people">
<sect2 id="gramps-nav-find-people">
<title>Finding People</title>
<para> To find a person in a database, choose
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice>
@@ -2273,42 +2277,42 @@
<para> If the search is successful, the found person becomes an active
person and the display adjusts according to the new active person and the
current view. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-find-sources">
<sect2 id="gramps-nav-find-sources">
<title>Finding Sources</title>
<para> To find a source in a database, choose
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice>
when in the Sources View. This opens a <guilabel>Find Source</guilabel>
dialog which can be used for searching forward and backward. If the
search is successful, the found source becomes highlighted. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-find-places">
<sect2 id="gramps-nav-find-places">
<title>Finding Places</title>
<para> To find a place in a database, choose
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice>
when in the Places View. This opens a <guilabel>Find Place</guilabel>
dialog which can be used for searching forward and backward. If the
search is successful, the found place becomes highlighted. </para>
</sect3>
</sect2>
<!-- ================ Usage Sub-subsection ================ -->
<sect3 id="gramps-nav-find-media">
<sect2 id="gramps-nav-find-media">
<title>Finding Media Objects</title>
<para> To find a media object in a database, choose
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem></menuchoice>
when in the Media View. This opens a <guilabel>Find Media Objects</guilabel>
dialog which can be used for searching forward and backward. If the
search is successful, the found media object becomes highlighted. </para>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="gen-reports">
<sect1 id="gen-reports">
<title>Generating Reports</title>
<para> Reports are the most common form of the output produced by
genealogical research. The majority of genealogical software puts a lot
@@ -2335,7 +2339,7 @@
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="rep-graph">
<sect2 id="rep-graph">
<title>Graphical Reports</title>
<para> Graphical reports represent information in forms of charts
and graphs. Most of the options are common among graphical reports,
@@ -2401,10 +2405,10 @@
Applications</replaceable></guimenuitem></menuchoice> dialog).
</para>
</sect3>
</sect2>
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="rep-text">
<sect2 id="rep-text">
<title>Text Reports</title>
<para> Text reports represent the desired information as formatted
text. Most of the options are common among text reports,
@@ -2515,10 +2519,10 @@
Applications</replaceable></guimenuitem></menuchoice> dialog).
</para>
</sect3>
</sect2>
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="rep-books">
<sect2 id="rep-books">
<title>Books</title>
<para> Currently, the only available report under this category
is the Book Report. </para>
@@ -2607,10 +2611,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="rep-view">
<sect2 id="rep-view">
<title>View Reports</title>
<para> View reports represent overall summaries of the database
information available immediately for on-screen viewing.
@@ -2630,10 +2634,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="rep-web">
<sect2 id="rep-web">
<title>Web Page</title>
<para> This report generates web pages, either for a selected
@@ -2650,12 +2654,12 @@
the optional &app; ID, create a GENDEX index, and specify the
extension of the resulting files. </para>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- ================ Usage Subsection ================================ -->
<sect2 id="gramps-tools">
<sect1 id="gramps-tools">
<title>Running Tools</title>
<para> &app; tools allow you to perform various types of analyses
of your genealogical data. Typically, the tools do not produce
@@ -2676,7 +2680,7 @@
<guibutton>Tools</guibutton> icon on the toolbar. </para>
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="tools-ae">
<sect2 id="tools-ae">
<title>Analysis and Exploration</title>
<para> This section contains tools which analyze and explore the
database, but do not alter it. The following analysis and exploration
@@ -2700,10 +2704,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="tools-db">
<sect2 id="tools-db">
<title>Database Processing</title>
<para> This section contains tools which may modify your database.
The modifications will only be performed upon your explicit consent.
@@ -2769,10 +2773,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Usage Sub-subsection ================ -->
<sect3 id="tools-util">
<sect2 id="tools-util">
<title>Utilities</title>
<para> </para>
@@ -2893,8 +2897,8 @@
</variablelist>
</sect3>
</sect2>
</sect2>
</sect1>
</sect1> <!-- ================ End Usage ============== -->
</chapter>