diff --git a/ChangeLog b/ChangeLog index d6311e70a..ac8a3909a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,4 +1,5 @@ 2006-06-23 Don Allingham + * help/C/gramps-manual.xml: updates * src/GrampsDb/_ReadXML.py: fix syntax error with old ref formats 2006-06-22 Don Allingham diff --git a/help/C/figures/family-list.png b/help/C/figures/family-list.png new file mode 100644 index 000000000..d95293180 Binary files /dev/null and b/help/C/figures/family-list.png differ diff --git a/help/C/gramps-manual.xml b/help/C/gramps-manual.xml index e3a83954e..5e002fa26 100644 --- a/help/C/gramps-manual.xml +++ b/help/C/gramps-manual.xml @@ -931,23 +931,28 @@ When GRAMPS opens a database, no filtering is in effect. In People View, for example, all people in the database are listed by - default. + default. - - Family View + + Relationships View - The Family View displays the family information of a selected - person that we call the Active person. Specifically, it shows his or - her closest relationships. + The Relationships View displays the family relationships of a + selected person that we call the Active person. Specifically, it shows + his or her parents, spouses, and children. + + The Relationships View is designed to allow for quick + navigation. You can quickly change the selected person simply by + clicking the name of any person listed on the page. Each name is + actually a hypertext link, similar to a web page.
- Family View + Relationsihps View @@ -957,7 +962,7 @@ - Shows Family View. + Shows Relationships View. @@ -965,99 +970,104 @@ - The Family View displays the following series of list - boxes: + The Relationships View displays the following sections: Active person - Shows birth and death data for the individual you have - selected. Double-click inside the box to edit the Active - person's information. Click on the double arrow to the right and - the currently selected Spouse will become the new Active - person. + At the top of the screen, name, ID, birth, and death + information of the active person is displayed. If a photo of the + person is available, it is show on the right hand side. Next to + the person's name is a symbol indicating gender, and an Edit + button. Clicking the Edit button will + allow you to edit all of the person's individual information in + an Edit Person dialog. - Relationship + Parents - Displays birth and death data for the Active person's - Spouse(s). + The next sections display the person's parents and + siblings. Since it is possible to have multiple sets of parents, + it is possible to have several Parents sections. You can control + how much information is displayed by using the + View menu. The view menu allows you to show + or hide details (the birth and death information) and to show or + hide siblings. Next to each person listed is an + Edit button, which will allow you to edit + all the details of that particular person. - - Terminology + You may add, edit, or delete family information using the + buttons next to the Parents label. You can add a set of parents + by either selecting the Add button (the first button) or the + Select button (the second button). The + Add button will create a new family with + the active person listed as a child. The + Select button will allow you to choose + from a list of existing families, and then add the person as a + child to that family. - In the Family View, we use the term "spouse" for sake of - simplicity. However, please note that "spouse" may in fact be - a domestic partner, a partner in a civil union, etc. + + If you are not careful, it is possible to create + multiple families with the same parents. This is rarely what + the user wants to do. If you attempt to add a new family that + has the same parents as an existing family, GRAMPS will issue + a warning dialog. If you get this dialog, you should probably + Cancel the edit, and then use the + Select button to select the existing + family. + + + + + + Family + + + Similar to the Parents section is the Family section, + which displays families where the person is a parent. Because it + is possible to have mulitple familes, it is possible to have + multiple Family sections. Each family section displays the + spouse and any children. + + + We use the term spouse for sake of + simplicity. However, please note that + spouse may in fact be a domestic partner, + a partner in a civil union, or various other similar + relationships between two people. Spouse + relationships are not required to be only between a male and + female. - Double-click a Spouse to edit his or her relationship to - the Active person. Shift-click (that is, hold down the Shift key - while you click) a Spouse to edit his or her personal - information. Click the icon to the top right of the Relationship - box to add a new person to the database and to create a - relationship between this person and the Active person. Click - the middle icon to create a relationship between the Active - person and another person already stored in the database. Click - the minus (-) button to remove the relationship between the - currently selected Spouse and the Active person. (Note that this - does not remove the Spouse from the database.) - - + You may add, edit, or delete family information using the + buttons next to the Family label. You can add a spouse by + clicking the Add button (the first button), which will create a + new family with the active person listed as a father or mother. + Selecting the Edit button will allow you to edit the displayed + family. Clicking the Delete button will remove the person from + the displayed family. - - Active person's parents + + Removing a person from a family does not delete the + family. The person is removed as the father or mother, and any + other relationships in the family continue to exist. + - - Click the + or - - buttons to add or remove parents of the - Active person. Click the right arrow button to make the Father - the new Active person and the Mother the new Spouse. - - - - - Spouse's parents - - - This list box functions the same as that of the Active - person's parents. - - - - - Children - - - Displays the children of the Active person and the - currently selected Spouse. The list can be ordered however you - want by clicking on a column heading. - - Note that in addition to columns for Name, ID, Gender, - Birth Date, and Death Date, there is a column labeled Status.1 - This column reflects the relationship between the child and his - parents (Birth, Adoption, etc.). - - As with the other list boxes, the Children list box has - some associated buttons. Click the left arrow button to make the - selected Child the Active person. Click the next button down to - add a new person to the database and to make this person a Child - of the Active person. Click the next button down to select a - person from the database and to make this person a Child of the - Active person. Click the lowest button to remove the selected - Child from the Family (note that this does not remove the Child - from the database). - - - Right Click Menu - - Most of the functions described above can also be - executed by right-clicking your mouse. + + We use the terms father and + mother for the sake of simplicity. Even + if there are no children in a family, the + father and mother + terminology is still used. In the case of male/male or + female/female relationships, one of the + father and mother + labels should be considered to be convience labels, and should + be considered as interchangable. @@ -1066,14 +1076,52 @@ + + Family List View + + The Family List View displays a list of all families in the + database. From this view, you may add, edit, or delete families. The + default display lists the ID, Father, Mother, and Relationship. + Children cannot be displayed on the screen in this view. + + + +
+ Family List View + + + + + + + + + Family List View. + + + +
+ + + Unlike the Relationships View, clicking the Remove button in + this view will remove the family from the database. All people will + remain, but all relationships between the people in the family will + be removed. + + + + + Pedigree View The Pedigree View displays a family tree of the Active person's - ancestors. The Pedigree View shows up to five generations, depending + ancestors. The Pedigree View shows up to four generations, depending on the size of the window. Each person is indicated by a box labeled - with his or her name. Two lines branch from each box. The top one - shows the person's father and the bottom one the mother. Solid lines + with his or her name, birth and death information, and optionally an + image if available. Two lines branch from each box. The top one shows + the person's father and the bottom one the mother. Solid lines represent birth relations, while dashed lines represent non-birth relations such as adoption, step-parenthood, guardianship, etc. @@ -1098,10 +1146,19 @@ - If you move your mouse over a box, it expands to show birth and - death dates. If you move your mouse over a line, the line gets - highlighted, indicating an active link. Double-click the line to make - the corresponding ancestor the Active person. + To the left of the Active person is a left arrow button. If the + Active person has children, clicking this button expands a list of the + Active person's children. Selecting one of the children makes that + child the active Person. + + The appearance of the children's names in the menu + differentiates the "dead ends" of the tree from the continuing + branches. Children who have children themselves appear in the menu in + the boldface and italic type, while children without children ("dead + ends") appear in a regular font. If the Active person has only one + child, no menu will be displayed (since there is only one choice) and + the child will become the Active person when the arrow button is + clicked. @@ -1124,20 +1181,6 @@ - To the left of the Active person is a left arrow button. If the - Active person has children, clicking this button expands a list of the - Active person's children. Selecting one of the children makes that - child the pctive Person. - - The appearance of the children's names in the menu - differentiates the "dead ends" of the tree from the continuing - branches. Children who have children themselves appear in the menu in - the boldface and italic type, while children without children ("dead - ends") appear in a regular font. If the Active person has only one - child, no menu will be displayed (since there is only one choice) and - the child will become the Active person when the arrow button is - clicked. - The right-hand side of the window shows two right arrow buttons. When the top button is clicked, the Father of the Active person becomes the Active person. Clicking the bottom button makes the Mother @@ -4509,9 +4552,9 @@ Using the Family View - When in the Family View (see ), - you can easily navigate between the members of the displayed family as - follows: + When in the Family View (see ), you can easily navigate between the + members of the displayed family as follows: