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 79eb2c6897
commit 3fd0b1406d
16 changed files with 609 additions and 800 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

360
gramps2/COPYING-DOCS
View File

@ -1,355 +1,13 @@
GNU Free Documentation License The User Manual for Gramps is distributed under the terms of
Version 1.1, March 2000 GNU General Public License (GPL). Yes, it is under GNU GPL and
*NOT* under GNU FDL.
Copyright (C) 2000 Free Software Foundation, Inc. As such, this manual meets citeria of Debian Free Software Guidelines
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA (DFSG) and can be distributed through Debian main (as opposed to non-free).
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Please see file named COPYING for exact terms of the license.
0. PREAMBLE Alex Roitman
February 15, 2005
The purpose of this License is to make a manual, textbook, or other $Id$
written document "free" in the sense of freedom: to assure everyone
the effective freedom to copy and redistribute it, with or without
modifying it, either commercially or noncommercially. Secondarily,
this License preserves for the author and publisher a way to get
credit for their work, while not being considered responsible for
modifications made by others.
This License is a kind of "copyleft", which means that derivative
works of the document must themselves be free in the same sense. It
complements the GNU General Public License, which is a copyleft
license designed for free software.
We have designed this License in order to use it for manuals for free
software, because free software needs free documentation: a free
program should come with manuals providing the same freedoms that the
software does. But this License is not limited to software manuals;
it can be used for any textual work, regardless of subject matter or
whether it is published as a printed book. We recommend this License
principally for works whose purpose is instruction or reference.
1. APPLICABILITY AND DEFINITIONS
This License applies to any manual or other work that contains a
notice placed by the copyright holder saying it can be distributed
under the terms of this License. The "Document", below, refers to any
such manual or work. Any member of the public is a licensee, and is
addressed as "you".
A "Modified Version" of the Document means any work containing the
Document or a portion of it, either copied verbatim, or with
modifications and/or translated into another language.
A "Secondary Section" is a named appendix or a front-matter section of
the Document that deals exclusively with the relationship of the
publishers or authors of the Document to the Document's overall subject
(or to related matters) and contains nothing that could fall directly
within that overall subject. (For example, if the Document is in part a
textbook of mathematics, a Secondary Section may not explain any
mathematics.) The relationship could be a matter of historical
connection with the subject or with related matters, or of legal,
commercial, philosophical, ethical or political position regarding
them.
The "Invariant Sections" are certain Secondary Sections whose titles
are designated, as being those of Invariant Sections, in the notice
that says that the Document is released under this License.
The "Cover Texts" are certain short passages of text that are listed,
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
the Document is released under this License.
A "Transparent" copy of the Document means a machine-readable copy,
represented in a format whose specification is available to the
general public, whose contents can be viewed and edited directly and
straightforwardly with generic text editors or (for images composed of
pixels) generic paint programs or (for drawings) some widely available
drawing editor, and that is suitable for input to text formatters or
for automatic translation to a variety of formats suitable for input
to text formatters. A copy made in an otherwise Transparent file
format whose markup has been designed to thwart or discourage
subsequent modification by readers is not Transparent. A copy that is
not "Transparent" is called "Opaque".
Examples of suitable formats for Transparent copies include plain
ASCII without markup, Texinfo input format, LaTeX input format, SGML
or XML using a publicly available DTD, and standard-conforming simple
HTML designed for human modification. Opaque formats include
PostScript, PDF, proprietary formats that can be read and edited only
by proprietary word processors, SGML or XML for which the DTD and/or
processing tools are not generally available, and the
machine-generated HTML produced by some word processors for output
purposes only.
The "Title Page" means, for a printed book, the title page itself,
plus such following pages as are needed to hold, legibly, the material
this License requires to appear in the title page. For works in
formats which do not have any title page as such, "Title Page" means
the text near the most prominent appearance of the work's title,
preceding the beginning of the body of the text.
2. VERBATIM COPYING
You may copy and distribute the Document in any medium, either
commercially or noncommercially, provided that this License, the
copyright notices, and the license notice saying this License applies
to the Document are reproduced in all copies, and that you add no other
conditions whatsoever to those of this License. You may not use
technical measures to obstruct or control the reading or further
copying of the copies you make or distribute. However, you may accept
compensation in exchange for copies. If you distribute a large enough
number of copies you must also follow the conditions in section 3.
You may also lend copies, under the same conditions stated above, and
you may publicly display copies.
3. COPYING IN QUANTITY
If you publish printed copies of the Document numbering more than 100,
and the Document's license notice requires Cover Texts, you must enclose
the copies in covers that carry, clearly and legibly, all these Cover
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
the back cover. Both covers must also clearly and legibly identify
you as the publisher of these copies. The front cover must present
the full title with all words of the title equally prominent and
visible. You may add other material on the covers in addition.
Copying with changes limited to the covers, as long as they preserve
the title of the Document and satisfy these conditions, can be treated
as verbatim copying in other respects.
If the required texts for either cover are too voluminous to fit
legibly, you should put the first ones listed (as many as fit
reasonably) on the actual cover, and continue the rest onto adjacent
pages.
If you publish or distribute Opaque copies of the Document numbering
more than 100, you must either include a machine-readable Transparent
copy along with each Opaque copy, or state in or with each Opaque copy
a publicly-accessible computer-network location containing a complete
Transparent copy of the Document, free of added material, which the
general network-using public has access to download anonymously at no
charge using public-standard network protocols. If you use the latter
option, you must take reasonably prudent steps, when you begin
distribution of Opaque copies in quantity, to ensure that this
Transparent copy will remain thus accessible at the stated location
until at least one year after the last time you distribute an Opaque
copy (directly or through your agents or retailers) of that edition to
the public.
It is requested, but not required, that you contact the authors of the
Document well before redistributing any large number of copies, to give
them a chance to provide you with an updated version of the Document.
4. MODIFICATIONS
You may copy and distribute a Modified Version of the Document under
the conditions of sections 2 and 3 above, provided that you release
the Modified Version under precisely this License, with the Modified
Version filling the role of the Document, thus licensing distribution
and modification of the Modified Version to whoever possesses a copy
of it. In addition, you must do these things in the Modified Version:
A. Use in the Title Page (and on the covers, if any) a title distinct
from that of the Document, and from those of previous versions
(which should, if there were any, be listed in the History section
of the Document). You may use the same title as a previous version
if the original publisher of that version gives permission.
B. List on the Title Page, as authors, one or more persons or entities
responsible for authorship of the modifications in the Modified
Version, together with at least five of the principal authors of the
Document (all of its principal authors, if it has less than five).
C. State on the Title page the name of the publisher of the
Modified Version, as the publisher.
D. Preserve all the copyright notices of the Document.
E. Add an appropriate copyright notice for your modifications
adjacent to the other copyright notices.
F. Include, immediately after the copyright notices, a license notice
giving the public permission to use the Modified Version under the
terms of this License, in the form shown in the Addendum below.
G. Preserve in that license notice the full lists of Invariant Sections
and required Cover Texts given in the Document's license notice.
H. Include an unaltered copy of this License.
I. Preserve the section entitled "History", and its title, and add to
it an item stating at least the title, year, new authors, and
publisher of the Modified Version as given on the Title Page. If
there is no section entitled "History" in the Document, create one
stating the title, year, authors, and publisher of the Document as
given on its Title Page, then add an item describing the Modified
Version as stated in the previous sentence.
J. Preserve the network location, if any, given in the Document for
public access to a Transparent copy of the Document, and likewise
the network locations given in the Document for previous versions
it was based on. These may be placed in the "History" section.
You may omit a network location for a work that was published at
least four years before the Document itself, or if the original
publisher of the version it refers to gives permission.
K. In any section entitled "Acknowledgements" or "Dedications",
preserve the section's title, and preserve in the section all the
substance and tone of each of the contributor acknowledgements
and/or dedications given therein.
L. Preserve all the Invariant Sections of the Document,
unaltered in their text and in their titles. Section numbers
or the equivalent are not considered part of the section titles.
M. Delete any section entitled "Endorsements". Such a section
may not be included in the Modified Version.
N. Do not retitle any existing section as "Endorsements"
or to conflict in title with any Invariant Section.
If the Modified Version includes new front-matter sections or
appendices that qualify as Secondary Sections and contain no material
copied from the Document, you may at your option designate some or all
of these sections as invariant. To do this, add their titles to the
list of Invariant Sections in the Modified Version's license notice.
These titles must be distinct from any other section titles.
You may add a section entitled "Endorsements", provided it contains
nothing but endorsements of your Modified Version by various
parties--for example, statements of peer review or that the text has
been approved by an organization as the authoritative definition of a
standard.
You may add a passage of up to five words as a Front-Cover Text, and a
passage of up to 25 words as a Back-Cover Text, to the end of the list
of Cover Texts in the Modified Version. Only one passage of
Front-Cover Text and one of Back-Cover Text may be added by (or
through arrangements made by) any one entity. If the Document already
includes a cover text for the same cover, previously added by you or
by arrangement made by the same entity you are acting on behalf of,
you may not add another; but you may replace the old one, on explicit
permission from the previous publisher that added the old one.
The author(s) and publisher(s) of the Document do not by this License
give permission to use their names for publicity for or to assert or
imply endorsement of any Modified Version.
5. COMBINING DOCUMENTS
You may combine the Document with other documents released under this
License, under the terms defined in section 4 above for modified
versions, provided that you include in the combination all of the
Invariant Sections of all of the original documents, unmodified, and
list them all as Invariant Sections of your combined work in its
license notice.
The combined work need only contain one copy of this License, and
multiple identical Invariant Sections may be replaced with a single
copy. If there are multiple Invariant Sections with the same name but
different contents, make the title of each such section unique by
adding at the end of it, in parentheses, the name of the original
author or publisher of that section if known, or else a unique number.
Make the same adjustment to the section titles in the list of
Invariant Sections in the license notice of the combined work.
In the combination, you must combine any sections entitled "History"
in the various original documents, forming one section entitled
"History"; likewise combine any sections entitled "Acknowledgements",
and any sections entitled "Dedications". You must delete all sections
entitled "Endorsements."
6. COLLECTIONS OF DOCUMENTS
You may make a collection consisting of the Document and other documents
released under this License, and replace the individual copies of this
License in the various documents with a single copy that is included in
the collection, provided that you follow the rules of this License for
verbatim copying of each of the documents in all other respects.
You may extract a single document from such a collection, and distribute
it individually under this License, provided you insert a copy of this
License into the extracted document, and follow this License in all
other respects regarding verbatim copying of that document.
7. AGGREGATION WITH INDEPENDENT WORKS
A compilation of the Document or its derivatives with other separate
and independent documents or works, in or on a volume of a storage or
distribution medium, does not as a whole count as a Modified Version
of the Document, provided no compilation copyright is claimed for the
compilation. Such a compilation is called an "aggregate", and this
License does not apply to the other self-contained works thus compiled
with the Document, on account of their being thus compiled, if they
are not themselves derivative works of the Document.
If the Cover Text requirement of section 3 is applicable to these
copies of the Document, then if the Document is less than one quarter
of the entire aggregate, the Document's Cover Texts may be placed on
covers that surround only the Document within the aggregate.
Otherwise they must appear on covers around the whole aggregate.
8. TRANSLATION
Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section 4.
Replacing Invariant Sections with translations requires special
permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the
original versions of these Invariant Sections. You may include a
translation of this License provided that you also include the
original English version of this License. In case of a disagreement
between the translation and the original English version of this
License, the original English version will prevail.
9. TERMINATION
You may not copy, modify, sublicense, or distribute the Document except
as expressly provided for under this License. Any other attempt to
copy, modify, sublicense or distribute the Document is void, and will
automatically terminate your rights under this License. However,
parties who have received copies, or rights, from you under this
License will not have their licenses terminated so long as such
parties remain in full compliance.
10. FUTURE REVISIONS OF THIS LICENSE
The Free Software Foundation may publish new, revised versions
of the GNU Free Documentation License from time to time. Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns. See
http://www.gnu.org/copyleft/.
Each version of the License is given a distinguishing version number.
If the Document specifies that a particular numbered version of this
License "or any later version" applies to it, you have the option of
following the terms and conditions either of that specified version or
of any later version that has been published (not as a draft) by the
Free Software Foundation. If the Document does not specify a version
number of this License, you may choose any version ever published (not
as a draft) by the Free Software Foundation.
ADDENDUM: How to use this License for your documents
To use this License in a document you have written, include a copy of
the License in the document and put the following copyright and
license notices just after the title page:
Copyright (c) YEAR YOUR NAME.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation;
with the Invariant Sections being LIST THEIR TITLES, with the
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
A copy of the license is included in the section entitled "GNU
Free Documentation License".
If you have no Invariant Sections, write "with no Invariant Sections"
instead of saying which ones are invariant. If you have no
Front-Cover Texts, write "no Front-Cover Texts" instead of
"Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of
free software license, such as the GNU General Public License,
to permit their use in free software.

