diff options
author | Karl Berry <karl@freefriends.org> | 2011-04-02 23:32:37 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-04-02 23:32:37 +0000 |
commit | 765026f4d90f6962b8a1bf9e9aecb1d70ae95f0a (patch) | |
tree | ab3659349c7ccfc12252888783509905ea041761 /Master/texmf-dist/doc/latex/biblatex/RELEASE | |
parent | 5ef548762bb0e9f317aec1ec1e357e07caac1932 (diff) |
biblatex 1.4 (1apr11)
git-svn-id: svn://tug.org/texlive/trunk@21926 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex/RELEASE')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/RELEASE | 156 |
1 files changed, 155 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex/RELEASE b/Master/texmf-dist/doc/latex/biblatex/RELEASE index 7dd2cdc82e1..f7f572872da 100644 --- a/Master/texmf-dist/doc/latex/biblatex/RELEASE +++ b/Master/texmf-dist/doc/latex/biblatex/RELEASE @@ -1,4 +1,158 @@ -$Id: RELEASE,v 1.3a 2011/03/18 12:20:20 lehman stable $ +$Id: RELEASE,v 1.4 2011/03/31 21:55:36 lehman stable $ + +RELEASE NOTES FOR VERSION 1.4 + +* Biber update + + Biblatex 1.4 requires Biber 0.9 or higher. It will not work with + any previous release. + +* Advanced name disambiguation in citations [Biber only] + + Name disambiguation in citations has been greatly improved and + extended in this release. We're pretty excited about this feature + because it has been in the pipeline for such a long time and + because Biblatex/Biber is, to the best of my knowledge, the only + bibliographic tool providing fully automated disambiguation of + names in citations. + + There are now two options controlling name disambiguation, + 'uniquename' and 'uniquelist'. You can use either option + stand-alone or combine both. This is best explained by way of + example. Consider the following data: + + John Smith/John Doe 2011 + John Smith/Jane Doe 2011 + John Smith/Edward Doe 2011 + + Let's assume we're using the standard 'authoryear' style and set + uniquename=false. In this case, we would get the following + citations: + + Smith and Doe 2011a + Smith and Doe 2011b + Smith and Doe 2011c + + The extra letter appended to the year (that's the automatically + generated 'extrayear' field provided by the 'labelyear' option) + disambiguates the citations. Many style guides, however, mandate + that the extra letter be used to disambiguate works by the same + author(s) only, not works by different author with the same last + name. In order to disambiguate the author's last name, you're + expected to add additional parts of the name, either as initials + or in full. This is what the 'uniquename' option does. Here are + the same citations with uniquename=init: + + Smith and J. Doe 2011a + Smith and J. Doe 2011b + Smith and E. Doe 2011 + + 'uniquename=init' restricts name disambiguation to initials. Since + the first two Does are still ambiguous at that point, we need to + fall back to 'extrayear'. With uniquename=full, names are printed + in full where required: + + Smith and John Doe 2011 + Smith and Jane Doe 2011 + Smith and E. Doe 2011 + + In the past, this feature was of limited use since it only worked + for entries with a single author/editor. It now works for any name + at any point in the list. Since this is only possible with Biber, + the feature has been removed entirely from the BibTeX backend. + + When it comes to lists of names, there's another aspect to + ambiguity. Let's call it list ambiguity. Consider the following + data: + + Doe/Jones/Smith 2011 + Smith/Johnson/Doe 2011 + Smith/Doe/Edwards 2011 + Smith/Doe/Jones 2011 + + Most author-year and author-title styles will truncate long + author/editor lists in citations. For example, with maxnames=1 + we'd get: + + Doe et al. 2011 + Smith et al. 2011a + Smith et al. 2011b + Smith et al. 2011c + + Since the author lists are ambiguous after truncation, the + 'extrayear' marker is added by the style in order to ensure unique + citations. Here again, many style guides mandate that the extra + letter be used to disambiguate works by the same authors only. In + order to disambiguate author lists, you're typically required to + add more names, exceeding the maxnames/minnames truncation point. + The new 'uniquelist' feature introduced in this release does that + automatically. With maxnames=1 and uniquelist=true, we get: + + Doe et al. 2011 + Smith, Johnson et al. 2011 + Smith, Doe and Edwards 2011 + Smith, Doe and Jones 2011 + + As seen above, the 'uniquelist' option overrides the 'maxnames' + setting on a per-entry basis. Essentially, what happens is that + the "et al." parts of the citations get expanded to the point of + no ambiguity -- but no further than that. + + 'uniquename' and 'uniquelist' may also be combined. Consider the + following data: + + John Doe/Jane Smith/William Jones 2011 + John Doe/John Smith/William Jones 2011 + John Doe/Edward Smith/William Jones 2011 + John Doe/John Edwards/William Jones 2011 + John Doe/John Edwards/Jack Johnson 2011 + + With maxnames=1: + + Doe et al. 2011a + Doe et al. 2011b + Doe et al. 2011c + Doe et al. 2011d + Doe et al. 2011e + + With maxnames=1, uniquename=true, uniquelist=true: + + Doe, Jane Smith et al. 2011 + Doe, John Smith et al. 2011 + Doe, E. Smith et al. 2011 + Doe, Edwards and Jones 2011 + Doe, Edwards and Johnson 2011 + + If multiple disambiguation options are active, names are + disambiguated first and works last. The order is as follows: + + 1. uniquename + 2. uniquelist + 3. extrayear, singletitle + + Adding this feature to existing styles is simple. The 'uniquename' + information needs to be evaluated in the name formatting directive + which controls the formatting of the 'labelname' list. The default + definition in biblatex.def is responsive to the 'uniquename' + option. If you're using that, just enable the package option and + that's it. If you're using a different format, check biblatex.def + on how to incorporate the 'uniquename' feature. + + Adding support for 'uniquelist' is also trivial. If the second + optional argument of \printnames is omitted (i.e., no explicit + range is specified), \printnames{labelname} will print the + 'labelname' list up to the truncation point defined with the + 'maxnames'/'minnames' package options. If 'uniquelist' is enabled, + it will simply override 'maxnames' on a per-entry basis, i.e., + \printnames will print the 'labelname' list up to point of no + ambiguity. Unless you're specifying explicit ranges, all you need + to do is enable the 'uniquelist' package option. + +* Name disambiguation in standard styles [Biber only] + + All standard author-year and author-title styles now enable + uniquename/uniquelist disambiguation. Of course this only works + when using Biber. RELEASE NOTES FOR VERSION 1.3 |