Skip to content

Commit 862f495

Browse files
committed
Update description effects name disambiguation on the bibliography
1 parent ee89ee2 commit 862f495

File tree

1 file changed

+17
-11
lines changed

1 file changed

+17
-11
lines changed

specification.txt

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1566,15 +1566,13 @@ document.
15661566
The four disambiguation methods can be individually activated with the following
15671567
optional attributes:
15681568

1569-
``disambiguate-add-names`` [Step (1)]
1569+
``disambiguate-add-names`` [Method (1)]
15701570
If set to "true" ("false" is the default), names that would otherwise be
15711571
hidden as a result of et-al abbreviation are added one by one to all members
15721572
of a set of ambiguous cites, until no more cites in the set can be
1573-
disambiguated by adding names. If necessary to render the disambiguating
1574-
names in the bibliography, et-al abbreviation in the corresponding
1575-
bibliographic entries is similarly relaxed for the affected name variables.
1573+
disambiguated by adding names.
15761574

1577-
``disambiguate-add-givenname`` [Step (2)]
1575+
``disambiguate-add-givenname`` [Method (2)]
15781576
If set to "true" ("false" is the default), ambiguous names (names that are
15791577
identical in their "short" or initialized "long" form, but differ when
15801578
initials are added or the full given name is shown) are expanded. Name
@@ -1593,10 +1591,7 @@ optional attributes:
15931591
hidden as a result of et-al abbreviation after the disambiguation attempt of
15941592
``disambiguate-add-names`` are added one by one to all members of a set of
15951593
ambiguous cites, until no more cites in the set can be disambiguated by
1596-
adding expanded names. If necessary to render the disambiguating expanded
1597-
names in the bibliography, the affected name variables in the corresponding
1598-
bibliographic entries are similarly subjected to name expansion and
1599-
relaxation of et-al abbreviation.
1594+
adding expanded names.
16001595

16011596
``givenname-disambiguation-rule``
16021597
Specifies a) whether the purpose of name expansion is limited to
@@ -1653,10 +1648,21 @@ optional attributes:
16531648
affected, and disambiguation stops after the first name that
16541649
eliminates cite ambiguity.
16551650

1651+
In the description of disambiguation methods (1) and (2) above, we assumed that
1652+
each (disambiguated) cite has an unambiguous link to its bibliographic entry. To
1653+
assure that each cite does in fact uniquely identify its entry in the
1654+
bibliography, detail that distinguishes cites (such as names, initials, and full
1655+
given names) must be shown in the corresponding bibliography entries. If this is
1656+
not the case, disambiguation methods (1) and (2) also act on all members of a
1657+
set of ambiguously cited bibliographic entries, until no more entries in the set
1658+
can be unambiguously cited by adding (expanded) names. Each method only takes
1659+
effect on the involved bibliographic entries after it has been used to
1660+
disambiguate cites.
1661+
16561662
A disambiguation attempt can also be made by rendering ambiguous cites with the
1657-
``disambiguate`` condition testing "true" [Step (3)] (see `Choose`_).
1663+
``disambiguate`` condition testing "true" [Method (3)] (see `Choose`_).
16581664

1659-
``disambiguate-add-year-suffix`` [Step (4)]
1665+
``disambiguate-add-year-suffix`` [Method (4)]
16601666
If set to "true" ("false" is the default), an alphabetic year-suffix is
16611667
added to ambiguous cites (e.g. "Doe 2007, Doe 2007" becomes "Doe 2007a, Doe
16621668
2007b") and to their corresponding bibliographic entries. This final

0 commit comments

Comments
 (0)