16
gramps2/ChangeLog
View File

@ -2,6 +2,22 @@
* src/plugins/DetAncestralReport.py: Typos. * src/plugins/DetAncestralReport.py: Typos.
* src/plugins/DetDescendantReport.py: Typos. * src/plugins/DetDescendantReport.py: Typos.
* doc/gramps-manual/C/authors.xml: Add file.
* 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.
2005-02-12 Alex Roitman <shura@alex.neuro.umn.edu> 2005-02-12 Alex Roitman <shura@alex.neuro.umn.edu>
* src/ReadGrdb.py: Check for overlapping handles prior to * src/ReadGrdb.py: Check for overlapping handles prior to
modifying data. modifying data.

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

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

44
gramps2/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
gramps2/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
gramps2/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 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $Id$ -->
<!-- =============== Appendices Subsection ================ --> <!-- =============== Appendices Subsection ================ -->
<sect2 id="append-cmdline">
<title>Command line reference</title> <title>Command line reference</title>
<para>This appendix provides the reference to the command line <para>This appendix provides the reference to the command line
capabilities available when launching &app; from the terminal. </para> capabilities available when launching &app; from the terminal. </para>
@ -37,7 +43,7 @@
</para> </para>
<sect3 id="cmdline-options"> <sect1 id="cmdline-options">
<title>Available options</title> <title>Available options</title>
<para>Here is the list of the command line options in &app;: <para>Here is the list of the command line options in &app;:
@ -159,10 +165,10 @@
</variablelist> </variablelist>
</sect3> </sect1>
<sect3 id="cmdline-operation"> <sect1 id="cmdline-operation">
<title>Operation</title> <title>Operation</title>
<para>The order of <command>-i</command>, <command>-o</command>, <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 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> 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> <title>Examples</title>
<para>To import four databases (whose formats can be determined from <para>To import four databases (whose formats can be determined from
their names) and then check the resulting database for errors, one may 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>Finally, to start normal interactive session type:</para>
<para> <command>gramps </command></para> <para> <command>gramps </command></para>
</sect3> </sect1>
</sect2> </appendix>

85
gramps2/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 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $Id$ -->
<!-- ================ Customization ================================ -->
<sect1 id="gramps-prefs">
<title>Settings</title> <title>Settings</title>
<para>To configure &app;, choose <para>To configure &app;, choose
<menuchoice><guimenu>Edit</guimenu> <menuchoice><guimenu>Edit</guimenu>
@ -33,13 +36,13 @@
</itemizedlist> </itemizedlist>
<!-- =============== Customization Subsection ================ --> <!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-usage"> <sect1 id="gramps-prefs-usage">
<title>Usage</title> <title>Usage</title>
<para> This category contains preferences relevant to the <para> This category contains preferences relevant to the
general usage of &app;. It has the following subcategories:</para> general usage of &app;. It has the following subcategories:</para>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-find"> <sect2 id="prefs-usage-find">
<title>Find</title> <title>Find</title>
<variablelist> <variablelist>
@ -55,10 +58,10 @@
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-report"> <sect2 id="prefs-usage-report">
<title>Report Preferences</title> <title>Report Preferences</title>
<variablelist> <variablelist>
@ -95,10 +98,10 @@
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-res"> <sect2 id="prefs-usage-res">
<title>Researcher Information</title> <title>Researcher Information</title>
<variablelist> <variablelist>
@ -115,10 +118,10 @@
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-guess"> <sect2 id="prefs-usage-guess">
<title>Data Guessing</title> <title>Data Guessing</title>
<variablelist> <variablelist>
@ -144,19 +147,19 @@
</variablelist> </variablelist>
</sect3> </sect2>
</sect2> </sect1>
<!-- =============== Customization Subsection ================ --> <!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-display"> <sect1 id="gramps-prefs-display">
<title>Display</title> <title>Display</title>
<para> This category contains preferences relevant to <para> This category contains preferences relevant to
displaying database records and controls in &app;. displaying database records and controls in &app;.
It has the following subcategories:</para> It has the following subcategories:</para>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-gen"> <sect2 id="prefs-display-gen">
<title>General</title> <title>General</title>
<variablelist> <variablelist>
@ -188,10 +191,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-date"> <sect2 id="prefs-display-date">
<title>Dates and Calendar</title> <title>Dates and Calendar</title>
<variablelist> <variablelist>
@ -223,10 +226,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-bars"> <sect2 id="prefs-display-bars">
<title>Toolbar and Statusbar</title> <title>Toolbar and Statusbar</title>
<variablelist> <variablelist>
@ -244,18 +247,18 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect2>
</sect2> </sect1>
<!-- =============== Customization Subsection ================ --> <!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-db"> <sect1 id="gramps-prefs-db">
<title>Database</title> <title>Database</title>
<para> This category contains preferences relevant to the <para> This category contains preferences relevant to the
database itself. It has the following subcategories: </para> database itself. It has the following subcategories: </para>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-gen"> <sect2 id="prefs-db-gen">
<title>General</title> <title>General</title>
<variablelist> <variablelist>
@ -288,10 +291,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-media"> <sect2 id="prefs-db-media">
<title>Media Objects</title> <title>Media Objects</title>
<para>Before describing preferences for media objects, let us <para>Before describing preferences for media objects, let us
@ -346,10 +349,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-id"> <sect2 id="prefs-db-id">
<title>GRAMPS internal IDs</title> <title>GRAMPS internal IDs</title>
<variablelist> <variablelist>
@ -368,10 +371,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect2>
<!-- =============== Customization Sub-subsection ================ --> <!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-rcs"> <sect2 id="prefs-db-rcs">
<title>Revision Control</title> <title>Revision Control</title>
<variablelist> <variablelist>
@ -391,8 +394,8 @@
</variablelist> </variablelist>
</sect3> </sect2>
</sect2> </sect1>
</sect1> <!-- ================ End Customization ================== --> </chapter>

29
gramps2/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 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="faq">
<title>Frequently Asked Questions</title> <title>Frequently Asked Questions</title>
<para>This appendix contains the list of questions that frequently come <para>This appendix contains the list of questions that frequently come
up in mailing list discussions and forums. This list is by no means up in mailing list discussions and forums. This list is by no means
@ -380,4 +385,4 @@ potential of your great idea :-)
</variablelist> </variablelist>
</sect2> </appendix>

