* doc/gramps-manual/C/gramps-manual.xml: More corrections.

svn: r1870
This commit is contained in:
Alex Roitman 2003-07-12 01:17:27 +00:00
parent 97215515a6
commit 131e0fe862
2 changed files with 143 additions and 111 deletions

View File

@ -1,6 +1,7 @@
2003-07-11 Alex Roitman <shura@alex.neuro.umn.edu> 2003-07-11 Alex Roitman <shura@alex.neuro.umn.edu>
* src/plugins/IndivSummary.py (IndivSummary.__init__): * src/plugins/IndivSummary.py (IndivSummary.__init__):
Provide default value of 0 to newpage argument. Provide default value of 0 to newpage argument.
* doc/gramps-manual/C/gramps-manual.xml: More corrections.
2003-07-11 Donald Peterson <dpeterson@sigmaxi.org> 2003-07-11 Donald Peterson <dpeterson@sigmaxi.org>
* src/docgen/LaTeXDoc.py: Added UNICODE support and '&' handling * src/docgen/LaTeXDoc.py: Added UNICODE support and '&' handling

View File

@ -101,6 +101,9 @@
<revdescription> <revdescription>
<para role="author">Alex Roitman <para role="author">Alex Roitman
<email>shura@alex.neuro.umn.edu</email> <email>shura@alex.neuro.umn.edu</email>
</para>
<para role="author">Donald A. Peterson
<email>dpeterson@sigmaxi.org</email>
</para> </para>
<para role="publisher">GRAMPS Project</para> <para role="publisher">GRAMPS Project</para>
</revdescription> </revdescription>
@ -294,7 +297,7 @@
<!-- ==== End of Figure ==== --> <!-- ==== End of Figure ==== -->
<para>If you would like to open an existing database, check the top radio <para>If you would like to open an existing database, check the top radio
button and click <guibutton>OK</guibutton>. You will then be asked to button and click the <guibutton>OK</guibutton> button. You will then be asked to
specify the name of your existing database. If you would like to start specify the name of your existing database. If you would like to start
creating your brand new database from scratch right away, choose new XML creating your brand new database from scratch right away, choose new XML
database. </para> database. </para>
@ -418,7 +421,7 @@
progressbar, on the very bottom of the &app; window. progressbar, on the very bottom of the &app; window.
It displays information about current <application>&app;</application> It displays information about current <application>&app;</application>
activity and contextual information about the menu items. activity and contextual information about the menu items.
The behavior of the Status line can be adjusted in The behavior of the statusbar can be adjusted in
<guilabel>Preferences</guilabel> dialog. </para></listitem> <guilabel>Preferences</guilabel> dialog. </para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term>Display area</term> <varlistentry><term>Display area</term>
@ -541,19 +544,19 @@
filter is set to the trivial filter called <guilabel>All filter is set to the trivial filter called <guilabel>All
people</guilabel>, i.e. no filtering is in effect. To choose a people</guilabel>, i.e. no filtering is in effect. To choose a
filter, use the pop-up <guilabel>Filter</guilabel> menu above the filter, use the pop-up <guilabel>Filter</guilabel> menu above the
people's list. Once the filter is chosen, click people's list. Once the filter is chosen, click the
<guibutton>Apply</guibutton> in the upper right corner of the <guibutton>Apply</guibutton> button in the upper right corner of the
window. The filtering will take effect upon clicking window. The filtering will take effect upon clicking the
<guibutton>Apply</guibutton>. To invert the filtering rule, check <guibutton>Apply</guibutton> button. To invert the filtering rule,
the <guilabel>Invert</guilabel> box on the left check the <guilabel>Invert</guilabel> box on the left
of <guibutton>Apply</guibutton> button. </para> of <guibutton>Apply</guibutton> button. </para>
<para>Example: To show people without children, choose <para>Example: To show people without children, choose
<guilabel>People with children</guilabel> filter, then check <guilabel>People with children</guilabel> filter, then check
<guilabel>Invert</guilabel> box, and then click <guilabel>Invert</guilabel> box, and then click the
<guibutton>Apply</guibutton>. To cancel any filtering, set <guibutton>Apply</guibutton> button. To cancel any filtering, set
the filter to <guilabel>All people</guilabel> the filter to <guilabel>All people</guilabel>
and then click <guibutton>Apply</guibutton>. </para> and then click the <guibutton>Apply</guibutton> button. </para>
<para>Note: even if the filter controls are not displayed <para>Note: even if the filter controls are not displayed
(<menuchoice> <guimenu>View</guimenu> (<menuchoice> <guimenu>View</guimenu>
@ -630,7 +633,7 @@
on the bottom). Both list boxes have a set of three buttons on their on the bottom). Both list boxes have a set of three buttons on their
right side. The <guibutton>+</guibutton> and <guibutton>-</guibutton> right side. The <guibutton>+</guibutton> and <guibutton>-</guibutton>
buttons allow you to add and remove parents of the Active person and the buttons allow you to add and remove parents of the Active person and the
Current spouse, respectively. Clicking <guibutton>-></guibutton> Current spouse, respectively. Clicking the right arrow button
makes the family in the corresponding list box an active family. makes the family in the corresponding list box an active family.
That is, it makes the selected Father the Active person, and the That is, it makes the selected Father the Active person, and the
selected Mother the Current spouse. </para> selected Mother the Current spouse. </para>
@ -794,10 +797,10 @@
or click the <guibutton>Open</guibutton> button on the Toolbar. or click the <guibutton>Open</guibutton> button on the Toolbar.
The <guilabel>Open Database</guilabel> dialog will appear. The <guilabel>Open Database</guilabel> dialog will appear.
Either type the full path into the <guilabel>Database</guilabel> text Either type the full path into the <guilabel>Database</guilabel> text
entry field, or click <guibutton>Browse...</guibutton> to get the entry field, or click the <guibutton>Browse...</guibutton> button to get
<guilabel>Open File</guilabel> dialog in which you can select the file the <guilabel>Open File</guilabel> dialog in which you can select the
that you want to open. After you have selected the file, click file that you want to open. After you have selected the file, click the
<guibutton>OK</guibutton> to open it. </para> <guibutton>OK</guibutton> button to open it. </para>
<para>If you have previously opened files with <para>If you have previously opened files with
<application>&app;</application> you can retrieve your past selections <application>&app;</application> you can retrieve your past selections
@ -829,8 +832,8 @@
<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>
<guimenuitem>Save</guimenuitem></menuchoice> or click <guimenuitem>Save</guimenuitem></menuchoice> or click the
<guibutton>Save</guibutton> on the Toolbar. The Status line will then <guibutton>Save</guibutton> button on the Toolbar. The statusbar will then
display the <guilabel>Saving <replaceable>filename</replaceable>...</guilabel> display the <guilabel>Saving <replaceable>filename</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> </sect2>
@ -845,6 +848,18 @@
available as items of <menuchoice><guimenu>File</guimenu> available as items of <menuchoice><guimenu>File</guimenu>
<guisubmenu>Import</guisubmenu></menuchoice> submenu.</para> <guisubmenu>Import</guisubmenu></menuchoice> submenu.</para>
<para>Both &app; database, and &app; package are native &app;
formats. The package is a compressed archive containing the database
file and all media objects (images, sound files, etc.) that the
database refers to. The package is created by exporting data to
the &app; package, see <xref linkend="export-data"/>.
The &app; database is a directory containing the database file and
the local media objects. The database may also have references
to non-local (external) media objects, therefore it is not guaranteed
to be completely portable. The &app; database is created by saving
the data in a usual way, see <xref linkend="save-db"/>.
</para>
<para>Note that the difference between opening &app; database and <para>Note that the difference between opening &app; database and
importing from &app; database is that importing incorporates all the importing from &app; database is that importing incorporates all the
data into your currently open database, if any. </para> data into your currently open database, if any. </para>
@ -891,7 +906,7 @@
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>To remove the object corresponding to the missing file as well as <para>To remove the object corresponding to the missing file as well as
all the references to that object from various database records, click all the references to that object from various database records, click the
<guibutton>Remove Object</guibutton> button. This will alter your <guibutton>Remove Object</guibutton> button. This will alter your
database so that it will be in a consistent state, but all the database so that it will be in a consistent state, but all the
references to the missing file will be gone. Use this option if the references to the missing file will be gone. Use this option if the
@ -901,14 +916,14 @@
<listitem> <listitem>
<para>To keep the reference to the object corresponding to the missing <para>To keep the reference to the object corresponding to the missing
file, click <guibutton>Keep Reference</guibutton> button. file, click the <guibutton>Keep Reference</guibutton> button.
This will leave things as is, i.e. in an inconsistent state. This will leave things as is, i.e. in an inconsistent state.
You could supply the missing file later, in which case you will have You could supply the missing file later, in which case you will have
to copy it into your database directory. Choose this option if the to copy it into your database directory. Choose this option if the
replacement is possible, but not available right now. </para></listitem> replacement is possible, but not available right now. </para></listitem>
<listitem> <listitem>
<para>To supply the missing file during import, click <para>To supply the missing file during import, click the
<guibutton>Select File</guibutton> button. This will copy the file you <guibutton>Select File</guibutton> button. This will copy the file you
select in place of the missing file. No references will be altered select in place of the missing file. No references will be altered
in the database, and it will be in the consistent state. Use this option in the database, and it will be in the consistent state. Use this option
@ -945,7 +960,7 @@
<!-- ==== End of Export ==== --> <!-- ==== End of Export ==== -->
<para>Type the desired GEDCOM filename into the text entry box or <para>Type the desired GEDCOM filename into the text entry box or
click <guibutton>Browse...</guibutton> to evoke the click the <guibutton>Browse...</guibutton> button to evoke the
<guilabel>Save File</guilabel> dialog. Use the <guilabel>Filter</guilabel> <guilabel>Save File</guilabel> dialog. Use the <guilabel>Filter</guilabel>
pop-up menu to limit the scope of the export according to the stated rule. pop-up menu to limit the scope of the export according to the stated rule.
Choose the desired <guilabel>Encoding</guilabel> of the exported file. Choose the desired <guilabel>Encoding</guilabel> of the exported file.
@ -982,9 +997,9 @@
</para> </para>
<para>Exporting to CD will prepare you database directory with all its <para>Exporting to CD will prepare you database directory with all its
contents to be recorded to the CD. This is done through contents to be recorded to the CD. This is done through the
<guilabel>burn:///</guilabel> location in Nautilus. After exporting to <guilabel>burn:///</guilabel> location in Nautilus. After exporting to
CD, go to <guilabel>burn:///</guilabel> location by CD, go to the <guilabel>burn:///</guilabel> location by
selecting <menuchoice><guimenu>Go</guimenu> selecting <menuchoice><guimenu>Go</guimenu>
<guisubmenu>CD Creator</guisubmenu></menuchoice> in Nautilus menu. Your <guisubmenu>CD Creator</guisubmenu></menuchoice> in Nautilus menu. Your
database directory will show up. To record it onto the CD, click the CD database directory will show up. To record it onto the CD, click the CD
@ -1009,8 +1024,8 @@
<listitem> <listitem>
<para>To remove the object corresponding to the missing file as well as <para>To remove the object corresponding to the missing file as well as
all the references to that object from various database records, click all the references to that object from various database records, click
<guibutton>Remove Object</guibutton> button. This will alter your the <guibutton>Remove Object</guibutton> button. This will alter your
database so that it will be in a consistent state, but all the database so that it will be in the consistent state, but all the
references to the missing file will be gone. Use this option if the references to the missing file will be gone. Use this option if the
file is irrevocably lost and there is no possibility of ever replacing file is irrevocably lost and there is no possibility of ever replacing
it. </para> it. </para>
@ -1018,14 +1033,14 @@
<listitem> <listitem>
<para>To keep the reference to the object corresponding to the missing <para>To keep the reference to the object corresponding to the missing
file, click <guibutton>Keep Reference</guibutton> button. file, click the <guibutton>Keep Reference</guibutton> button.
This will leave things as is, i.e. in an inconsistent state. This will leave things as is, i.e. in the inconsistent state.
You could supply the missing file later, in which case you will have You could supply the missing file later, in which case you will have
to copy it into your database directory. Choose this option if the to copy it into your database directory. Choose this option if the
replacement is possible, but not available right now. </para></listitem> replacement is possible, but not available right now. </para></listitem>
<listitem> <listitem>
<para>To supply the missing file during export, click <para>To supply the missing file during export, click the
<guibutton>Select File</guibutton> button. This will copy the file you <guibutton>Select File</guibutton> button. This will copy the file you
select in place of the missing file. No references will be altered select in place of the missing file. No references will be altered
in the database, and it will be in the consistent state. Use this option in the database, and it will be in the consistent state. Use this option
@ -1058,7 +1073,7 @@
Person</guilabel> Dialog (see <xref linkend="edit-pers-fig"/> Person</guilabel> Dialog (see <xref linkend="edit-pers-fig"/>
for details). To edit information about a person already present for details). To edit information about a person already present
in the database, select an entry you would like to view/modify, in the database, select an entry you would like to view/modify,
and then click <guibutton>Edit</guibutton> on the toolbar. </para> and then click the <guibutton>Edit</guibutton> icon on the toolbar. </para>
</sect3> </sect3>
<!-- ================ Usage Sub-subsection ================ --> <!-- ================ Usage Sub-subsection ================ -->
@ -1128,12 +1143,12 @@
<para> To add images related to a single person, switch to the <para> To add images related to a single person, switch to the
People View (<xref linkend="side-nofilt-fig"/>), select a person, and People View (<xref linkend="side-nofilt-fig"/>), select a person, and
then click <guibutton>Edit</guibutton> on the toolbar to invoke then click the <guibutton>Edit</guibutton> icon on the toolbar to
the <guilabel>Edit Person</guilabel> Dialog invoke the <guilabel>Edit Person</guilabel> Dialog
(<xref linkend="edit-pers-fig"/>). Then, select the (<xref linkend="edit-pers-fig"/>). Then, select the
<guilabel>Gallery</guilabel> tab, and click <guilabel>Gallery</guilabel> tab, and click the
<guibutton>Add...</guibutton> to invoke the <guilabel>Select a media <guibutton>Add...</guibutton> button to invoke the <guilabel>Select a media
object</guilabel> dialog. Type filename or select a file with the object</guilabel> dialog. Type the filename or select a file with the
image, then provide a title for that image. To prevent the file from image, then provide a title for that image. To prevent the file from
being copied into your database directory, check the <guilabel>Do not being copied into your database directory, check the <guilabel>Do not
make a local copy</guilabel> box. Keep adding images until you are make a local copy</guilabel> box. Keep adding images until you are
@ -1141,23 +1156,26 @@
<para> To add images related to a relationship (e.g. marriage), <para> To add images related to a relationship (e.g. marriage),
switch to the Family View (<xref linkend="family-fig"/>) and then switch to the Family View (<xref linkend="family-fig"/>) and then
double click on the Spouse box invoke the <guilabel>Marriage/Relationship double-click on the Spouse box invoke the <guilabel>Marriage/Relationship
editor</guilabel> dialog. Select the <guilabel>Gallery</guilabel> editor</guilabel> dialog. Select the <guilabel>Gallery</guilabel>
tab and click <guibutton>Add...</guibutton> to add an image. </para> tab and click the <guibutton>Add...</guibutton> button to add
an image. </para>
<para> To add images related to a source or a place, first switch to <para> To add images related to a source or a place, first switch to
the Sources View (<xref linkend="sources-fig"/>) or Places the Sources View (<xref linkend="sources-fig"/>) or Places
View (<xref linkend="places-fig"/>), respectively. Then select the View (<xref linkend="places-fig"/>), respectively. Then select the
appropriate source or place and then either double click on it appropriate source or place and then either double-click on it
or click <guibutton>Edit</guibutton> on the toolbar to invoke the or click the <guibutton>Edit</guibutton> icon on the toolbar to invoke the
<guilabel>Source Editor</guilabel> (or <guilabel>Place <guilabel>Source Editor</guilabel> (or <guilabel>Place
Editor</guilabel>) dialog. Select the <guilabel>Gallery</guilabel> Editor</guilabel>) dialog. Select the <guilabel>Gallery</guilabel>
tab and click <guibutton>Add...</guibutton> to add an image. </para> tab and click the <guibutton>Add...</guibutton> button to add
an image. </para>
<para> Finally, to add images that are generally related to the <para> Finally, to add images that are generally related to the
database but not limited to any person, relationship, source, or place database but not limited to any person, relationship, source, or place
in particular, switch to the Media View (<xref linkend="media-fig"/>). in particular, switch to the Media View (<xref linkend="media-fig"/>).
Then click <guibutton>Add</guibutton> on the toolbar to add an image. Then click the <guibutton>Add</guibutton> icon on the toolbar to
add an image.
If you have already added any images to any individual galleries, If you have already added any images to any individual galleries,
you will also find them listed in the Media View. </para> you will also find them listed in the Media View. </para>
@ -1167,7 +1185,7 @@
galleries removing the reference to the image does not remove the image galleries removing the reference to the image does not remove the image
from the database. To completely remove the image from the database, from the database. To completely remove the image from the database,
delete it from Media View by first selecting it and then delete it from Media View by first selecting it and then
clicking <guibutton>Remove</guibutton> on the toolbar. </para> clicking the <guibutton>Remove</guibutton> icon on the toolbar. </para>
</sect3> </sect3>
@ -1178,15 +1196,16 @@
<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
the appropriate Sources View (<xref linkend="sources-fig"/>) or the appropriate Sources View (<xref linkend="sources-fig"/>) or
Places View (<xref linkend="places-fig"/>). Places View (<xref linkend="places-fig"/>).
Then click <guibutton>Add</guibutton> on the toolbar to add a Then click the <guibutton>Add</guibutton> icon on the toolbar to add a
source/place. Enter the information into the <guilabel>Source source/place. Enter the information into the <guilabel>Source
Editor</guilabel> (or <guilabel>Place Editor</guilabel>) dialog. Editor</guilabel> (or <guilabel>Place Editor</guilabel>) dialog.
</para> </para>
<para> To edit information about sources and places already present <para> To edit information about sources and places already present
in the database, switch to the appropriate view, select an entry in the database, switch to the appropriate view, select an entry
you would like to view/modify, and then click you would like to view/modify, and then click the
<guibutton>Edit</guibutton> on the toolbar. <guibutton>Edit</guibutton> icon on the toolbar. Alternatively, you
may double-click on the entry to edit it.
</para> </para>
</sect3> </sect3>
@ -1206,8 +1225,8 @@
<variablelist> <variablelist>
<varlistentry><term>From the People View:</term><listitem><para> <varlistentry><term>From the People View:</term><listitem><para>
Double-click the name of the person whose data you would like Double-click the name of the person whose data you would like
to edit, or select the name by single click and then click to edit, or select the name by single click and then click the
<guibutton>Edit</guibutton> on the toolbar. <guibutton>Edit</guibutton> icon on the toolbar.
</para></listitem></varlistentry> </para></listitem></varlistentry>
<varlistentry><term>From the Family View:</term><listitem><para> <varlistentry><term>From the Family View:</term><listitem><para>
Move the mouse into the <guilabel>Active person</guilabel> box, Move the mouse into the <guilabel>Active person</guilabel> box,
@ -1234,9 +1253,10 @@
information. You can bring any tab to the top for viewing information. You can bring any tab to the top for viewing
or editing by clicking on the appropriate tab heading. or editing by clicking on the appropriate tab heading.
The bottom part has <guibutton>OK</guibutton> and The bottom part has <guibutton>OK</guibutton> and
<guibutton>Cancel</guibutton> buttons. Clicking <guibutton>OK</guibutton> <guibutton>Cancel</guibutton> buttons. Clicking the
<guibutton>OK</guibutton> button
at any time will apply all the changes made in all tabs and close the at any time will apply all the changes made in all tabs and close the
dialog window. Clicking <guibutton>Cancel</guibutton> at any time will dialog window. Clicking the <guibutton>Cancel</guibutton> button at any time will
close the window without applying any changes. If any of the data close the window without applying any changes. If any of the data
in any tab were modified, the alert window will appear with the in any tab were modified, the alert window will appear with the
choices of closing the dialog without saving changes, canceling the choices of closing the dialog without saving changes, canceling the
@ -1263,7 +1283,7 @@
and death. Some of these (<guilabel>Family name</guilabel>, and death. Some of these (<guilabel>Family name</guilabel>,
<guilabel>Type</guilabel>, and both <guilabel>Place</guilabel> fields), <guilabel>Type</guilabel>, and both <guilabel>Place</guilabel> fields),
also allow you to choose the corresponding also allow you to choose the corresponding
contents from the drop-down menus by clicking on a down-arrow button contents from the drop-down menus by clicking on the down arrow button
located immediately to the right of the text entry field. The located immediately to the right of the text entry field. The
available menu choices are formed from the information already stored available menu choices are formed from the information already stored
in the database. Also, when you start to type within these fields, in the database. Also, when you start to type within these fields,
@ -1273,7 +1293,7 @@
the next field, press the <keycap>Tab</keycap>. </para> the next field, press the <keycap>Tab</keycap>. </para>
<para> <para>
The <guilabel>Gender</guilabel> radio buttons offers The <guilabel>Gender</guilabel> radio buttons offer
the choice of person's gender between <guilabel>male</guilabel>, the choice of person's gender between <guilabel>male</guilabel>,
<guilabel>female</guilabel>, and <guilabel>unknown</guilabel>. <guilabel>female</guilabel>, and <guilabel>unknown</guilabel>.
The buttons <guibutton>Source...</guibutton> and The buttons <guibutton>Source...</guibutton> and
@ -1283,9 +1303,10 @@
birth and death <guilabel>Date</guilabel> fields allows you to edit the birth and death <guilabel>Date</guilabel> fields allows you to edit the
corresponding events of birth and death. corresponding events of birth and death.
The field <guilabel>ID</guilabel> displays an internal The field <guilabel>ID</guilabel> displays an internal
&app; ID number which identifies user in the &app; ID number which identifies the user in the
database. Finally, the <guilabel>Image</guilabel> area shows the first database. Finally, the <guilabel>Image</guilabel> area shows the first
image available in the <guilabel>Gallery</guilabel> of this person. image available in the <guilabel>Gallery</guilabel> of this
person (if any exist).
</para> </para>
</listitem></varlistentry> </listitem></varlistentry>
</variablelist> </variablelist>
@ -1406,6 +1427,10 @@
<guibutton>Delete</guibutton> buttons become available only when <guibutton>Delete</guibutton> buttons become available only when
an address is selected from the list. an address is selected from the list.
</para> </para>
<para>Some reports allow you to restrict data on living people.
In particular, that option will omit the addresses of people who
are currently alive.</para>
</listitem></varlistentry> </listitem></varlistentry>
</variablelist> </variablelist>
@ -1449,7 +1474,7 @@
<para>The <guilabel>Gallery</guilabel> tab displays information about <para>The <guilabel>Gallery</guilabel> tab displays information about
media objects associated with the person and controls allowing subsequent media objects associated with the person and controls allowing subsequent
modification. The central part shows the list of all such media objects. modification. The central part shows the list of all such media objects.
For media object which are valid image files previews of images are For media object which are valid image files, previews of images are
displayed. For other objects such as audio files, movie files, etc., a displayed. For other objects such as audio files, movie files, etc., a
generic &app; icon is displayed instead. Note that the first available generic &app; icon is displayed instead. Note that the first available
image in the gallery will be also displayed in the image in the gallery will be also displayed in the
@ -1460,6 +1485,11 @@
to this person. Note that the <guibutton>Edit...</guibutton> and to this person. Note that the <guibutton>Edit...</guibutton> and
<guibutton>Remove</guibutton> buttons become available only when <guibutton>Remove</guibutton> buttons become available only when
a media object is selected from the list. a media object is selected from the list.
</para>
<para>Note: removing a media object from a person's gallery does not
remove it from the database. It only removes the reference to that
object from this person's record.
</para> </para>
</listitem></varlistentry> </listitem></varlistentry>
</variablelist> </variablelist>
@ -1617,9 +1647,10 @@
information. You can bring any tab to the top for viewing information. You can bring any tab to the top for viewing
or editing by clicking on the appropriate tab heading. or editing by clicking on the appropriate tab heading.
The bottom part has <guibutton>OK</guibutton> and The bottom part has <guibutton>OK</guibutton> and
<guibutton>Cancel</guibutton> buttons. Clicking <guibutton>OK</guibutton> <guibutton>Cancel</guibutton> buttons. Clicking the
<guibutton>OK</guibutton> button
at any time will apply all the changes made in all tabs and close the at any time will apply all the changes made in all tabs and close the
dialog window. Clicking <guibutton>Cancel</guibutton> at any time will dialog window. Clicking the <guibutton>Cancel</guibutton> button at any time will
close the window without applying any changes. If any of the data close the window without applying any changes. If any of the data
in any tab were modified, the alert window will appear with the in any tab were modified, the alert window will appear with the
choices of closing the dialog without saving changes, canceling the choices of closing the dialog without saving changes, canceling the
@ -1732,7 +1763,7 @@
<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
click <guibutton>Edit</guibutton> on the toolbar to invoke the click the <guibutton>Edit</guibutton> icon on the toolbar to invoke the
following <guilabel>Source Editor</guilabel> dialog: </para> following <guilabel>Source Editor</guilabel> dialog: </para>
<!-- ==== Figure: Source Editor dialog ==== --> <!-- ==== Figure: Source Editor dialog ==== -->
@ -1751,10 +1782,10 @@
tabs containing different categories of available information. You can tabs containing different categories of available information. You can
bring any tab to the top for viewing or editing by clicking on the bring any tab to the top for viewing or editing by clicking on the
appropriate tab heading. The bottom part has <guibutton>OK</guibutton> appropriate tab heading. The bottom part has <guibutton>OK</guibutton>
and <guibutton>Cancel</guibutton> buttons. Clicking and <guibutton>Cancel</guibutton> buttons. Clicking the
<guibutton>OK</guibutton> at any time will apply all the changes made <guibutton>OK</guibutton> button at any time will apply all the changes made
in all tabs and close the dialog window. Clicking in all tabs and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data in any tab were modified, applying any changes. If any of the data in any tab were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -1829,7 +1860,7 @@
<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
click <guibutton>Edit</guibutton> on the toolbar to invoke the click the <guibutton>Edit</guibutton> icon on the toolbar to invoke the
following <guilabel>Place Editor</guilabel> dialog: </para> following <guilabel>Place Editor</guilabel> dialog: </para>
<!-- ==== Figure: Place Editor dialog ==== --> <!-- ==== Figure: Place Editor dialog ==== -->
@ -1848,9 +1879,9 @@
You can bring any tab to the top for viewing or editing by clicking on You can bring any tab to the top for viewing or editing by clicking on
the appropriate tab heading. The bottom part has the appropriate tab heading. The bottom part has
<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. <guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons.
Clicking <guibutton>OK</guibutton> at any time will apply all the Clicking the <guibutton>OK</guibutton> button at any time will apply all the
changes made in all tabs and close the dialog window. Clicking changes made in all tabs and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data in any tab were modified, applying any changes. If any of the data in any tab were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -1994,9 +2025,9 @@
You can bring any tab to the top for viewing or editing by clicking on You can bring any tab to the top for viewing or editing by clicking on
the appropriate tab heading. The bottom part has the appropriate tab heading. The bottom part has
<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. <guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons.
Clicking <guibutton>OK</guibutton> at any time will apply all the Clicking the <guibutton>OK</guibutton> button at any time will apply all the
changes made in all tabs and close the dialog window. Clicking changes made in all tabs and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data in any tab were modified, applying any changes. If any of the data in any tab were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -2091,9 +2122,9 @@
available information. You can bring any tab to the top for viewing or available information. You can bring any tab to the top for viewing or
editing by clicking on the appropriate tab heading. The bottom part has editing by clicking on the appropriate tab heading. The bottom part has
<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. <guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons.
Clicking <guibutton>OK</guibutton> at any time will apply all the Clicking the <guibutton>OK</guibutton> button at any time will apply all the
changes made in all tabs and close the dialog window. Clicking changes made in all tabs and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data in any tab were modified, applying any changes. If any of the data in any tab were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -2178,9 +2209,9 @@
<para> The top of the window shows the dialog title. The central part <para> The top of the window shows the dialog title. The central part
displays the source information. The bottom part has displays the source information. The bottom part has
<guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. <guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons.
Clicking <guibutton>OK</guibutton> at any time will apply all the Clicking the <guibutton>OK</guibutton> button at any time will apply all the
changes made and close the dialog window. Clicking changes made and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data were modified, applying any changes. If any of the data were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -2222,10 +2253,10 @@
categories of available information. You can bring any tab to the categories of available information. You can bring any tab to the
top for viewing or editing by clicking on the appropriate tab heading. top for viewing or editing by clicking on the appropriate tab heading.
The bottom part has <guibutton>OK</guibutton> and The bottom part has <guibutton>OK</guibutton> and
<guibutton>Cancel</guibutton> buttons. Clicking <guibutton>Cancel</guibutton> buttons. Clicking the
<guibutton>OK</guibutton> at any time will apply all the <guibutton>OK</guibutton> button at any time will apply all the
changes made in all tabs and close the dialog window. Clicking changes made in all tabs and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data in any tab were modified, applying any changes. If any of the data in any tab were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -2299,10 +2330,10 @@
categories of available information. You can bring any tab to the categories of available information. You can bring any tab to the
top for viewing or editing by clicking on the appropriate tab heading. top for viewing or editing by clicking on the appropriate tab heading.
The bottom part has <guibutton>OK</guibutton> and The bottom part has <guibutton>OK</guibutton> and
<guibutton>Cancel</guibutton> buttons. Clicking <guibutton>Cancel</guibutton> buttons. Clicking the
<guibutton>OK</guibutton> at any time will apply all the <guibutton>OK</guibutton> button at any time will apply all the
changes made in all tabs and close the dialog window. Clicking changes made in all tabs and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data in any tab were modified, applying any changes. If any of the data in any tab were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -2374,10 +2405,10 @@
categories of available information. You can bring any tab to the categories of available information. You can bring any tab to the
top for viewing or editing by clicking on the appropriate tab heading. top for viewing or editing by clicking on the appropriate tab heading.
The bottom part has <guibutton>OK</guibutton> and The bottom part has <guibutton>OK</guibutton> and
<guibutton>Cancel</guibutton> buttons. Clicking <guibutton>Cancel</guibutton> buttons. Clicking the
<guibutton>OK</guibutton> at any time will apply all the <guibutton>OK</guibutton> button at any time will apply all the
changes made in all tabs and close the dialog window. Clicking changes made in all tabs and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window without <guibutton>Cancel</guibutton> button at any time will close the window without
applying any changes. If any of the data in any tab were modified, applying any changes. If any of the data in any tab were modified,
the alert window will appear with the choices of closing the dialog the alert window will appear with the choices of closing the dialog
without saving changes, canceling the initial cancel request, or saving without saving changes, canceling the initial cancel request, or saving
@ -2446,9 +2477,9 @@
<para> The top of the window shows the dialog title. The central part <para> The top of the window shows the dialog title. The central part
of the window displays information about the witness. The bottom part of the window displays information about the witness. The bottom part
has <guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons. has <guibutton>OK</guibutton> and <guibutton>Cancel</guibutton> buttons.
Clicking <guibutton>OK</guibutton> at any time will apply all the Clicking the <guibutton>OK</guibutton> button at any time will apply all the
changes made and close the dialog window. Clicking changes made and close the dialog window. Clicking the
<guibutton>Cancel</guibutton> at any time will close the window <guibutton>Cancel</guibutton> button at any time will close the window
without applying any changes. If any of the data were without applying any changes. If any of the data were
modified, the alert window will appear with the choices of closing modified, the alert window will appear with the choices of closing
the dialog without saving changes, canceling the initial cancel the dialog without saving changes, canceling the initial cancel
@ -2462,10 +2493,10 @@
<varlistentry><term>Person from the database</term> <varlistentry><term>Person from the database</term>
<listitem><para> <listitem><para>
If the person's data are stored in a database, check <guilabel>Person If the person's data are stored in a database, check <guilabel>Person
is in the database</guilabel> box. Then click is in the database</guilabel> box. Then click the
<guibutton>Select</guibutton> button to evoke <guilabel>Select <guibutton>Select</guibutton> button to evoke <guilabel>Select
Person</guilabel> dialog. Choose the person from that dialog and Person</guilabel> dialog. Choose the person from that dialog and
click <guibutton>OK</guibutton>. The <guilabel>Person</guilabel> click the <guibutton>OK</guibutton> button. The <guilabel>Person</guilabel>
text field will display the name of the person you selected. text field will display the name of the person you selected.
Note: even though the person's name is displayed in the Note: even though the person's name is displayed in the
<guilabel>Person</guilabel> field, it is not available for direct <guilabel>Person</guilabel> field, it is not available for direct
@ -2513,7 +2544,7 @@
retain the data from either person as the primary data for the new retain the data from either person as the primary data for the new
(merged) person. The data from the other person can be kept as alternate (merged) person. The data from the other person can be kept as alternate
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 <guibutton>Merge and edit</guibutton> a newly merged person, click the <guibutton>Merge and edit</guibutton>
button. </para> button. </para>
</sect3> </sect3>
@ -2590,7 +2621,7 @@
<itemizedlist> <itemizedlist>
<listitem><para>To make any displayed person the active person, <listitem><para>To make any displayed person the active person,
double click the line that connects to the left side of the double-click the line that connects to the left side of the
corresponding box. </para></listitem> corresponding box. </para></listitem>
<listitem><para>To make a child of currently active person (if any) <listitem><para>To make a child of currently active person (if any)
@ -2624,8 +2655,8 @@
<menuchoice><guimenu>Settings</guimenu> <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Default Person</guimenuitem></menuchoice>. Once this is <guimenuitem>Default Person</guimenuitem></menuchoice>. Once this is
done, you can move to the default person from anywhere in the done, you can move to the default person from anywhere in the
database by simply clicking <guibutton>Home</guibutton> on the database by simply clicking the <guibutton>Home</guibutton> icon
toolbar. </para> on the toolbar. </para>
</sect3> </sect3>
@ -2728,8 +2759,8 @@
Report</replaceable></guimenuitem></menuchoice>. Alternatively, Report</replaceable></guimenuitem></menuchoice>. Alternatively,
you can browse the complete selection of available reports along you can browse the complete selection of available reports along
with their brief descriptions in a <guilabel>Report with their brief descriptions in a <guilabel>Report
Selection</guilabel> dialog evoked by clicking Selection</guilabel> dialog evoked by clicking the
<guibutton>Reports</guibutton> on the toolbar. <guibutton>Reports</guibutton> icon on the toolbar.
</para> </para>
<!-- =============== Usage Sub-subsection ================ --> <!-- =============== Usage Sub-subsection ================ -->
@ -2765,22 +2796,22 @@
the order they will appear in the book. </para> the order they will appear in the book. </para>
<para> The top set of buttons between the panes operates on the <para> The top set of buttons between the panes operates on the
selected book item. Click <guibutton>Add</guibutton> to add selected selected book item. Click the <guibutton>Add</guibutton> button to add selected
item from the available list to the current book. Click item from the available list to the current book. Click the
<guibutton>Remove</guibutton> to remove an item from the current book. <guibutton>Remove</guibutton> button to remove an item from the current book.
Use <guibutton>Up</guibutton> and <guibutton>Down</guibutton> to change Use <guibutton>Up</guibutton> and <guibutton>Down</guibutton> to change
the items order in the current book. Click <guibutton>Setup</guibutton> the items order in the current book. Click the <guibutton>Setup</guibutton>
to configure the options of the selected item of the current book. button to configure the options of the selected item of the current book.
</para> </para>
<para> The bottom set of buttons between the panes operates on the <para> The bottom set of buttons between the panes operates on the
whole book. Click <guibutton>Clear</guibutton> to clear all items from whole book. Click the <guibutton>Clear</guibutton> button to clear all items from
the current book. Click <guibutton>Save</guibutton> to save the current the current book. Click the <guibutton>Save</guibutton> button to save the current
book (under the name typed in the <guilabel>Book name</guilabel> text book (under the name typed in the <guilabel>Book name</guilabel> text
entry field) for future use. Note that saving the book also saves the entry field) for future use. Note that saving the book also saves the
configuration for each item. Click <guibutton>Open</guibutton> to load configuration for each item. Click the <guibutton>Open</guibutton> button to load
the book from the list of previously saved books. Finally, click the book from the list of previously saved books. Finally, click the
<guibutton>Edit books</guibutton> to evoke the editable list of <guibutton>Edit books</guibutton> button to evoke the editable list of
available books. available books.
</para> </para>
@ -3011,8 +3042,8 @@
Tool</replaceable></guimenuitem></menuchoice>. Alternatively, Tool</replaceable></guimenuitem></menuchoice>. Alternatively,
you can browse the complete selection of available tools along you can browse the complete selection of available tools along
with their brief descriptions in a <guilabel>Tool with their brief descriptions in a <guilabel>Tool
Selection</guilabel> dialog evoked by clicking Selection</guilabel> dialog evoked by clicking the
<guibutton>Tools</guibutton> on the toolbar. </para> <guibutton>Tools</guibutton> icon on the toolbar. </para>
<!-- =============== Usage Sub-subsection ================ --> <!-- =============== Usage Sub-subsection ================ -->
<sect3 id="tools-ae"> <sect3 id="tools-ae">
@ -3107,7 +3138,7 @@
<para>When you launch it, the <guilabel>User defined filters</guilabel> <para>When you launch it, the <guilabel>User defined filters</guilabel>
dialog appears that lists all the filters (if any) previously defined dialog appears that lists all the filters (if any) previously defined
by you. Click <guibutton>Add...</guibutton> to define a new filter. by you. Click the <guibutton>Add...</guibutton> button to define a new filter.
Once you have designed your filters, you can edit, test, and delete Once you have designed your filters, you can edit, test, and delete
selected filters using the <guibutton>Edit...</guibutton>, selected filters using the <guibutton>Edit...</guibutton>,
<guibutton>Test...</guibutton>, and <guibutton>Delete...</guibutton> <guibutton>Test...</guibutton>, and <guibutton>Delete...</guibutton>
@ -3115,7 +3146,7 @@
automatically saved along with your database and will be available automatically saved along with your database and will be available
with subsequent sessions of <application>&app;</application>. </para> with subsequent sessions of <application>&app;</application>. </para>
<para>Clicking <guibutton>Add...</guibutton> invokes the <para>Clicking the <guibutton>Add...</guibutton> button invokes the
following <guilabel>Define filter</guilabel> dialog: </para> following <guilabel>Define filter</guilabel> dialog: </para>
<!-- ==== Figure: Define filter dialog ==== --> <!-- ==== Figure: Define filter dialog ==== -->
@ -3367,7 +3398,7 @@
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><guilabel>Status bar</guilabel></term> <varlistentry><term><guilabel>Statusbar</guilabel></term>
<listitem><para> Select the desired contents displayed in the <listitem><para> Select the desired contents displayed in the
statusbar using the radio buttons. statusbar using the radio buttons.
</para></listitem> </para></listitem>