Terry's TMG Tips

Customizing the "Children of" Statement

This page created 28 Dec 2007

Version note: Applies to TMG 7

TMG's Journal reports include a list of the children of the focus person, which is introduced with statement similar to:

Children of John Jones and Mary White were as follows:

If there are no children of the couple in the Data Set, a statement like this appears:

There were no children of John Jones and Mary White.

There are several report options to modify these statements, which apply to everyone in the report. A new feature introduced in TMG 7 allows the user to construct a custom statement for each couple. The following sections describe how the new feature works, and provides some tips on how to use it.

The Standard Statement

By default, the statement which introduces the list of children takes the following form:

Children of John Jones and Mary White are as follows:

If none of the children in the list are living (all have their Living Flag set to N), "are" is changed to "were":

Children of John Jones and Mary White were as follows:

If only one parent is connected to the children, the other parent is shown as "an unknown spouse":

Children of John Jones and an unknown spouse are as follows:

If there are no children of the couple in the Data Set, a statement like this appears:

There were no children of John Jones and Mary White.

Report Options

Three report options modify these statements. You must first check "Custom Format" on the General tab of the report Options screen to be able to change these options.

Checking "Count Children" on the Miscellaneous tab adds the number of children entered in the Data Set to the statement:

The three children of John Jones and Mary White are as follows:

Checking the "Children are 'known children' " option adds the word "known" to the statement:

Known children of John Jones and Mary White were as follows:

The three known children of John Jones and Mary White are as follows:

There were no known children of John Jones and Mary White.

Checking the "Group common birth places" option removes the children's place of birth from their individual sections in the list when they are all the same, and adds it to the "Children of..." statement:

Children of John Jones and Mary White, all born in Chico, California, are as follows:

These options apply to every couple in the report. They generally work well for a small, well researched family group. But a number of situations can make these options less than ideal. For example, if the report includes both well researched individuals and perhaps some more distant cousins for whom the research is less complete, it is difficult to make a good choice. Choosing the "known children" option acknowledges that your research is incomplete for the distant branches, but reporting that your sibling had "three known children" may cause readers to wonder if you are tying to say something you didn't intend. The new NarrativeChildren Tag Type allows for a customized statement to be created for those couples for whom the standard statement is inappropriate.

The NarrativeChildren Tag

A new special Tag Type, NarrativeChildren, was added in TMG 7. This Tag Type will be present in any new Data Set created in version 7. It is added to the Data Sets in any Project created with a prior version when the Project is transferred to version 7.

When a NarrativeChildren Tag is created for a couple, the output of that tag is substituted for the standard "Children of..." statement in Journal Reports. Both parents (or spouses) must be entered in the tag as Principals. If a person has multiple spouses, a separate NarrativeChildren tag must be created for each couple for whom you want a custom "Children of..." statement. If there are children for whom the other parent is unknown, a NarrativeChildren tag would be created with just the one Principal to create a custom statement for those children.

The NarrativeChildren Tag is used to replace the standard "Children of..." statement only if it is marked as Primary for both Principals. And, of course, it serves this special function only in Journal reports. In all other respects, it is a standard Tag in the Other Event group, and follows all of the rules for such Tags. For example:

• If you add NarrativeChildren Tags to people in your Data Set and create reports other than Journals, the Tag may appear in those reports. Depending upon how you have constructed the Tag, it may or may not produce useful results in those reports. If you don't want it appear in those reports, in report Options,on the Tags tab, choose "Selected" under "Tag Types" and then make sure the NarrativeChildren Tag Type does not have a check mark.

• All the standard rules for creating Sentences apply. See the "Creating Useful Sentences" section below for special considerations on creating sentences that will work as intended.

• There are separate Sentences for each Principal. The Sentence associated with the Principal who is the focus of the report section is used in that section. If the Sentence for the other Principal is different, it is used when that person is the focus of the report.