56
gramps2/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 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="append-filtref">
<title>Filter rules reference</title> <title>Filter rules reference</title>
<para>This appendix lists of all the filter rules currently defined <para>This appendix lists of all the filter rules currently defined
in &app;. Each of these rules is available for use when creating custom in &app;. Each of these rules is available for use when creating custom
@ -25,7 +29,7 @@
</para> </para>
<!-- =============== Appendices Sub-subsection ================ --> <!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-general"> <sect1 id="filtref-general">
<title>General filters</title> <title>General filters</title>
<para>This category includes the following most general rules:</para> <para>This category includes the following most general rules:</para>
@ -85,10 +89,10 @@
</variablelist> </variablelist>
</sect3> </sect1>
<!-- =============== Appendices Sub-subsection ================ --> <!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-event"> <sect1 id="filtref-event">
<title>Event filters</title> <title>Event filters</title>
<para>This category includes the following rules that match people <para>This category includes the following rules that match people
based on their recorded events:</para> based on their recorded events:</para>
@ -160,10 +164,10 @@
</variablelist> </variablelist>
</sect3> </sect1>
<!-- =============== Appendices Sub-subsection ================ --> <!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-family"> <sect1 id="filtref-family">
<title>Family filters</title> <title>Family filters</title>
<para>This category includes the following rules that match people <para>This category includes the following rules that match people
based on their family relationships:</para> based on their family relationships:</para>
@ -204,10 +208,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect1>
<!-- =============== Appendices Sub-subsection ================ --> <!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-ancestral"> <sect1 id="filtref-ancestral">
<title>Ancestral filters</title> <title>Ancestral filters</title>
<para>This category includes the following rules that match people <para>This category includes the following rules that match people
based on their ancestral relations to other people:</para> based on their ancestral relations to other people:</para>
@ -270,10 +274,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect1>
<!-- =============== Appendices Sub-subsection ================ --> <!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-descendant"> <sect1 id="filtref-descendant">
<title>Descendant filters</title> <title>Descendant filters</title>
<para>This category includes the following rules that match people <para>This category includes the following rules that match people
based on their descendant relations to other people:</para> based on their descendant relations to other people:</para>
@ -330,10 +334,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect1>
<!-- =============== Appendices Sub-subsection ================ --> <!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-relat"> <sect1 id="filtref-relat">
<title>Relationship filters</title> <title>Relationship filters</title>
<para>This category includes the following rules that match people <para>This category includes the following rules that match people
based on their mutual relationship:</para> based on their mutual relationship:</para>
@ -356,10 +360,10 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect1>
<!-- =============== Appendices Sub-subsection ================ --> <!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="filtref-misc"> <sect1 id="filtref-misc">
<title>Miscellaneous filters</title> <title>Miscellaneous filters</title>
<para>This category includes the following rules which do not <para>This category includes the following rules which do not
naturally fit into any of the above categories:</para> naturally fit into any of the above categories:</para>
@ -389,6 +393,6 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect3> </sect1>
</sect2> </appendix>

