From e89b24e6b1451c2951c6bcbe74f29600043fd43d Mon Sep 17 00:00:00 2001 From: Alex Roitman Date: Sat, 12 Jul 2003 01:17:27 +0000 Subject: [PATCH] * doc/gramps-manual/C/gramps-manual.xml: More corrections. svn: r1870 --- ChangeLog | 1 + doc/gramps-manual/C/gramps-manual.xml | 253 +++++++++++++++----------- 2 files changed, 143 insertions(+), 111 deletions(-) diff --git a/ChangeLog b/ChangeLog index d5eade31e..965909529 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,6 +1,7 @@ 2003-07-11 Alex Roitman * src/plugins/IndivSummary.py (IndivSummary.__init__): Provide default value of 0 to newpage argument. + * doc/gramps-manual/C/gramps-manual.xml: More corrections. 2003-07-11 Donald Peterson * src/docgen/LaTeXDoc.py: Added UNICODE support and '&' handling diff --git a/doc/gramps-manual/C/gramps-manual.xml b/doc/gramps-manual/C/gramps-manual.xml index 992e21f59..a38f492b4 100644 --- a/doc/gramps-manual/C/gramps-manual.xml +++ b/doc/gramps-manual/C/gramps-manual.xml @@ -101,6 +101,9 @@ Alex Roitman shura@alex.neuro.umn.edu + + Donald A. Peterson + dpeterson@sigmaxi.org GRAMPS Project @@ -294,7 +297,7 @@ If you would like to open an existing database, check the top radio - button and click OK. You will then be asked to + button and click the OK button. You will then be asked to 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 database. @@ -418,7 +421,7 @@ progressbar, on the very bottom of the &app; window. It displays information about current &app; 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 Preferences dialog. Display area @@ -541,19 +544,19 @@ filter is set to the trivial filter called All people, i.e. no filtering is in effect. To choose a filter, use the pop-up Filter menu above the - people's list. Once the filter is chosen, click - Apply in the upper right corner of the - window. The filtering will take effect upon clicking - Apply. To invert the filtering rule, check - the Invert box on the left + people's list. Once the filter is chosen, click the + Apply button in the upper right corner of the + window. The filtering will take effect upon clicking the + Apply button. To invert the filtering rule, + check the Invert box on the left of Apply button. Example: To show people without children, choose People with children filter, then check - Invert box, and then click - Apply. To cancel any filtering, set + Invert box, and then click the + Apply button. To cancel any filtering, set the filter to All people - and then click Apply. + and then click the Apply button. Note: even if the filter controls are not displayed ( View @@ -630,7 +633,7 @@ on the bottom). Both list boxes have a set of three buttons on their right side. The + and - buttons allow you to add and remove parents of the Active person and the - Current spouse, respectively. Clicking -> + Current spouse, respectively. Clicking the right arrow button makes the family in the corresponding list box an active family. That is, it makes the selected Father the Active person, and the selected Mother the Current spouse. @@ -794,10 +797,10 @@ or click the Open button on the Toolbar. The Open Database dialog will appear. Either type the full path into the Database text - entry field, or click Browse... to get the - Open File dialog in which you can select the file - that you want to open. After you have selected the file, click - OK to open it. + entry field, or click the Browse... button to get + the Open File dialog in which you can select the + file that you want to open. After you have selected the file, click the + OK button to open it. If you have previously opened files with &app; you can retrieve your past selections @@ -829,8 +832,8 @@ Saving a Database To save changes made to your database, choose File - Save or click - Save on the Toolbar. The Status line will then + Save or click the + Save button on the Toolbar. The statusbar will then display the Saving filename... message, and the progressbar will advance as the saving progresses. @@ -845,6 +848,18 @@ available as items of File Import submenu. + 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 . + 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 . + + Note that the difference between opening &app; database and importing from &app; database is that importing incorporates all the data into your currently open database, if any. @@ -891,7 +906,7 @@ 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 Remove Object button. This will alter your 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 @@ -901,14 +916,14 @@ To keep the reference to the object corresponding to the missing - file, click Keep Reference button. + file, click the Keep Reference button. 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 to copy it into your database directory. Choose this option if the replacement is possible, but not available right now. - To supply the missing file during import, click + To supply the missing file during import, click the Select File button. This will copy the file you 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 @@ -945,7 +960,7 @@ Type the desired GEDCOM filename into the text entry box or - click Browse... to evoke the + click the Browse... button to evoke the Save File dialog. Use the Filter pop-up menu to limit the scope of the export according to the stated rule. Choose the desired Encoding of the exported file. @@ -982,9 +997,9 @@ 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 burn:/// location in Nautilus. After exporting to - CD, go to burn:/// location by + CD, go to the burn:/// location by selecting Go CD Creator in Nautilus menu. Your database directory will show up. To record it onto the CD, click the CD @@ -1009,8 +1024,8 @@ To remove the object corresponding to the missing file as well as all the references to that object from various database records, click - Remove Object button. This will alter your - database so that it will be in a consistent state, but all the + the Remove Object button. This will alter your + 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 file is irrevocably lost and there is no possibility of ever replacing it. @@ -1018,14 +1033,14 @@ To keep the reference to the object corresponding to the missing - file, click Keep Reference button. - This will leave things as is, i.e. in an inconsistent state. + file, click the Keep Reference button. + 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 to copy it into your database directory. Choose this option if the replacement is possible, but not available right now. - To supply the missing file during export, click + To supply the missing file during export, click the Select File button. This will copy the file you 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 @@ -1058,7 +1073,7 @@ Person Dialog (see 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 Edit on the toolbar. + and then click the Edit icon on the toolbar. @@ -1128,12 +1143,12 @@ To add images related to a single person, switch to the People View (), select a person, and - then click Edit on the toolbar to invoke - the Edit Person Dialog + then click the Edit icon on the toolbar to + invoke the Edit Person Dialog (). Then, select the - Gallery tab, and click - Add... to invoke the Select a media - object dialog. Type filename or select a file with the + Gallery tab, and click the + Add... button to invoke the Select a media + object dialog. Type the filename or select a file with the image, then provide a title for that image. To prevent the file from being copied into your database directory, check the Do not make a local copy box. Keep adding images until you are @@ -1141,23 +1156,26 @@ To add images related to a relationship (e.g. marriage), switch to the Family View () and then - double click on the Spouse box invoke the Marriage/Relationship + double-click on the Spouse box invoke the Marriage/Relationship editor dialog. Select the Gallery - tab and click Add... to add an image. + tab and click the Add... button to add + an image. To add images related to a source or a place, first switch to the Sources View () or Places View (), respectively. Then select the - appropriate source or place and then either double click on it - or click Edit on the toolbar to invoke the + appropriate source or place and then either double-click on it + or click the Edit icon on the toolbar to invoke the Source Editor (or Place Editor) dialog. Select the Gallery - tab and click Add... to add an image. + tab and click the Add... button to add + an image. Finally, to add images that are generally related to the database but not limited to any person, relationship, source, or place in particular, switch to the Media View (). - Then click Add on the toolbar to add an image. + Then click the Add icon on the toolbar to + add an image. If you have already added any images to any individual galleries, you will also find them listed in the Media View. @@ -1167,7 +1185,7 @@ galleries removing the reference to the image does not remove the image from the database. To completely remove the image from the database, delete it from Media View by first selecting it and then - clicking Remove on the toolbar. + clicking the Remove icon on the toolbar. @@ -1178,15 +1196,16 @@ To add a source or a place to the database, switch to the appropriate Sources View () or Places View (). - Then click Add on the toolbar to add a + Then click the Add icon on the toolbar to add a source/place. Enter the information into the Source Editor (or Place Editor) dialog. To edit information about sources and places already present in the database, switch to the appropriate view, select an entry - you would like to view/modify, and then click - Edit on the toolbar. + you would like to view/modify, and then click the + Edit icon on the toolbar. Alternatively, you + may double-click on the entry to edit it. @@ -1206,8 +1225,8 @@ 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 - Edit on the toolbar. + to edit, or select the name by single click and then click the + Edit icon on the toolbar. From the Family View: Move the mouse into the Active person box, @@ -1234,9 +1253,10 @@ 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 - Cancel buttons. Clicking OK + Cancel buttons. Clicking the + OK button at any time will apply all the changes made in all tabs and close the - dialog window. Clicking Cancel at any time will + dialog window. Clicking the Cancel button at any time will close the window without 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 without saving changes, canceling the @@ -1263,7 +1283,7 @@ and death. Some of these (Family name, Type, and both Place fields), 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 available menu choices are formed from the information already stored in the database. Also, when you start to type within these fields, @@ -1273,7 +1293,7 @@ the next field, press the Tab. - The Gender radio buttons offers + The Gender radio buttons offer the choice of person's gender between male, female, and unknown. The buttons Source... and @@ -1283,9 +1303,10 @@ birth and death Date fields allows you to edit the corresponding events of birth and death. The field ID displays an internal - &app; ID number which identifies user in the + &app; ID number which identifies the user in the database. Finally, the Image area shows the first - image available in the Gallery of this person. + image available in the Gallery of this + person (if any exist). @@ -1406,6 +1427,10 @@ Delete buttons become available only when an address is selected from the list. + + Some reports allow you to restrict data on living people. + In particular, that option will omit the addresses of people who + are currently alive. @@ -1449,7 +1474,7 @@ The Gallery tab displays information about media objects associated with the person and controls allowing subsequent 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 generic &app; icon is displayed instead. Note that the first available image in the gallery will be also displayed in the @@ -1460,6 +1485,11 @@ to this person. Note that the Edit... and Remove buttons become available only when a media object is selected from the list. + + + 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. @@ -1617,9 +1647,10 @@ 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 - Cancel buttons. Clicking OK + Cancel buttons. Clicking the + OK button at any time will apply all the changes made in all tabs and close the - dialog window. Clicking Cancel at any time will + dialog window. Clicking the Cancel button at any time will close the window without 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 without saving changes, canceling the @@ -1732,7 +1763,7 @@ Edit 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 Edit on the toolbar to invoke the + click the Edit icon on the toolbar to invoke the following Source Editor dialog: @@ -1751,10 +1782,10 @@ 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 Cancel buttons. Clicking - OK at any time will apply all the changes made - in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without + 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. If any of the data in any tab were modified, the alert window will appear with the choices of closing the dialog without saving changes, canceling the initial cancel request, or saving @@ -1829,7 +1860,7 @@ Edit 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 Edit on the toolbar to invoke the + click the Edit icon on the toolbar to invoke the following Place Editor dialog: @@ -1848,9 +1879,9 @@ 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 Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without + 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. If any of the data in any tab were modified, the alert window will appear with the choices of closing the dialog 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 the appropriate tab heading. The bottom part has OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without + 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. If any of the data in any tab were modified, the alert window will appear with the choices of closing the dialog 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 editing by clicking on the appropriate tab heading. The bottom part has OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without + 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. If any of the data in any tab were modified, the alert window will appear with the choices of closing the dialog without saving changes, canceling the initial cancel request, or saving @@ -2178,9 +2209,9 @@ The top of the window shows the dialog title. The central part displays the source information. The bottom part has OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made and close the dialog window. Clicking - Cancel at any time will close the window without + Clicking the OK button at any time will apply all the + changes made and close the dialog window. Clicking the + Cancel button at any time will close the window without applying any changes. If any of the data were modified, the alert window will appear with the choices of closing the dialog 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 top for viewing or editing by clicking on the appropriate tab heading. The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without + 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. If any of the data in any tab were modified, the alert window will appear with the choices of closing the dialog 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 top for viewing or editing by clicking on the appropriate tab heading. The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without + 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. If any of the data in any tab were modified, the alert window will appear with the choices of closing the dialog 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 top for viewing or editing by clicking on the appropriate tab heading. The bottom part has OK and - Cancel buttons. Clicking - OK at any time will apply all the - changes made in all tabs and close the dialog window. Clicking - Cancel at any time will close the window without + 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. If any of the data in any tab were modified, the alert window will appear with the choices of closing the dialog without saving changes, canceling the initial cancel request, or saving @@ -2446,9 +2477,9 @@ The top of the window shows the dialog title. The central part of the window displays information about the witness. The bottom part has OK and Cancel buttons. - Clicking OK at any time will apply all the - changes made and close the dialog window. Clicking - Cancel at any time will close the window + Clicking the OK button at any time will apply all the + changes made and close the dialog window. Clicking the + Cancel button at any time will close the window without applying any changes. If any of the data were modified, the alert window will appear with the choices of closing the dialog without saving changes, canceling the initial cancel @@ -2462,10 +2493,10 @@ Person from the database If the person's data are stored in a database, check Person - is in the database box. Then click + is in the database box. Then click the Select button to evoke Select Person dialog. Choose the person from that dialog and - click OK. The Person + click the OK button. The Person text field will display the name of the person you selected. Note: even though the person's name is displayed in the Person field, it is not available for direct @@ -2513,7 +2544,7 @@ 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 - a newly merged person, click Merge and edit + a newly merged person, click the Merge and edit button. @@ -2590,7 +2621,7 @@ 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. To make a child of currently active person (if any) @@ -2624,8 +2655,8 @@ Settings Default Person. Once this is done, you can move to the default person from anywhere in the - database by simply clicking Home on the - toolbar. + database by simply clicking the Home icon + on the toolbar. @@ -2728,8 +2759,8 @@ Report. Alternatively, you can browse the complete selection of available reports along with their brief descriptions in a Report - Selection dialog evoked by clicking - Reports on the toolbar. + Selection dialog evoked by clicking the + Reports icon on the toolbar. @@ -2765,22 +2796,22 @@ the order they will appear in the book. The top set of buttons between the panes operates on the - selected book item. Click Add to add selected - item from the available list to the current book. Click - Remove to remove an item from the current book. + selected book item. Click the Add button to add selected + item from the available list to the current book. Click the + Remove button to remove an item from the current book. Use Up and Down to change - the items order in the current book. Click Setup - to configure the options of the selected item of the current book. + the items order in the current book. Click the Setup + button to configure the options of the selected item of the current book. The bottom set of buttons between the panes operates on the - whole book. Click Clear to clear all items from - the current book. Click Save to save the current + whole book. Click the Clear button to clear all items from + the current book. Click the Save button to save the current book (under the name typed in the Book name text entry field) for future use. Note that saving the book also saves the - configuration for each item. Click Open to load - the book from the list of previously saved books. Finally, click - Edit books to evoke the editable list of + configuration for each item. Click the Open button to load + the book from the list of previously saved books. Finally, click the + Edit books button to evoke the editable list of available books. @@ -3011,8 +3042,8 @@ Tool. Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a Tool - Selection dialog evoked by clicking - Tools on the toolbar. + Selection dialog evoked by clicking the + Tools icon on the toolbar. @@ -3107,7 +3138,7 @@ When you launch it, the User defined filters dialog appears that lists all the filters (if any) previously defined - by you. Click Add... to define a new filter. + by you. Click the Add... button to define a new filter. Once you have designed your filters, you can edit, test, and delete selected filters using the Edit..., Test..., and Delete... @@ -3115,7 +3146,7 @@ automatically saved along with your database and will be available with subsequent sessions of &app;. - Clicking Add... invokes the + Clicking the Add... button invokes the following Define filter dialog: @@ -3367,7 +3398,7 @@ - Status bar + Statusbar Select the desired contents displayed in the statusbar using the radio buttons.