summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex/RELEASE
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-04-02 23:32:37 +0000
committerKarl Berry <karl@freefriends.org>2011-04-02 23:32:37 +0000
commit765026f4d90f6962b8a1bf9e9aecb1d70ae95f0a (patch)
treeab3659349c7ccfc12252888783509905ea041761 /Master/texmf-dist/doc/latex/biblatex/RELEASE
parent5ef548762bb0e9f317aec1ec1e357e07caac1932 (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/RELEASE156
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