73
gramps2/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 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $Id$ -->
<!-- =========== Getting Started ============================== -->
<sect1 id="gramps-getting-started">
<title>Getting Started</title> <title>Getting Started</title>
<!-- ================ Getting Started Subsection ====== --> <!-- ================ Getting Started Subsection ====== -->
<sect2 id="gramps-start"> <sect1 id="gramps-start">
<title>To Start GRAMPS</title> <title>To Start GRAMPS</title>
<para>You can start &app; in the following ways:</para> <para>You can start &app; in the following ways:</para>
<variablelist> <variablelist>
@ -50,10 +54,10 @@
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect1>
<!-- ================ Getting Started Subsection ==== --> <!-- ================ Getting Started Subsection ==== -->
<sect2 id="run-1st-time"> <sect1 id="run-1st-time">
<title>Running GRAMPS for the first time</title> <title>Running GRAMPS for the first time</title>
<para> <para>
The first time you run the program, GRAMPS will display its The first time you run the program, GRAMPS will display its
@ -87,10 +91,10 @@
<guilabel>Usage</guilabel> category. <guilabel>Usage</guilabel> category.
</para> </para>
</sect2> </sect1>
<!-- ================ Getting Started Subsection --> <!-- ================ Getting Started Subsection -->
<sect2 id="choose-db-start"> <sect1 id="choose-db-start">
<title>Choosing a database on startup</title> <title>Choosing a database on startup</title>
<para>If &app; is started without any <para>If &app; is started without any
database to open, the following window will appear prompting you to 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 created by &app; when you start a new database and is updated each time
the database is saved. </para> 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 ==== --> <!-- ================ Getting Started Subsection ==== -->
<sect2 id="get-help"> <sect1 id="get-help">
<title>Obtaining Help</title> <title>Obtaining Help</title>
<para> At any time, the following items are available for immediate aid <para> At any time, the following items are available for immediate aid
from the <menuchoice><guimenu>Help</guimenu></menuchoice> menu: </para> from the <menuchoice><guimenu>Help</guimenu></menuchoice> menu: </para>
@ -205,6 +180,6 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect1>
</sect1> <!-- ================ End Getting Started ======================== --> </chapter>

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

