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

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

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


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

360
COPYING-DOCS
View File

@ -1,355 +1,13 @@
GNU Free Documentation License
Version 1.1, March 2000
The User Manual for Gramps is distributed under the terms of
GNU General Public License (GPL). Yes, it is under GNU GPL and
*NOT* under GNU FDL.
Copyright (C) 2000 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
As such, this manual meets citeria of Debian Free Software Guidelines
(DFSG) and can be distributed through Debian main (as opposed to non-free).
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
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.
$Id$

16
ChangeLog
View File

@ -2,6 +2,22 @@
* src/plugins/DetAncestralReport.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>
* src/ReadGrdb.py: Check for overlapping handles prior to
modifying data.

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

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

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

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

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

@ -0,0 +1,27 @@
<appendix id="mayapp-bugs">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003-2005 Alexander Roitman
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<title>Known Bugs and Limitations</title>
</appendix >

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

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

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

@ -1,24 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="gramps-prefs">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 Alexander Roitman
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
License (GFDL), Version 1.1 or any later version published
by the Free Software Foundation with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS
distributed with this manual.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- ================ Customization ================================ -->
<sect1 id="gramps-prefs">
<title>Settings</title>
<para>To configure &app;, choose
<menuchoice><guimenu>Edit</guimenu>
@ -33,13 +36,13 @@
</itemizedlist>
<!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-usage">
<sect1 id="gramps-prefs-usage">
<title>Usage</title>
<para> This category contains preferences relevant to the
general usage of &app;. It has the following subcategories:</para>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-find">
<sect2 id="prefs-usage-find">
<title>Find</title>
<variablelist>
@ -55,10 +58,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-report">
<sect2 id="prefs-usage-report">
<title>Report Preferences</title>
<variablelist>
@ -95,10 +98,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-res">
<sect2 id="prefs-usage-res">
<title>Researcher Information</title>
<variablelist>
@ -115,10 +118,10 @@
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-usage-guess">
<sect2 id="prefs-usage-guess">
<title>Data Guessing</title>
<variablelist>
@ -144,19 +147,19 @@
</variablelist>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-display">
<sect1 id="gramps-prefs-display">
<title>Display</title>
<para> This category contains preferences relevant to
displaying database records and controls in &app;.
It has the following subcategories:</para>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-gen">
<sect2 id="prefs-display-gen">
<title>General</title>
<variablelist>
@ -188,10 +191,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-date">
<sect2 id="prefs-display-date">
<title>Dates and Calendar</title>
<variablelist>
@ -223,10 +226,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-display-bars">
<sect2 id="prefs-display-bars">
<title>Toolbar and Statusbar</title>
<variablelist>
@ -244,18 +247,18 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
</sect2>
</sect1>
<!-- =============== Customization Subsection ================ -->
<sect2 id="gramps-prefs-db">
<sect1 id="gramps-prefs-db">
<title>Database</title>
<para> This category contains preferences relevant to the
database itself. It has the following subcategories: </para>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-gen">
<sect2 id="prefs-db-gen">
<title>General</title>
<variablelist>
@ -288,10 +291,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-media">
<sect2 id="prefs-db-media">
<title>Media Objects</title>
<para>Before describing preferences for media objects, let us
@ -346,10 +349,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-id">
<sect2 id="prefs-db-id">
<title>GRAMPS internal IDs</title>
<variablelist>
@ -368,10 +371,10 @@
</varlistentry>
</variablelist>
</sect3>
</sect2>
<!-- =============== Customization Sub-subsection ================ -->
<sect3 id="prefs-db-rcs">
<sect2 id="prefs-db-rcs">
<title>Revision Control</title>
<variablelist>
@ -391,8 +394,8 @@
</variablelist>
</sect3>
</sect2>
</sect2>
</sect1>
</sect1> <!-- ================ End Customization ================== -->
</chapter>

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

@ -1,22 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<appendix id="faq">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 Alexander Roitman
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
License (GFDL), Version 1.1 or any later version published
by the Free Software Foundation with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS
distributed with this manual.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="faq">
<title>Frequently Asked Questions</title>
<para>This appendix contains the list of questions that frequently come
up in mailing list discussions and forums. This list is by no means
@ -380,4 +385,4 @@ potential of your great idea :-)
</variablelist>
</sect2>
</appendix>

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

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

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

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

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

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

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

@ -1,30 +1,33 @@
<?xml version="1.0" encoding="UTF-8"?>
<appendix id="append-keybind">
<!--
User Manual for Gramps - a GTK+/GNOME based genealogy program
Copyright (C) 2003 Alexander Roitman
Copyright (C) 2003-2005 Alexander Roitman
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
License (GFDL), Version 1.1 or any later version published
by the Free Software Foundation with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file COPYING-DOCS
distributed with this manual.
This document is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<!-- =============== Appendices Subsection ================ -->
<sect2 id="append-keybind">
<title>Keybindings reference</title>
<para>This appendix contains the list of keybindings that are not
displayed in menus of &app;.
</para>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="keybind-people">
<sect1 id="keybind-people">
<title>People View</title>
<para>The following bindings are available in the People View:</para>
@ -48,11 +51,10 @@
</tgroup>
</informaltable>
</sect3>
</sect1>
<!-- =============== Appendices Sub-subsection ================ -->
<sect3 id="keybind-family">
<sect1 id="keybind-family">
<title>Family View</title>
<para>The bindings available in the Family View depend on where the
focus is. The following tables list the bindings for all focus
@ -258,7 +260,6 @@
</variablelist>
</sect3>
</sect2>
</sect1>
</appendix>

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

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

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

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

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

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

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

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