From 172cd77ac16412f15f31c14b4ad23e3e105e5d51 Mon Sep 17 00:00:00 2001 From: Alex Roitman Date: Mon, 1 Dec 2003 14:22:11 +0000 Subject: [PATCH] * doc/gramps-manual/C/keybind.xml: Update. * doc/gramps-manual/C/usage.xml: Update. * doc/gramps-manual/C/custom.xml: Update. * NEWS: typo. * doc/gramps-manual/C/keybind.xml: Update. svn: r2414 --- gramps2/ChangeLog | 8 +- gramps2/NEWS | 2 +- gramps2/doc/gramps-manual/C/custom.xml | 4 +- gramps2/doc/gramps-manual/C/keybind.xml | 66 ++++----- gramps2/doc/gramps-manual/C/usage.xml | 178 +++++++++++++++++++++--- 5 files changed, 205 insertions(+), 53 deletions(-) diff --git a/gramps2/ChangeLog b/gramps2/ChangeLog index 9ed67c261..242316613 100644 --- a/gramps2/ChangeLog +++ b/gramps2/ChangeLog @@ -1,3 +1,9 @@ +2003-12-01 Alex Roitman + * doc/gramps-manual/C/keybind.xml: Update. + * doc/gramps-manual/C/usage.xml: Update. + * doc/gramps-manual/C/custom.xml: Update. + * NEWS: typo. + 2003-12-01 Tim Waugh * doc/xmldocs.make: Clean copied XML files. Now 'make distcheck' works again. @@ -8,8 +14,8 @@ callback on Shift+click; (sp_key_press, child_key_press): Replace Ctrl+Insert with Shift+Insert for adding new people. * src/PedView.py (on_show_child_menu): Markup children with children. - * doc/gramps-manual/C/keybind.xml: Update. * doc/gramps-manual/C/faq.xml: Update. + * doc/gramps-manual/C/keybind.xml: Update. * doc/gramps-manual/C/filtref.xml: Update. 2003-11-29 Don Allingham diff --git a/gramps2/NEWS b/gramps2/NEWS index 2bc69b508..e08916214 100644 --- a/gramps2/NEWS +++ b/gramps2/NEWS @@ -15,7 +15,7 @@ Version 0.98.0 -- the "Round me off" release within the session. * Substantial speedups in updating display in tree views. * Children are enumerated in Family View. -* ZODB backend is removed. Reald database backend is being worked on and will +* ZODB backend is removed. Real database backend is being worked on and will appear in post-1.0 releases. * Tab labels in tabbed dialogs reflect the presence of data (bold). * Help button available in most dialogs. diff --git a/gramps2/doc/gramps-manual/C/custom.xml b/gramps2/doc/gramps-manual/C/custom.xml index c1269132c..7b7112c76 100644 --- a/gramps2/doc/gramps-manual/C/custom.xml +++ b/gramps2/doc/gramps-manual/C/custom.xml @@ -1,11 +1,13 @@ + + Settings To configure &app;, choose - Settings + Edit Preferences.... The Preferences dialog contains the following categories: diff --git a/gramps2/doc/gramps-manual/C/keybind.xml b/gramps2/doc/gramps-manual/C/keybind.xml index cc75d724a..190039907 100644 --- a/gramps2/doc/gramps-manual/C/keybind.xml +++ b/gramps2/doc/gramps-manual/C/keybind.xml @@ -3,7 +3,7 @@ - + Keybindings reference This appendix contains the list of keybindings that are not displayed in menus of &app;. @@ -26,7 +26,7 @@ - Enter + Enter Invoke Edit Person dialog with the selected person. @@ -61,16 +61,16 @@ - Enter + Enter Invoke Edit Person dialog with the active person. - Ctrl+Down - or Ctrl+Right + Ctrl+Down + or Ctrl+Right Swap the Active Person and the selected spouse. - Use Ctrl+Down in standard Family View and - Ctrl+Right in alternative Family + Use Ctrl+Down in standard Family View and + Ctrl+Right in alternative Family View. @@ -96,36 +96,36 @@ - Enter + Enter Edit relationship between the Active Person and the selected spouse. - Shift+Enter + Shift+Enter Edit the personal information for the selected spouse. - Insert + Insert Add a person from the database to the spouse list. - Shift+Insert + Shift+Insert Add a new person to the database and to the spouse list. - Delete + Delete Delete the selected spouse from the spouse list. The spouse is not deleted from the database. - Ctrl+Up - or Ctrl+Left + Ctrl+Up + or Ctrl+Left Swap the selected spouse and the Active Person. - Use Ctrl+Down in standard Family View and - Ctrl+Right in alternative Family + Use Ctrl+Down in standard Family View and + Ctrl+Right in alternative Family View. @@ -151,32 +151,32 @@ - Enter + Enter Edit relationship between the parents and their child (either the Active Person or the selected spouse, depending which parents box the focus is in). - Insert + Insert Add a new set of parents from the database to the list. - Shift+Insert + Shift+Insert Add a new set of parents to the database and to the list. - Delete + Delete Delete the selected parents from the list. The parents are not deleted from the database. - Ctrl+Right - or Ctrl+Down + Ctrl+Right + or Ctrl+Down Make the selected parents the active family. - Use Ctrl+Right in standard Family View and - Ctrl+Down in alternative Family + Use Ctrl+Right in standard Family View and + Ctrl+Down in alternative Family View. @@ -202,37 +202,37 @@ - Enter + Enter Edit relationship between the child and his/her parents (the Active Person and the selected spouse). - Shift+Enter + Shift+Enter Edit the personal information for the selected child. - Insert + Insert Add a new person from the database to the children list. - Shift+Insert + Shift+Insert Add a new person to the database and to the children list. - Delete + Delete Delete the selected child from the list. The child is not deleted from the database. - Ctrl+Left - or Ctrl+Up + Ctrl+Left + or Ctrl+Up Make the selected child the Active Person. - Use Ctrl+Left in standard Family View and - Ctrl+Up in alternative Family + Use Ctrl+Left in standard Family View and + Ctrl+Up in alternative Family View. diff --git a/gramps2/doc/gramps-manual/C/usage.xml b/gramps2/doc/gramps-manual/C/usage.xml index 6d2ae01cb..e64a2fd56 100644 --- a/gramps2/doc/gramps-manual/C/usage.xml +++ b/gramps2/doc/gramps-manual/C/usage.xml @@ -1,4 +1,7 @@ + + + Usage @@ -292,6 +295,12 @@ database can be edited! Adding a new piece of information is in fact creating an appropriate empty data structure and subsequent editing of that empty structure. + + This section refers mainly to the menu items and buttons as the main + way of interacting with &app;. In addition to this, &app; provides an + extensive set of keybindings. The detailed reference to the keybindings + is found in the . + @@ -304,6 +313,13 @@ for details). To edit information about a person already present in the database, select an entry you would like to view/modify, and then click the Edit icon on the toolbar. + + You can also use Add... and + Edit... menu items available under + the Edit. Or you can right-click on the person + and select Add... or Edit... + from the invoked context menu. + @@ -474,7 +490,11 @@ Editing Data: Complete Description This section provides a complete description of all editing - options for all pieces of data in the &app; database. + options for all pieces of data in the &app; database. It refers mainly + to the menu items and buttons as the main way of interacting with &app;. + In addition to this, &app; provides an extensive set of keybindings. + The detailed reference to the keybindings is found in + the . @@ -485,11 +505,15 @@ From the People View: Double-click the name of the person whose data you would like to edit, or select the name by single click and then click the - Edit icon on the toolbar. + Edit icon on the toolbar. You may also select + the name and then press Return. Finally, you may select + Edit... from the Edit + menu of &app; or choose Edit from the context + menu that appears upon right-click on the name. From the Family View: Move the mouse into the Active person box, - then double-click. + then double-click, or use any of the menu items described above. @@ -507,7 +531,7 @@ The top of the window shows the name of the person whose - data is being edited. The main part of the window displays nine + data is being edited. The main part of the window displays ten notebook tabs containing different categories of available information. You can bring any tab to the top for viewing or editing by clicking on the appropriate tab heading. @@ -523,6 +547,9 @@ + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). The tabs provide the following information categories of personal data: @@ -716,6 +743,43 @@ + + Sources + + + +
+ Edit Person dialog - Sources + + + Shows Sources Tab of Edit Person dialog. +
+ + + The Sources tab displays information about + the sources related to the person and controls allowing its modification. + These could be any general sources which refer to the person but do not + describe specifically any event. + For example, Aunt Martha's memoirs may mention her great grandson Paul, + so the researcher may assume that this person (Paul) existed and cite + the memoirs as the source for this assumption. NOTE: sources documenting + specific events are better filed in relation to those events, under the + Events tab. + + The central part displays the list of all source references stored + in the database in relation to the person. The + buttons Add..., + Edit..., and Delete + allow you to correspondingly add, modify, and remove a source reference + to this person. Note that the Edit... and + Delete buttons become available only when + a source reference is selected from the list. + + + + + Gallery @@ -902,7 +966,7 @@ The top of the window shows the names of the people whose relationship is being edited. The main part of the window displays - six notebook tabs containing different categories of available + seven notebook tabs containing different categories of 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 OK and @@ -916,6 +980,9 @@ initial cancel request, or saving the changes. + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). The tabs provide the following information categories of relationship data: @@ -981,11 +1048,37 @@ + + Sources + + The Sources tab displays information about + the sources related to the relationship and controls allowing its + modification. These could be any general sources which refer to the + relationship but do not describe specifically any event. + For example, Aunt Martha's memoirs may mention that her great grandson Paul + was married, so the researcher may assume that this relationship (between + Paul and his wife) existed and cite the memoirs as the source for this + assumption. NOTE: sources documenting specific events such as marriages + or divorces are better filed in relation to those events, under the + Events tab. + + The central part displays the list of all source references stored + in the database for this relationship. The + buttons Add..., + Edit..., and Delete + allow you to correspondingly add, modify, and remove a source reference + to this relationship. Note that the Edit... and + Delete buttons become available only when + a source reference is selected from the list. + + + + Gallery The Gallery tab displays information about - media objects associated with the person and the controls allowing + media objects associated with the relationship and the controls allowing modification of such. The central part shows the list of all such media objects. For media object which are valid image files previews of images are displayed. For other objects such as audio files, movie files, etc., a @@ -1051,6 +1144,9 @@ the changes. + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). The tabs provide the following information categories of source data: @@ -1147,6 +1243,9 @@ the changes. + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). The tabs provide the following information categories of place data: @@ -1293,6 +1392,9 @@ the changes. + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). The tabs provide the following information categories of media object data: @@ -1389,7 +1491,11 @@ without saving changes, canceling the initial cancel request, or saving the changes. - The tabs provide the following information categories of + + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). + The tabs provide the following information categories of the event data: @@ -1521,7 +1627,11 @@ without saving changes, canceling the initial cancel request, or saving the changes. - The tabs provide the following information categories of + + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). + The tabs provide the following information categories of the alternate name data: @@ -1598,7 +1708,11 @@ without saving changes, canceling the initial cancel request, or saving the changes. - The tabs provide the following information categories of + + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). + The tabs provide the following information categories of the attribute data: @@ -1673,7 +1787,11 @@ without saving changes, canceling the initial cancel request, or saving the changes. - The tabs provide the following information categories of + + The tab labels reflect the presence of corresponding information: if the + tab contains any data, its label appears boldface; if the tab has no data + then its label appears regular (not bold). + The tabs provide the following information categories of the address data: @@ -1790,7 +1908,7 @@ Merge People Sometime two people entries in the database turn out to be describing the same person. When this happens, merging people is - a useful useful way of correcting the situation. + a useful way of correcting the situation. To make a merge, exactly two people have to be selected in the People View. This is accomplished by selecting one person and then @@ -1799,7 +1917,7 @@ When exactly two people are selected, choose EditMerge... - to evoke Merge dialog. The dialog allows you to + to evoke Merge People dialog. The dialog allows you to 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 data if you so choose. If you would like to continue editing data of @@ -1807,6 +1925,27 @@ button. + + + Merge Places + Sometime two place entries in the database turn out to be + describing the same place. When this happens, merging places is + a useful way of correcting the situation. + + To make a merge, exactly two places have to be selected in the + Places View. This is accomplished by selecting one place and then + selecting another place while holding down Ctrl key. + + + When exactly two places are selected, choose + EditMerge... + to evoke Merge Places dialog. The dialog allows + you to retain the data from either place as the primary data for + the new (merged) place. Alternatively, you may type in other data + for the new place, if you click Other radio + button. + + @@ -1874,6 +2013,11 @@ + + In addition to this, &app; provides an extensive set of keyboard + navigation options. The detailed reference to the keybindings + is found in the . + @@ -1925,8 +2069,8 @@ To set the Home person, first navigate to that person using any method you like. Then choose - Settings - Home Person. Once this is + Edit + Set Home person. Once this is done, you can move to the Home person from anywhere in the database by simply clicking the Home icon on the toolbar. You can also choose Go @@ -1946,9 +2090,9 @@ They include Back and Forward items available from the Go menu, context menus, and the toolbar buttons. They also include the - Go - History menu which lists - the recent selections and allows to jump directly to any of them. + list of the recent selections available under the + Go menu that allows you to jump + directly to any of the recent selections. Finally, right-clicking on the Back and Forward toolbar buttons invokes the popup menu with corresponding portion of the history. Select any item