@ -3,22 +3,36 @@
<!-- <!--
User Manual for Gramps - a GTK+/GNOME based genealogy program 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $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" [ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml"> <!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 getstart SYSTEM "getstart.xml">
<!ENTITY mainwin SYSTEM "mainwin.xml"> <!ENTITY mainwin SYSTEM "mainwin.xml">
<!ENTITY usage SYSTEM "usage.xml"> <!ENTITY usage SYSTEM "usage.xml">
@ -27,10 +41,9 @@
<!ENTITY keybind SYSTEM "keybind.xml"> <!ENTITY keybind SYSTEM "keybind.xml">
<!ENTITY filtref SYSTEM "filtref.xml"> <!ENTITY filtref SYSTEM "filtref.xml">
<!ENTITY cmdline SYSTEM "cmdline.xml"> <!ENTITY cmdline SYSTEM "cmdline.xml">
<!ENTITY appversion "1.0.0"> <!ENTITY bugs SYSTEM "bugs.xml">
<!ENTITY manrevision "2.5"> <!ENTITY authors SYSTEM "authors.xml">
<!ENTITY date "February 2004">
<!ENTITY app "<application>GRAMPS</application>">
<!-- Information about the entities <!-- Information about the entities
The legal.xml file contains legal information, there is no need to edit the file. The legal.xml file contains legal information, there is no need to edit the file.
Use the appversion entity to specify the version of the application. Use the appversion entity to specify the version of the application.
@ -46,14 +59,14 @@
Template last modified Apr 11, 2002 Template last modified Apr 11, 2002
--> -->
<!-- =============Document Header ============================= --> <!-- =============Document Header ============================= -->
<article id="index" lang="en"> <book id="index" lang="en">
<!-- please do not change the id; for translations, change lang to --> <!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code --> <!-- appropriate code -->
<articleinfo> <bookinfo>
<title>GRAMPS Manual V&manrevision;</title> <title>GRAMPS Manual V&manrevision;</title>
<copyright> <year>2001</year> <holder>Donald N. Allingham</holder> </copyright> <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: <!-- translators: uncomment this:
@ -69,9 +82,8 @@
<publisher> <publishername> GRAMPS Project </publishername> </publisher> <publisher> <publishername> GRAMPS Project </publishername> </publisher>
&legal; &legal;
<!-- This file contains link to license for the documentation (GNU FDL), and <!-- This file contains link to license for the documentation (GNU GPL), and
other legal stuff such as "NO WARRANTY" statement. Please do not change other legal stuff such as "NO WARRANTY" statement. -->
any of this. -->
<authorgroup> <authorgroup>
<author> <author>
@ -106,7 +118,7 @@
--> -->
</authorgroup> </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. --> <!-- modifying/reusing someone else's document. If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other <!-- Remember to remove the &manrevision; entity from the revision entries other
--> -->
@ -129,6 +141,15 @@
<para role="publisher">GRAMPS Project</para> <para role="publisher">GRAMPS Project</para>
</revdescription> </revdescription>
</revision> </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> <revision>
<revnumber>GRAMPS Manual V2.4</revnumber> <revnumber>GRAMPS Manual V2.4</revnumber>
<date>December 2003</date> <date>December 2003</date>
@ -210,118 +231,28 @@
</para> </para>
<!-- Translators may also add here feedback address for translations --> <!-- Translators may also add here feedback address for translations -->
</legalnotice> </legalnotice>
</articleinfo> </bookinfo>
<indexterm zone="index"> <primary>GRAMPS</primary> </indexterm> <indexterm zone="index"> <primary>GRAMPS</primary> </indexterm>
<indexterm zone="index"> <primary>gramps</primary> </indexterm> <indexterm zone="index"> <primary>gramps</primary> </indexterm>
<!-- ============= Document Body ============================= --> <!-- ============= 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"> <!-- Preface -->
<title>Why GRAMPS?</title> &preface;
<para> &app; was conceived under the concept
that most genealogy programs were designed to provide the researcher the <!-- Regular chapters -->
capability to input information related to a particular family tree. &getstart; <!-- Getting Started -->
Most of these programs have allowed for the arranging and storing of &mainwin; <!-- Main window -->
information consistent with the GEDCOM standards. They usually provide &usage; <!-- Usage -->
means for displaying descendant or ancestral relationships by means of &custom; <!-- Customization -->
graphical displays, charts, or reports. These may be augmented with
pictures or other media to enhance the data. Most provide for inputting <!-- Appendices -->
data on unconnected individuals/families that may or may not have a &faq; <!-- FAQ -->
relationship to the primary surname being researched. Various other &keybind; <!-- Keybindings reference -->
enhancements may also be provided in the genealogical program that &filtref; <!-- Filter rule reference -->
allows for different degrees of importing and exporting data from other &cmdline; <!-- Command line reference -->
programs and printing the data contained in the various reports. </para> &bugs; <!-- Bugs and problems -->
&authors; <!-- About authors -->
<para> &app;, on the other hand, attempts to </book>
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>

