diff --git a/gramps2/ChangeLog b/gramps2/ChangeLog index f864dd002..496fce7c3 100644 --- a/gramps2/ChangeLog +++ b/gramps2/ChangeLog @@ -8,6 +8,15 @@ * doc/gramps-manual/C/figures/edit-person-notes.png: Update. * doc/gramps-manual/C/figures/date-selection.png: Add new figure. + * src/EditPlace.py: Correct manual section. + * src/EditSource.py: Correct manual section. + * src/EventEdit.py: Correct manual section. + * src/ImageSelect.py: Correct manual section. + * src/Marriage.py: Correct manual section. + * src/NameEdit.py: Correct manual section. + * doc/gramps-manual/C/usage.xml: Update. + * doc/gramps-manual/C/figures/edit-*.png: Update. + 2005-05-02 * src/GrampsBSDDB.py: handle missing version number properly, detect empty database properly. diff --git a/gramps2/doc/gramps-manual/C/figures/edit-an.png b/gramps2/doc/gramps-manual/C/figures/edit-an.png index e5e888978..da11c61da 100644 Binary files a/gramps2/doc/gramps-manual/C/figures/edit-an.png and b/gramps2/doc/gramps-manual/C/figures/edit-an.png differ diff --git a/gramps2/doc/gramps-manual/C/figures/edit-ev.png b/gramps2/doc/gramps-manual/C/figures/edit-ev.png index e01fe7ba9..bfd4809e8 100644 Binary files a/gramps2/doc/gramps-manual/C/figures/edit-ev.png and b/gramps2/doc/gramps-manual/C/figures/edit-ev.png differ diff --git a/gramps2/doc/gramps-manual/C/figures/edit-media.png b/gramps2/doc/gramps-manual/C/figures/edit-media.png index be20a689d..103660a38 100644 Binary files a/gramps2/doc/gramps-manual/C/figures/edit-media.png and b/gramps2/doc/gramps-manual/C/figures/edit-media.png differ diff --git a/gramps2/doc/gramps-manual/C/figures/edit-plc.png b/gramps2/doc/gramps-manual/C/figures/edit-plc.png index b1c9ab9db..516dda5fd 100644 Binary files a/gramps2/doc/gramps-manual/C/figures/edit-plc.png and b/gramps2/doc/gramps-manual/C/figures/edit-plc.png differ diff --git a/gramps2/doc/gramps-manual/C/figures/edit-rel.png b/gramps2/doc/gramps-manual/C/figures/edit-rel.png index fa48b0572..2542e42c6 100644 Binary files a/gramps2/doc/gramps-manual/C/figures/edit-rel.png and b/gramps2/doc/gramps-manual/C/figures/edit-rel.png differ diff --git a/gramps2/doc/gramps-manual/C/figures/edit-si.png b/gramps2/doc/gramps-manual/C/figures/edit-si.png index 881734ff7..f0d38f017 100644 Binary files a/gramps2/doc/gramps-manual/C/figures/edit-si.png and b/gramps2/doc/gramps-manual/C/figures/edit-si.png differ diff --git a/gramps2/doc/gramps-manual/C/figures/edit-src.png b/gramps2/doc/gramps-manual/C/figures/edit-src.png index 46a42b3ed..48dd82907 100644 Binary files a/gramps2/doc/gramps-manual/C/figures/edit-src.png and b/gramps2/doc/gramps-manual/C/figures/edit-src.png differ diff --git a/gramps2/doc/gramps-manual/C/usage.xml b/gramps2/doc/gramps-manual/C/usage.xml index 44ba5c2da..a8b058c33 100644 --- a/gramps2/doc/gramps-manual/C/usage.xml +++ b/gramps2/doc/gramps-manual/C/usage.xml @@ -713,7 +713,7 @@ button, while using + and - Edit Personal Information + Personal Information Editing of personal data can be performed in the following ways: @@ -778,11 +778,12 @@ save changes to the database (write on disk). Unlike previous versions, this version of &app; does not have a separate saving function, all changes are immediate. - + 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 + then its label appears regular (not bold). + + The tabs provide the following information categories of personal data: @@ -1147,7 +1148,7 @@ Editor dialog (see ). - Edit Dates + Dates This section describes the details of entering and modifying dates. Dates are important in genealogical research, so &app; goes a long way to preserve and use any date information available. @@ -1297,10 +1298,13 @@ dialog described in detail below, see - Edit Relationship Data + Relationship Data Editing of relationship data is performed in the following Marriage/Relationship Editor dialog which appears - after double-clicking on the spouse box in the Family View. + after double-clicking on the spouse box in the Family View. Alternatively, + you may invoke this dialog by right-clicking into the spouse box + and selecting Edit relationship item from + the context menu.
@@ -1327,11 +1331,17 @@ dialog described in detail below, see - +Clicking OK will immediately +save changes to the database (write on disk). Unlike previous versions, +this version of &app; does not have a separate saving function, +all changes are immediate. + + 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 + then its label appears regular (not bold). + + The tabs provide the following information categories of relationship data: @@ -1342,9 +1352,10 @@ dialog described in detail below, see Relationship type menu. - The non-editable field ID displays an - internal &app; ID number which identifies this relationship in - the database. + The ID field displays &app; ID number + which labels this relationship in the database. The Last + changed label shows the last modification time for this + relationship. Finally, the Information is complete check button provides the way to mark whether this relationship's record is complete or not. @@ -1359,11 +1370,11 @@ dialog described in detail below, see Add..., Edit..., - and Delete allow you to correspondingly add, + +, Edit, + and - allow you to correspondingly add, modify, and remove an event record from the database. - Note that the Edit... and - Delete buttons become available only when + Note that the Edit and + - buttons become available only when an event is selected from the list. @@ -1377,11 +1388,11 @@ dialog described in detail below, see Add..., Edit..., - and Delete allow you to correspondingly add, + +, Edit, + and - allow you to correspondingly add, modify, and remove an attribute record from the database. - Note that the Edit... and - Delete buttons become available only when + Note that the Edit and + - buttons become available only when an attribute is selected from the list. @@ -1421,17 +1432,20 @@ dialog described in detail below, see Events tab. + assumption. + + 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 + buttons +, + Edit, and - 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 + to this relationship. Note that the Edit and + - buttons become available only when a source reference is selected from the list. @@ -1446,14 +1460,14 @@ dialog described in detail below, see Add from file..., - Add from database..., - Edit..., and Remove allow + The buttons +, + Select, + Edit, and - allow you to correspondingly add a new image, add a reference to an image already stored in the database, modify, and remove a media object reference to this relationship. - Note that the Edit... and - Remove buttons become available only when + Note that the Edit and + - buttons become available only when a media object is selected from the list. @@ -1478,7 +1492,7 @@ dialog described in detail below, see - Edit Source Data + Source Data 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 click the Edit icon on the toolbar to invoke the @@ -1499,20 +1513,27 @@ dialog described in detail below, see OK + appropriate tab heading. + The bottom part has OK and Cancel buttons. Clicking the OK button at any time will apply all the changes made in all tabs and close the dialog window. Clicking the Cancel button at any time will close the window without applying any changes. - - + +Clicking OK will immediately +save changes to the database (write on disk). Unlike previous versions, +this version of &app; does not have a separate saving function, +all changes are immediate. + + 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). + then its label appears regular (not bold). + + The tabs provide the following information categories of - source data: - + source data: General @@ -1555,14 +1576,14 @@ dialog described in detail below, see Add from file..., - Add from database..., - Edit..., and Remove allow + The buttons +, + Select, + Edit, and - allow you to correspondingly add a new image, add a reference to an image already stored in the database, modify, and remove a media object reference to this source. - Note that the Edit... and - Remove buttons become available only when + Note that the Edit and + - buttons become available only when a media object is selected from the list. @@ -1576,11 +1597,17 @@ dialog described in detail below, see Source type, Object, or - Value. This information cannot be modified from - the Source Editor dialog. Instead, the - corresponding database record (e.g. birth event) has to be brought - up and its source reference edited. + Type, ID, or + Name. Double-clicking on the list entry + opens up an editor for a corresponding record allowing + to view or modify the record. + + Only primary objects can be shown in the + References tab: Person, Family, Event, Place, or Media + object. The secondary objects such as Names and Attributes, although + may refer the source, will only show up through their primary + objects they belong to. + @@ -1589,7 +1616,7 @@ dialog described in detail below, see - Edit Place Data + Place Data 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 click the Edit icon on the toolbar to invoke the @@ -1609,20 +1636,27 @@ dialog described in detail below, see OK and Cancel buttons. Clicking the OK button at any time will apply all the changes made in all tabs and close the dialog window. Clicking the Cancel button at any time will close the window without applying any changes. + +Clicking OK will immediately +save changes to the database (write on disk). Unlike previous versions, +this version of &app; does not have a separate saving function, +all changes are immediate. - + 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: - + then its label appears regular (not bold). + + + The tabs provide the following information categories of + place data: General @@ -1643,11 +1677,11 @@ dialog described in detail below, see Add..., - Edit..., and Delete allow + The buttons +, + Edit, and - allow you to correspondingly add, modify, and remove a name record - from the database. Note that the Edit... and - Delete buttons become available only when + from the database. Note that the Edit and + - buttons become available only when a name is selected from the list. @@ -1679,11 +1713,11 @@ dialog described in detail below, see Sources tab displays information about sources relevant to this place and controls allowing its modification. The central part displays the list of all such source references - stored in the database. The buttons Add..., - Edit..., and Delete allow + stored in the database. The buttons +, + Edit, and - allow you to correspondingly add, modify, and remove a source reference - to this place. Note that the Edit... and - Delete buttons become available only when + to this place. Note that the Edit and + - buttons become available only when a source reference is selected from the list. @@ -1697,14 +1731,14 @@ dialog described in detail below, see Add from file..., - Add from database..., - Edit..., and Remove allow + The buttons +, + Select, Edit., + and - allow you to correspondingly add a new image, add a reference to an image already stored in the database, modify, and remove a media object reference to this place. - Note that the Edit... and - Remove buttons become available only when + Note that the Edit and + - buttons become available only when a media object is selected from the list. @@ -1718,13 +1752,13 @@ dialog described in detail below, see Add..., - Edit..., and Delete + The buttons +, + Edit, and - allow you to correspondingly add, modify, and remove an Internet address record from the database. The button Go allows you to open a web-page with the corresponding address with your default - browser. Note that the Edit..., - Delete, and Go buttons + browser. Note that the Edit, + -, and Go buttons become available only when an address is selected from the list. @@ -1734,7 +1768,7 @@ dialog described in detail below, see References The References tab displays information about - database records that refer to this place. If the place is not + database records (events or LDS ordinances) that refer to this place. If the place is not referenced from any database record, the tab shows an empty list. If the place is referenced from many records, the tab will list all of them. This information cannot be modified from @@ -1748,19 +1782,19 @@ dialog described in detail below, see - Edit Media Data + Media Data 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 click Edit on the toolbar to invoke the - following Edit Media Properties dialog: + following Media Properties Editor dialog:
- Edit Media Properties dialog + Media Properties Editor dialog - Shows Edit Media Properties dialog. + Shows Media Properties Editor dialog.
@@ -1775,11 +1809,18 @@ dialog described in detail below, see Cancel button at any time will close the window without applying any changes. + +Clicking OK will immediately +save changes to the database (write on disk). Unlike previous versions, +this version of &app; does not have a separate saving function, +all changes are immediate. - + 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). + then its label appears regular (not bold). + + The tabs provide the following information categories of media object data: @@ -1789,13 +1830,15 @@ dialog described in detail below, see The General tab allows editing the title which labels this object in the database. The title can be typed in the appropriate - text entry field. If the object is not local (i.e. the corresponding - file does not reside under &app; database directory), the - Make a local copy button is available. - Click it to copy the media into the &app; database directory. This will - increase the amount of disk space consumed by the &app; database. However, - if the external file is deleted or removed, &app; will still be able - to use the local copy. + text entry field. The Date field allows entering + the date by typing, while the LED button beside it will invoke a + Date selection dialog for setting the date + graphically. + + &app; no longer has a concept of local media objects. + Every media object is referred to by its path. The users are responsible + for keeping track of the object files. &app; will only reference + and display the contents, not manage the files themselves.
@@ -1807,11 +1850,11 @@ dialog described in detail below, see Add..., Edit..., - and Delete allow you to correspondingly add, + +, Edit, + and - allow you to correspondingly add, modify, and remove an attribute record from the database. - Note that the Edit... and - Delete buttons become available only when + Note that the Edit and + - buttons become available only when an attribute is selected from the list. @@ -1846,20 +1889,25 @@ dialog described in detail below, see Type, Object, or - Value. This information cannot be modified from - the Media Object Properties Editor dialog. - Instead, the corresponding database record (e.g. birth event) has to - be brought up and its media object reference edited in the gallery - tab. - + Type, ID, or + Name. Double-clicking on the list entry + opens up an editor for a corresponding record allowing + to view or modify the record. + + Only primary objects can be shown in the + References tab: Person, Family, Event, Source, or Place. + The secondary objects such as Names and Attributes, although + able to refer the media object, will only show up through their primary + objects they belong to. + +
- Edit Events + Events Events are edited through the following Event Editor dialog: @@ -1884,10 +1932,12 @@ dialog described in detail below, see Cancel button at any time will close the window without applying any 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). + then its label appears regular (not bold). + + The tabs provide the following information categories of the event data: @@ -1912,11 +1962,11 @@ dialog described in detail below, see Sources tab displays information about sources relevant to this event and controls allowing its modification. The central part displays the list of all such sources references - stored in the database. The buttons Add..., - Edit..., and Delete + stored in the database. The buttons +, + Edit, and - allow you to correspondingly add, modify, and remove a source reference - to this event. Note that the Edit... and - Delete buttons become available only when + to this event. Note that the Edit and + - buttons become available only when a source reference is selected from the list. @@ -1948,11 +1998,11 @@ dialog described in detail below, see Witnesses tab displays information about witnesses relevant to this event and controls allowing its modification. The central part displays the list of all such witnesses - stored in the database. The buttons Add..., - Edit..., and Delete + stored in the database. The buttons +, + Edit, and - allow you to correspondingly add, modify, and remove a witness reference - to this event. Note that the Edit... and - Delete buttons become available only when + to this event, see . Note that the Edit and + - buttons become available only when a witness reference is selected from the list. @@ -1961,7 +2011,7 @@ dialog described in detail below, see - Edit Source Information + Source Information When adding source references to events, places, etc., the following dialog appears: @@ -1994,27 +2044,33 @@ dialog described in detail below, see Confidence drop-down menu. The rest of the details can be typed in the appropriate text entry fields. + + Information in this dialog is specific to the particular reference. + A single source can be referenced many times, and all such references will + have in common the overall source information. This dialog lets you provide + reference-specific data, such as relevant quotes, comments, confidence, + page numbers, etc, to further specify and document the reference. - Edit Alternate Names - Alternate names are edited through the following - Alternate Names Editor dialog: + Names + Names are edited through the following + Name Editor dialog: - +
- Alternate Names Editor dialog + Name Editor dialog - Shows Alternate Names Editor dialog. + Shows Name Editor dialog.
The top of the window shows the dialog title including the name - of the person whose alternate name is being edited. The central part + of the person whose name is being edited. The central part of the window displays three 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. @@ -2025,22 +2081,39 @@ dialog described in detail below, see Cancel button at any time will close the window without applying any 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 + then its label appears regular (not bold). + + + The tabs provide the following information categories of the alternate name data: General The General tab allows editing of general - information about the alternate name: given name, family name, family + information about the alternate name: given name, family name, + patronymic, family prefix, suffix, title, and type of the name. The information can be typed in the appropriate text entry fields. The family name and the type can be also selected from available choices listed in the - appropriate drop-down menus. + appropriate drop-down menus. + + Options allow you to adjust specific + grouping, sorting, and displaying properties of this name, as well + as to provide the date corresponding to the name. The + Grouping field provides an alternative + grouping node for a given name, overriding the default grouping + based on the family name. This may be necessary with similar + family names that need to be grouped together. To enable + typing into this field, check the Override + check button. The Sort as and + Display as determine the manner + in which the name appears in the People View and in the reports. + The Date can provide information on + the validity of this name -- use spans as necessary. Check the Private record box to mark this name record as private. This will give you a chance to omit this name from being included in reports, if you choose so among the report @@ -2054,11 +2127,11 @@ dialog described in detail below, see Sources tab displays information about sources relevant to this name and controls allowing its modification. The central part displays the list of all such sources' references - stored in the database. The buttons Add..., - Edit..., and Delete + stored in the database. The buttons +, + Edit, and - allow you to correspondingly add, modify, and remove a source reference - to this name. Note that the Edit... and - Delete buttons become available only when + to this name. Note that the Edit and + - buttons become available only when a source reference is selected from the list. @@ -2088,7 +2161,7 @@ dialog described in detail below, see - Edit Attributes + Attributes Attributes are edited through the following Attribute Editor dialog: @@ -2175,7 +2248,7 @@ dialog described in detail below, see - Edit Addresses + Addresses Addresses are edited through the following Address Editor dialog: @@ -2263,7 +2336,7 @@ dialog described in detail below, see - Edit Witnesses + Witnesses Witnesses are edited through the following Witness Editor dialog: diff --git a/gramps2/src/EditPlace.py b/gramps2/src/EditPlace.py index b4c2ce35a..d5f176cae 100644 --- a/gramps2/src/EditPlace.py +++ b/gramps2/src/EditPlace.py @@ -290,7 +290,7 @@ class EditPlace: def on_help_clicked(self,obj): """Display the relevant portion of GRAMPS manual""" - gnome.help_display('gramps-manual','gramps-edit-complete') + gnome.help_display('gramps-manual','adv-plc') def build_columns(self,tree,list): cnum = 0 diff --git a/gramps2/src/EditSource.py b/gramps2/src/EditSource.py index ef3fcf4d1..8792bc1d4 100644 --- a/gramps2/src/EditSource.py +++ b/gramps2/src/EditSource.py @@ -212,7 +212,7 @@ class EditSource: def on_help_clicked(self,obj): """Display the relevant portion of GRAMPS manual""" - gnome.help_display('gramps-manual','gramps-edit-complete') + gnome.help_display('gramps-manual','adv-src') def close(self,obj): self.gallery.close() diff --git a/gramps2/src/EventEdit.py b/gramps2/src/EventEdit.py index b8ba293cb..24403bfe7 100644 --- a/gramps2/src/EventEdit.py +++ b/gramps2/src/EventEdit.py @@ -298,7 +298,7 @@ class EventEditor: def on_help_clicked(self,obj): """Display the relevant portion of GRAMPS manual""" - gnome.help_display('gramps-manual','gramps-edit-complete') + gnome.help_display('gramps-manual','adv-ev') def get_place(self,field,trans): text = unicode(field.get_text().strip()) diff --git a/gramps2/src/ImageSelect.py b/gramps2/src/ImageSelect.py index ef1b53a52..078f1efd3 100644 --- a/gramps2/src/ImageSelect.py +++ b/gramps2/src/ImageSelect.py @@ -1191,7 +1191,7 @@ class GlobalMediaProperties: def on_help_clicked(self, obj): """Display the relevant portion of GRAMPS manual""" - gnome.help_display('gramps-manual','gramps-edit-complete') + gnome.help_display('gramps-manual','adv-media') def on_ok_clicked(self, obj): self.on_apply_clicked(obj) diff --git a/gramps2/src/Marriage.py b/gramps2/src/Marriage.py index 940ec3e31..3d183584b 100644 --- a/gramps2/src/Marriage.py +++ b/gramps2/src/Marriage.py @@ -373,7 +373,7 @@ class Marriage: def on_help_clicked(self,obj): """Display the relevant portion of GRAMPS manual""" - gnome.help_display('gramps-manual','gramps-edit-complete') + gnome.help_display('gramps-manual','adv-rel') def ev_drag_begin(self, context, a): return diff --git a/gramps2/src/NameEdit.py b/gramps2/src/NameEdit.py index cc6459ec9..bf9dbc2ef 100644 --- a/gramps2/src/NameEdit.py +++ b/gramps2/src/NameEdit.py @@ -237,7 +237,7 @@ class NameEditor: def on_help_clicked(self,*obj): """Display the relevant portion of GRAMPS manual""" - gnome.help_display('gramps-manual','gramps-edit-complete') + gnome.help_display('gramps-manual','adv-an') def on_name_edit_ok_clicked(self,obj): first = unicode(self.given_field.get_text())