• The NarrativeChildren Tag Type will only function if included in the report in the "Tag Types" section on the Tags tab of report Options, either by selecting "All" tag types, or if "Selected" tag types is selected, by making sure the Tag Type has a check mark.

• When the NarrativeChildren Tag used for it's intended purpose in Journals, the Sort Date has no effect other than controlling the location of the Tag in the Person View. Sort Dates do control the location of the Tag in other report types, and for any non-primary Tags in the Journal.

• You can add Witnesses to the Tag, although it is not clear to me how that would be useful. If Witnesses are included, there will be output in narratives for those Witnesses unless you exclude the Witness Sentence by placing an exclusion mark (hyphen) as the first character of the Sentence, or set the report to exclude witnessed events.

The NarrativeChildren Tag Type can be renamed, for example to place a period as the first character so it sorts to the top of the list of tags. If you create copies of the Tag Type, the copies will not have the special function; only the original will replace the standard "Children of..." statement.

From the above, it may be apparent that the NarrativeChildren feature should be considered an advanced feature. It is certainly possible to create unexpected results with it, for example by having it appear as a regular tag in reports other than the Journal, or by creating non-primary Tags.

Creating Useful Sentences

The default Sentence for the NarrativeChildren Tag creates approximately the same output as the standard "Children of..." sentence, although it does not provide the variations described in the "The Standard Statement" and "Report Options" sections above. To be of any real use, the Sentence must be modified to suit whatever purpose one has in mind. The following considerations apply when constructing Sentences for the NarrativeChildren tag:

• The standard "Children of..." statement is indented. Generally one would want the custom statements to match, so "tab" code would be included:

  [:TAB:]The children of [P] and [PO] were as follows:[:NP:]

• TMG normally deletes a final colon from sentence output and replaces it with a period. If the desired output is to end with a colon, the "no period" code must be included:

  [:TAB:]The children of [P] and [PO] were as follows:[:NP:]

• If one wants to replicate the "Group common birth places" feature of the standard statement, there is a special code to remove the birth places from the children's text in the list. An example of its use would be:

  [:TAB:]The children of [P] and [PO]<, all born in [L],[:NoBirthPlaces:]> were as follows:[:NP:]

• All normal Sentence variables can be used. So it is possible to specify first names instead of full names for the parents, include information from the Date, Place, or Memo fields, or even refer to Witness, for example.

It seems to me that the best use of this feature is to first decide on a set of report options (see "Report Options" section above) that suits one's preferences and produces satisfactory results for the majority of the people in the Project. Then, design Sentences for the NarrativeChildren tag that produces output consistent with the options selected, and add the tag to those couples for whom the standard statement produces unsatisfactory results.

Note that Sentence Structures can only be edited in Advanced Data Entry mode. They cannot be modified in Beginner mode, nor are they visible on the Tag Entry screen. To change to Advanced mode, select that mode in Preferences > Program Options > Data Entry. For more on editing Sentences, see my article on Modifying Tag Sentence Structures.

Creating Standard Roles

It may be possible to create a single standard Sentence for the NarrativeChildren Tag Type that meets all one's needs for custom "Children of..." statements. But doing so seriously limits the range of applications. For example, one could not create both statements for couples with children and for those with no children. One could overcome this difficulty by editing the Sentence in individual tags locally. Not only is that a lot of work, but it is difficult to maintain consistent wording in similar cases over a long period of data entry.

I believe the best solution is to create a set of Roles, each designed to be applied to a specific situation. Then simply apply the appropriate Role to each tag to generate the desired statements. Those not familiar with use of Roles may find my Roles Tutorial helpful. The following are some Roles I have developed in early experimentation, which may offer some ideas on potential use of the feature:

Generally, the same Role would be selected for both Principals. Note that when a Role is selected for one Principal in a tag, the next Role on the list is automatically applied to the other. The user must then manually apply the correct Role to the second Principal.

Copyright 2000-2008