39
gramps2/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 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="append-keybind">
<title>Keybindings reference</title> <title>Keybindings reference</title>
<para>This appendix contains the list of keybindings that are not <para>This appendix contains the list of keybindings that are not
displayed in menus of &app;. displayed in menus of &app;.
</para> </para>
<!-- =============== Appendices Sub-subsection ================ --> <sect1 id="keybind-people">
<sect3 id="keybind-people">
<title>People View</title> <title>People View</title>
<para>The following bindings are available in the People View:</para> <para>The following bindings are available in the People View:</para>
@ -48,11 +51,10 @@
</tgroup> </tgroup>
</informaltable> </informaltable>
</sect3> </sect1>
<!-- =============== Appendices Sub-subsection ================ --> <sect1 id="keybind-family">
<sect3 id="keybind-family">
<title>Family View</title> <title>Family View</title>
<para>The bindings available in the Family View depend on where the <para>The bindings available in the Family View depend on where the
focus is. The following tables list the bindings for all focus focus is. The following tables list the bindings for all focus
@ -258,7 +260,6 @@
</variablelist> </variablelist>
</sect3> </sect1>
</sect2>
</appendix>

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

@ -1,19 +1,22 @@
<legalnotice id="legalnotice"> <legalnotice id="legalnotice">
<para> <para>
Permission is granted to copy, distribute and/or modify this This manual is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts. You can find </para>
a copy of the GFDL at this <ulink type="help"
url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS <para>
distributed with this manual. This manual is distributed in the hope that it will be useful,
</para> but WITHOUT ANY WARRANTY; without even the implied warranty of
<para> This manual is part of a collection of GNOME manuals MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
distributed under the GFDL. If you want to distribute this GNU General Public License for more details.
manual separately from the collection, you can do so by </para>
adding a copy of the license to the manual, as described in
section 6 of the license. <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>
<para> <para>
@ -27,7 +30,7 @@
<para> <para>
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED 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: WITH THE FURTHER UNDERSTANDING THAT:
<orderedlist> <orderedlist>
@ -73,4 +76,3 @@
</orderedlist> </orderedlist>
</para> </para>
</legalnotice> </legalnotice>

68
gramps2/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 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 This document is free software; you can redistribute it and/or modify
document under the terms of the GNU Free Documentation it under the terms of the GNU General Public License as published by
License (GFDL), Version 1.1 or any later version published the Free Software Foundation; either version 2 of the License, or
by the Free Software Foundation with no Invariant Sections, (at your option) any later version.
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS This document is distributed in the hope that it will be useful,
distributed with this manual. 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$ --> <!-- $Id$ -->
<!-- ================ Main Window ================================ -->
<sect1 id="gramps-mainwin">
<title>Main Window</title> <title>Main Window</title>
<para>When you open a database (either existing or brand new), <para>When you open a database (either existing or brand new),
the following window is displayed.</para> the following window is displayed.</para>
@ -84,7 +88,7 @@
</variablelist> </variablelist>
<!-- ================ Main Window Subsection --> <!-- ================ Main Window Subsection -->
<sect2 id="gramps-views"> <sect1 id="gramps-views">
<title>Views</title> <title>Views</title>
<para>Views are the various ways to display different aspects of <para>Views are the various ways to display different aspects of
genealogical information, as described below. Since the relevant genealogical information, as described below. Since the relevant
@ -96,7 +100,7 @@
switching between the Views.</para> switching between the Views.</para>
<!-- ================ Main Window Sub-subsection --> <!-- ================ Main Window Sub-subsection -->
<sect3 id="view-modes"> <sect2 id="view-modes">
<title>Switching Views and Viewing Modes</title> <title>Switching Views and Viewing Modes</title>
<para>Depending on the state of the <menuchoice> <para>Depending on the state of the <menuchoice>
<guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem> <guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem>
@ -139,10 +143,10 @@
<guimenuitem>Sidebar</guimenuitem> <guimenuitem>Sidebar</guimenuitem>
</menuchoice> from the &app; menu.</para> </menuchoice> from the &app; menu.</para>
</sect3> </sect2>
<!-- ================ Main Window Sub-subsection --> <!-- ================ Main Window Sub-subsection -->
<sect3 id="people-view"> <sect2 id="people-view">
<title>People View</title> <title>People View</title>
<para>When &app; first opens a database, <para>When &app; first opens a database,
the View is set to the People View (<xref linkend="side-nofilt-fig"/> the View is set to the People View (<xref linkend="side-nofilt-fig"/>
@ -170,7 +174,7 @@
heading. </para> heading. </para>
<!-- ================ Main Window Sub-sub-subsection --> <!-- ================ Main Window Sub-sub-subsection -->
<sect4 id="filters"> <sect3 id="filters">
<title>Filters</title> <title>Filters</title>
<para>Genealogical databases may contain huge numbers of people. <para>Genealogical databases may contain huge numbers of people.
Since the long lists are hard for humans to handle, Since the long lists are hard for humans to handle,
@ -219,10 +223,10 @@
checking <menuchoice> <guimenu>View</guimenu> checking <menuchoice> <guimenu>View</guimenu>
<guimenuitem>Filter</guimenuitem> </menuchoice> menu item and check <guimenuitem>Filter</guimenuitem> </menuchoice> menu item and check
what kind of filtering is currently set.</para> what kind of filtering is currently set.</para>
</sect4> </sect3>
<!-- ================ Main Window Sub-sub-subsection --> <!-- ================ Main Window Sub-sub-subsection -->
<sect4 id="alpha-tabs"> <sect3 id="alpha-tabs">
<title>Alphabetical Tabs</title> <title>Alphabetical Tabs</title>
<para>&app; offers another way of <para>&app; offers another way of
managing long lists of people -- alphabetical tabs. Upon loading a 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 characters -- all the entries not assigned to any other tab end up
in <guilabel>Other</guilabel>. In particular, people with no family in <guilabel>Other</guilabel>. In particular, people with no family
name will appear under this category.</para> name will appear under this category.</para>
</sect4> </sect3>
</sect3> </sect2>
<!-- ================ Main Window Sub-subsection --> <!-- ================ Main Window Sub-subsection -->
<sect3 id="family-view"> <sect2 id="family-view">
<title>Family View</title> <title>Family View</title>
<para>Family View displays the family information of a currently <para>Family View displays the family information of a currently
selected (or Active) person. Specifically, this view shows the selected (or Active) person. Specifically, this view shows the
@ -329,10 +333,10 @@
</textobject></mediaobject></screenshot></figure> </textobject></mediaobject></screenshot></figure>
<!-- ==== End of Figure ==== --> <!-- ==== End of Figure ==== -->
</sect3> </sect2>
<!-- ================ Main Window Sub-subsection --> <!-- ================ Main Window Sub-subsection -->
<sect3 id="pedigree-view"> <sect2 id="pedigree-view">
<title>Pedigree View</title> <title>Pedigree View</title>
<!-- ==== Figure: Pedigree View ==== --> <!-- ==== Figure: Pedigree View ==== -->
@ -430,10 +434,10 @@
reference. reference.
</para> </para>
</sect3> </sect2>
<!-- ================ Main Window Sub-subsection --> <!-- ================ Main Window Sub-subsection -->
<sect3 id="sources-view"> <sect2 id="sources-view">
<title>Sources View</title> <title>Sources View</title>
<!-- ==== Figure: Sources View ==== --> <!-- ==== Figure: Sources View ==== -->
@ -456,10 +460,10 @@
<guilabel>Author</guilabel> of the source. Any column can be <guilabel>Author</guilabel> of the source. Any column can be
used for sorting the list. The usual rules apply: one click for used for sorting the list. The usual rules apply: one click for
ascending order, another click for descending order.</para> ascending order, another click for descending order.</para>
</sect3> </sect2>
<!-- ================ Main Window Sub-subsection --> <!-- ================ Main Window Sub-subsection -->
<sect3 id="places-view"> <sect2 id="places-view">
<title>Places View</title> <title>Places View</title>
<!-- ==== Figure: Places View ==== --> <!-- ==== Figure: Places View ==== -->
@ -481,10 +485,10 @@
<guilabel>City</guilabel>, <guilabel>County</guilabel>, <guilabel>City</guilabel>, <guilabel>County</guilabel>,
<guilabel>State</guilabel>, and <guilabel>Country</guilabel>. All of <guilabel>State</guilabel>, and <guilabel>Country</guilabel>. All of
these columns can be used for sorting by the usual sorting rules. </para> these columns can be used for sorting by the usual sorting rules. </para>
</sect3> </sect2>
<!-- ================ Main Window Sub-subsection --> <!-- ================ Main Window Sub-subsection -->
<sect3 id="media-view"> <sect2 id="media-view">
<title>Media View</title> <title>Media View</title>
<!-- ==== Figure: Media View ==== --> <!-- ==== Figure: Media View ==== -->
@ -505,7 +509,7 @@
Path to the Media Object. The top part of the GRAMPS window shows Path to the Media Object. The top part of the GRAMPS window shows
a preview (if available) and information about the Media a preview (if available) and information about the Media
Object. </para> Object. </para>
</sect3> </sect2>
</sect2> </sect1>
</sect1> <!-- ================ End Main Window ===================== --> </chapter>

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