summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-06-09 21:54:09 +0000
committerKarl Berry <karl@freefriends.org>2011-06-09 21:54:09 +0000
commit72f05432d0e7fc04a5ed4eeba36c08908f08c000 (patch)
treecab2e328a232ff289d1506302be7b509e98c1138 /Master/texmf-dist/doc/latex/biblatex
parente8e307aa314bfbb7f7c67c14abd4e67ceb93fe12 (diff)
biblatex 1.5 (8jun11)
git-svn-id: svn://tug.org/texlive/trunk@22892 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/README6
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/RELEASE18
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.pdfbin841773 -> 854887 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.tex469
4 files changed, 386 insertions, 107 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex/README b/Master/texmf-dist/doc/latex/biblatex/README
index 0ef7ff5e137..9328f044651 100644
--- a/Master/texmf-dist/doc/latex/biblatex/README
+++ b/Master/texmf-dist/doc/latex/biblatex/README
@@ -1,4 +1,4 @@
-$Id: README,v 1.4c 2011/05/12 18:28:32 lehman stable $
+$Id: README,v 1.5 2011/06/08 18:45:46 lehman stable $
ABOUT
@@ -68,8 +68,8 @@ Strictly required:
Strongly recommended:
- Biber
-- csquotes 4.4 or later
- babel
+- csquotes 4.4 or later
Biber is available from CTAN or:
@@ -79,9 +79,11 @@ AUTOMATIC INSTALLATION
TeX Live: The biblatex package is included in TeX Live.
Use the TeX Live package manager to install it.
+ Biber can also be installed with the package manager.
MiKTeX: The biblatex package is included in MiKTeX.
Use the MiKTeX package manager to install it.
+ Biber can also be installed with the package manager.
SEMI-AUTOMATIC INSTALLATION
diff --git a/Master/texmf-dist/doc/latex/biblatex/RELEASE b/Master/texmf-dist/doc/latex/biblatex/RELEASE
index ced4cfdf42c..5db802a3067 100644
--- a/Master/texmf-dist/doc/latex/biblatex/RELEASE
+++ b/Master/texmf-dist/doc/latex/biblatex/RELEASE
@@ -1,4 +1,20 @@
-$Id: RELEASE,v 1.4c 2011/05/12 18:28:32 lehman stable $
+$Id: RELEASE,v 1.5 2011/06/08 18:45:46 lehman stable $
+
+RELEASE NOTES FOR VERSION 1.5
+
+* Biber update
+
+ Biblatex 1.5 requires Biber 0.9.3 or higher. It will not work with
+ any previous release.
+
+* More name disambiguation modes [Biber only]
+
+ We've added some additional modes to the 'uniquename' and
+ 'uniquelist' options. Roughly speaking, the new 'min*' modes aim
+ for unambiguous citations (mainly author-year) rather than
+ disambiguating names in a strict way. There's a section in the
+ manual which discusses all the details. See the changelog for
+ pointers to the relevant parts of the manual.
RELEASE NOTES FOR VERSION 1.4
diff --git a/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf b/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf
index 62010eccf56..fd5bf642852 100644
--- a/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex/biblatex.tex b/Master/texmf-dist/doc/latex/biblatex/biblatex.tex
index a1f2eabd04f..a2620276361 100644
--- a/Master/texmf-dist/doc/latex/biblatex/biblatex.tex
+++ b/Master/texmf-dist/doc/latex/biblatex/biblatex.tex
@@ -1,4 +1,4 @@
-% $Id: biblatex.tex,v 1.4c 2011/05/12 18:28:32 lehman stable $
+% $Id: biblatex.tex,v 1.5 2011/06/08 18:45:46 lehman stable $
\documentclass{ltxdockit}[2011/03/25]
\usepackage{btxdockit}
\usepackage[latin9]{inputenc}
@@ -12,7 +12,7 @@
\MakeAutoQuote*{<}{>}
\MakeShortVerb{\|}
-\rcsid{$Id: biblatex.tex,v 1.4c 2011/05/12 18:28:32 lehman stable $}
+\rcsid{$Id: biblatex.tex,v 1.5 2011/06/08 18:45:46 lehman stable $}
\newcommand*{\biber}{Biber\xspace}
\newcommand*{\biblatex}{Biblatex\xspace}
@@ -700,7 +700,7 @@ Another secondary editor performing a different role. Use the \bibfield{editorct
\fielditem{editortype}{key}
-The type of editorial role performed by the \bibfield{editor}. Roles supported by default are \texttt{editor}, \texttt{compiler}, \texttt{founder}, \texttt{continuator}, \texttt{redactor}, \texttt{collaborator}. The role <\texttt{editor}> is the default. In this case, the field is omissible. See \secref{bib:use:edr} for further hints.
+The type of editorial role performed by the \bibfield{editor}. Roles supported by default are \texttt{editor}, \texttt{compiler}, \texttt{founder}, \texttt{continuator}, \texttt{redactor}, \texttt{reviser}, \texttt{collaborator}. The role <\texttt{editor}> is the default. In this case, the field is omissible. See \secref{bib:use:edr} for further hints.
\fielditem{editoratype}{key}
@@ -1322,6 +1322,7 @@ The type of editorial role performed by an editor in one of the \bibfield{editor
\item[founder] The founding editor of a periodical or a comprehensive publication project such as a <Collected Works> edition or a long"=running legal commentary.
\item[continuator] An editor who continued the work of the founding editor (\texttt{founder}) but was subsequently replaced by the current editor (\texttt{editor}).
\item[redactor] A secondary editor whose task is redacting the work.
+\item[reviser] A secondary editor whose task is revising the work.
\item[collaborator] A secondary editor or a consultant to the editor.
\end{marglist}
%
@@ -2395,29 +2396,35 @@ Whether or not to provide the special fields \bibfield{labelyear} and \bibfield{
Whether or not to provide the data required by the \cmd{ifsingletitle} test, see \secref{aut:aux:tst} for details.
\BiberOnlyMark With Biber, this option is also settable on a per-type basis.
-\optitem[false]{uniquename}{\opt{true}, \opt{false}, \opt{init}, \opt{full},
-\opt{allinit}, \opt{allfull}}[\BiberOnly]
+\optitem[false]{uniquename}{\opt{true}, \opt{false}, \opt{init}, \opt{full}, \opt{allinit}, \opt{allfull},
+\opt{mininit}, \opt{minfull}}[\BiberOnly]
-Whether or not to set the \cnt{uniquename} counter, see \secref{aut:aux:tst} for details.
-This feature will disambiguate individual names in the \bibfield{labelname} list.
-It is useful in citation styles which add initials or other parts of the name when citing different authors with the same last name.
-This option is also settable on a per-type basis.
-The possible choices are:
+Whether or not to update the \cnt{uniquename} counter, see \secref{aut:aux:tst} for details. This feature will disambiguate individual names in the \bibfield{labelname} list. This option is also settable on a per-type basis. The possible choices are:
\begin{valuelist}
\item[true] An alias for \opt{full}.
\item[false] Disable this feature.
-\item[init] Try to disambiguate names using initials only.
-\item[full] Try to disambiguate names using initials or full names, as required.
+\item[init] Disambiguate names using initials only.
+\item[full] Disambiguate names using initials or full names, as required.
\item[allinit] Similar to \opt{init} but disambiguates all names in the \bibfield{labelname} list, beyond \opt{maxnames}\slash \opt{minnames}\slash \opt{uniquelist}.
\item[allfull] Similar to \opt{full} but disambiguates all names in the \bibfield{labelname} list, beyond \opt{maxnames}\slash \opt{minnames}\slash \opt{uniquelist}.
+\item[mininit] A variant of \texttt{init} which only disambiguates names in lists with identical last names.
+\item[minfull] A variant of \texttt{full} which only disambiguates names in lists with identical last names.
\end{valuelist}
%
-If the citation style merely uses initials to disambiguate names and will never print the full name in citations, set the option to \texttt{init}\slash \texttt{allinit} rather than \texttt{full}\slash \texttt{allfull}. This difference is crucial because the state of this option will also affect the \cmd{ifsingletitle} test and the \bibfield{extrayear} field. Do not set the option to \texttt{true} in citation styles which only print initials to disambiguate names.
+Note that the \opt{uniquename} option will also affect \opt{uniquelist}, the \cmd{ifsingletitle} test, and the \bibfield{extrayear} field. See \secref{aut:cav:amb} for further details and practical examples.
+
+\optitem[false]{uniquelist}{\opt{true}, \opt{false}, \opt{minyear}}[\BiberOnly]
-\boolitem[false]{uniquelist}[\BiberOnly]
+Whether or not to update the \cnt{uniquelist} counter, see \secref{aut:aux:tst} for details. This feature will disambiguate the \bibfield{labelname} list if it has become ambiguous after \opt{maxnames}\slash \opt{minnames} truncation. Essentially, it overrides \opt{maxnames}\slash \opt{minnames} on a per-field basis. This option is also settable on a per-type basis. The possible choices are:
-Whether or not to set the \cnt{uniquelist} counter, see \secref{aut:aux:tst} for details. This feature will disambiguate the \bibfield{labelname} list if it is ambiguous after \opt{maxnames}\slash \opt{minnames} truncation. Essentially, it overrides \cnt{maxnames} on a per-entry basis. This option is also settable on a per-type basis.
+\begin{valuelist}
+\item[true] Disambiguate the \bibfield{labelname} list.
+\item[false] Disable this feature.
+\item[minyear] Disambiguate the \bibfield{labelname} list only if the truncated list is identical to another one with the same \bibfield{labelyear}. This mode of operation is useful for author-year styles and requires \kvopt{labelyear}{true}.
+\end{valuelist}
+%
+Note that the \opt{uniquelist} option will also affect the \cmd{ifsingletitle} test and the \bibfield{extrayear} field. See \secref{aut:cav:amb} for further details and practical examples. See \secref{aut:cav:amb} for further details and practical examples.
\end{optionlist}
@@ -2559,37 +2566,37 @@ This style implements an alphabetic citation scheme similar to the \path{alpha.b
A verbose variant of the \texttt{alphabetic} style. The difference affects the handling of a list of citations and is only apparent when multiple entry keys are passed to a single citation command. For example, instead of «[Doe92; Doe95; Jon98]» this style would print «[Doe92]; [Doe95]; [Jon98]». It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelalpha}{true}.
\item[authoryear]
-This style implements an author"=year citation scheme. If the bibliography contains two or more works by the same author which were all published in the same year, a letter is appended to the year. For example, this style would print citations such as «Doe 1995a; Doe 1995b; Jones 1998». This style should be employed in conjunction with an author"=year bibliography style which prints the corresponding labels in the bibliography. It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}.
+This style implements an author"=year citation scheme. If the bibliography contains two or more works by the same author which were all published in the same year, a letter is appended to the year. For example, this style would print citations such as «Doe 1995a; Doe 1995b; Jones 1998». This style should be employed in conjunction with an author"=year bibliography style which prints the corresponding labels in the bibliography. It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}.
\item[authoryear-comp]
-A compact variant of the \texttt{authoryear} style which prints the author only once if subsequent references passed to a single citation command share the same author. If they share the same year as well, the year is also printed only once. For example, instead of «Doe 1995b; Doe 1992; Jones 1998; Doe 1995a» this style would print «Doe 1992, 1995a,b; Jones 1998». It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{labelyear}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}.
+A compact variant of the \texttt{authoryear} style which prints the author only once if subsequent references passed to a single citation command share the same author. If they share the same year as well, the year is also printed only once. For example, instead of «Doe 1995b; Doe 1992; Jones 1998; Doe 1995a» this style would print «Doe 1992, 1995a,b; Jones 1998». It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}.
\item[authoryear-ibid]
-A variant of the \texttt{authoryear} style which replaces repeated citations by the abbreviation \emph{ibidem} unless the citation is the first one on the current page or double-page spread, or the \emph{ibidem} would be ambiguous in the sense of the package option \kvopt{ibidtracker}{constrict}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
+A variant of the \texttt{authoryear} style which replaces repeated citations by the abbreviation \emph{ibidem} unless the citation is the first one on the current page or double-page spread, or the \emph{ibidem} would be ambiguous in the sense of the package option \kvopt{ibidtracker}{constrict}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
\item[authoryear-icomp]
-A style combining \texttt{authoryear-comp} and \texttt{authoryear-ibid}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
+A style combining \texttt{authoryear-comp} and \texttt{authoryear-ibid}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
\item[authortitle]
-This style implements a simple author"=title citation scheme. It will make use of the \bibfield{shorttitle} field, if available. It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}.
+This style implements a simple author"=title citation scheme. It will make use of the \bibfield{shorttitle} field, if available. It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}.
\item[authortitle-comp]
-A compact variant of the \texttt{authortitle} style which prints the author only once if subsequent references passed to a single citation command share the same author. For example, instead of «Doe, \emph{First title}; Doe, \emph{Second title}» this style would print «Doe, \emph{First title}, \emph{Second title}». It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{sortcites}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}.
+A compact variant of the \texttt{authortitle} style which prints the author only once if subsequent references passed to a single citation command share the same author. For example, instead of «Doe, \emph{First title}; Doe, \emph{Second title}» this style would print «Doe, \emph{First title}, \emph{Second title}». It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{sortcites}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}.
\item[authortitle-ibid]
-A variant of the \texttt{authortitle} style which replaces repeated citations by the abbreviation \emph{ibidem} unless the citation is the first one on the current page or double-page spread, or the \emph{ibidem} would be ambiguous in the sense of the package option \kvopt{ibidtracker}{constrict}. It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
+A variant of the \texttt{authortitle} style which replaces repeated citations by the abbreviation \emph{ibidem} unless the citation is the first one on the current page or double-page spread, or the \emph{ibidem} would be ambiguous in the sense of the package option \kvopt{ibidtracker}{constrict}. It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
\item[authortitle-icomp]
-A style combining the features of \texttt{authortitle-comp} and \texttt{authortitle-ibid}. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
+A style combining the features of \texttt{authortitle-comp} and \texttt{authortitle-ibid}. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
\item[authortitle-terse]
-A terse variant of the \texttt{authortitle} style which only prints the title if the bibliography contains more than one work by the respective author\slash editor. This style will make use of the \bibfield{shorttitle} field, if available. It is suitable for in-text citations as well as citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{singletitle}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}.
+A terse variant of the \texttt{authortitle} style which only prints the title if the bibliography contains more than one work by the respective author\slash editor. This style will make use of the \bibfield{shorttitle} field, if available. It is suitable for in-text citations as well as citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{singletitle}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}.
\item[authortitle-tcomp]
-A style combining the features of \texttt{authortitle-comp} and \texttt{authortitle-terse}. This style will make use of the \bibfield{shorttitle} field, if available. It is suitable for in-text citations as well as citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{singletitle}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}.
+A style combining the features of \texttt{authortitle-comp} and \texttt{authortitle-terse}. This style will make use of the \bibfield{shorttitle} field, if available. It is suitable for in-text citations as well as citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{singletitle}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}.
\item[authortitle-ticomp]
-A style combining the features of \texttt{authortitle-icomp} and \texttt{authortitle-terse}. In other words: a variant of the \texttt{authortitle-tcomp} style with an \emph{ibidem} feature. This style is suitable for in-text citations as well as citations given in footnotes. It will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}, \kvopt{singletitle}{true}, \kvopt{uniquename}{true}, \kvopt{uniquelist}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
+A style combining the features of \texttt{authortitle-icomp} and \texttt{authortitle-terse}. In other words: a variant of the \texttt{authortitle-tcomp} style with an \emph{ibidem} feature. This style is suitable for in-text citations as well as citations given in footnotes. It will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}, \kvopt{singletitle}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details.
\item[verbose]
A verbose citation style which prints a full citation similar to a bibliography entry when an entry is cited for the first time, and a short citation afterwards. If available, the \bibfield{shorttitle} field is used in all short citations. If the \bibfield{shorthand} field is defined, the shorthand is introduced on the first citation and used as the short citation thereafter. This style may be used without a list of references and shorthands since all bibliographic data is provided on the first citation. It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{citetracker}{context}. This style also provides an additional preamble option called \opt{citepages}. See the style example for details.
@@ -2994,6 +3001,9 @@ Similar to \texttt{bibliography} above but uses \cmd{chapter} or \cmd{section} t
\item[subbibnumbered]
Similar to \texttt{subbibliography} above but uses \cmd{section} or \cmd{subsection} to create a numbered heading which is also added to the table of contents.
+\item[none]
+A blank heading definition. Use this to suppress the heading.
+
\end{valuelist*}
The following headings intended for use with \cmd{printshorthands} are predefined:
@@ -6110,9 +6120,11 @@ Expands to \prm{true} when located in a footnote, and to \prm{false} otherwise.
This counter indicates how many times the entry currently being processed is cited in the current reference section. Note that this feature needs to be enabled explicitly with the package option \opt{citecounter}. If the option is set to \texttt{context}, citations in the body text and in footnotes are counted separately. In this case, \cnt{citecounter} will hold the value of the context it is used in.
-\cntitem{uniquename}\BiberOnlyMark This counter refers to the \bibfield{labelname} list and is set on a per-name basis. Its value is \texttt{0} if the author's or editor's last name is unique, \texttt{1} if adding the other parts of the name (first name, prefix, suffix) as initials will make it unique, and \texttt{2} if the full name is required to disambiguate the name. This information is required by author-year and author-title citation schemes which add additional parts of the name when citing different authors with the same last name. For example, if there is one <John Doe> and one <Edward Doe> in the list of references, this counter will be set to \texttt{1}. If there is one <John Doe> and one <Jane Doe>, the value of the counter will be \texttt{2}. If the option is set to \texttt{init}, the counter will be limited to \texttt{1}. This is useful for citations styles which use initials to disambiguate names but never print the full name in citations. If adding the initials is not sufficient to disambiguate the name, \cnt{uniquename} will also be set to \texttt{0} for that name. This feature needs to be enabled explicitly with the package option \opt{uniquename}. Note that the \cnt{uniquename} counter is set <inside> \cmd{printnames} and that it is only set for the \bibfield{labelname} list. Its value is zero in any other context, i.e., it must be evaluated in the name formatting directive handling the \bibfield{labelname} list.
+\cntitem{uniquename}\BiberOnlyMark
+This counter refers to the \bibfield{labelname} list. It is set on a per-name basis. Its value is \texttt{0} if the last name is unique, \texttt{1} if adding the other parts of the name (first name, prefix, suffix) as initials will make it unique, and \texttt{2} if the full name is required to disambiguate the name. This information is required by author-year and author-title citation schemes which add additional parts of the name when citing different authors with the same last name. For example, if there is one <John Doe> and one <Edward Doe> in the list of references, this counter will be set to \texttt{1}. If there is one <John Doe> and one <Jane Doe>, the value of the counter will be \texttt{2}. If the option is set to \texttt{init}\slash \texttt{allinit}\slash \texttt{mininit}, the counter will be limited to \texttt{1}. This is useful for citations styles which use initials to disambiguate names but never print the full name in citations. If adding the initials is not sufficient to disambiguate the name, \cnt{uniquename} will also be set to \texttt{0} for that name. This feature needs to be enabled explicitly with the package option \opt{uniquename}. Note that the \cnt{uniquename} counter is local to \cmd{printnames} and that it is only set for the \bibfield{labelname} list and to the name list \bibfield{labelname} has been derived from (typically \bibfield{author} or \bibfield{editor}). Its value is zero in any other context, i.e., it must be evaluated in the name formatting directives handling name lists. See \secref{aut:cav:amb} for further details and practical examples.
-\cntitem{uniquelist}\BiberOnlyMark This counter refers to the \bibfield{labelname} list and is set on a per-entry basis. Its value indicates the number of names required to disambiguate the \bibfield{labelname} list if automatic \cnt{maxnames}\slash \cnt{minnames} truncation would lead to an ambiguous list of names. For example, if there is one work by <Doe\slash Smith\slash Johnson> and another one by <Doe\slash Edwards\slash Williams>, setting \kvopt{maxnames}{1} might lead to <Doe et al.> in citations in both cases (depending on the style). In this case, \cnt{uniquelist} would be set to \texttt{2} for both entries because at least the first two names are required to disambiguate the \bibfield{labelname} lists of these entries. Note that the \cnt{uniquelist} counter is set <inside> \cmd{printnames} and that it is only set for the \bibfield{labelname} list. Its value is zero in any other context. If available, the \cnt{uniquelist} value will be used by \cmd{printnames} when processing the \bibfield{labelname} list, \ie it will automatically override \cnt{maxnames}. This feature needs to be enabled explicitly with the package option \opt{uniquelist}.
+\cntitem{uniquelist}\BiberOnlyMark
+This counter refers to the \bibfield{labelname} list. It is set on a per-field basis. Its value indicates the number of names required to disambiguate the name list if automatic \cnt{maxnames}\slash \cnt{minnames} truncation would lead to ambiguous citations. For example, if there is one work by <Doe\slash Smith\slash Johnson> and another one by <Doe\slash Edwards\slash Williams>, setting \kvopt{maxnames}{1} would lead to <Doe et al.> in both cases. In this case, \cnt{uniquelist} would be set to \texttt{2} on the \bibfield{labelname} lists of both entries because at least the first two names are required to disambiguate them. Note that the \cnt{uniquelist} counter is local to \cmd{printnames} and that it is only set for the \bibfield{labelname} list and to the name list \bibfield{labelname} has been derived from (typically \bibfield{author} or \bibfield{editor}). Its value is zero in any other context. If available, the \cnt{uniquelist} value will be used automatically by \cmd{printnames} when processing the name list, \ie it will automatically override \cnt{maxnames}\slash \cnt{minnames}. This feature needs to be enabled explicitly with the package option \opt{uniquelist}. See \secref{aut:cav:amb} for further details and practical examples.
\cntitem{parenlevel}
@@ -6829,6 +6841,8 @@ The following keys refer to roles which are expressed as a function (<editor>, <
\item[continuators] The plural form of \texttt{continuator}.
\item[redactor] The term <redactor>, referring to a secondary editor.
\item[redactors] The plural form of \texttt{redactor}.
+\item[reviser] The term <reviser>, referring to a secondary editor.
+\item[revisers] The plural form of \texttt{reviser}.
\item[collaborator] A term like <collaborator>, <collaboration>, <cooperator>, or <cooperation>, referring to a secondary editor.
\item[collaborators] The plural form of \texttt{collaborator}.
\item[translator] The term <translator>.
@@ -6970,6 +6984,7 @@ The following keys refer to roles which are expressed as an action (<edited by>,
\item[byfounder] The expression <founded by \prm{name}>.
\item[bycontinuator] The expression <continued by \prm{name}>.
\item[byredactor] The expression <redacted by \prm{name}>.
+\item[byreviser] The expression <revised by \prm{name}>.
\item[bycollaborator] An expression like <in collaboration with \prm{name}> or <in cooperation with \prm{name}>.
\item[bytranslator] The expression <translated by \prm{name}> or <translated from \prm{language} by \prm{name}>.
\item[bycommentator] The expression <commented by \prm{name}>.
@@ -7819,6 +7834,316 @@ Appends the \prm{code} to an internal hook executed once for every entry as the
This section provides some additional hints concerning the author interface of this package. It also addresses common problems and potential misconceptions.
+\subsubsection{Entry Sets}
+\label{aut:cav:set}
+
+Entry sets have already been introduced in \secref{use:use:set}. This section discusses how to process entry sets in a bibliography style. From the perspective of the driver, there is no difference between static and dynamic entry sets. Both types are handled in the same way. You will normally use the \cmd{entryset} command from \secref{aut:bib:dat} to loop over all set members (in the order in which they are listed in the \bibfield{entryset} field of the \bibtype{set} entry, or in the order in which they were passed to \cmd{defbibentryset}, respectively) and append \cmd{finentry} at the end. That's it. The formatting is handled by the drivers for the entry types of the individual set members:
+
+\begin{lstlisting}[style=latex]{}
+\DeclareBibliographyDriver{set}{%
+ <<\entryset>>{}{}%
+ \finentry}
+\end{lstlisting}
+%
+You may have noticed that the \texttt{numeric} styles which ship with this package support subdivided entry sets, \ie the members of the set are marked with a letter or some other marker such that citations may either refer to the entire set or to a specific set member. The markers are generated as follows by the bibliography style:
+
+\begin{lstlisting}[style=latex]{}
+\DeclareBibliographyDriver{set}{%
+ \entryset
+ {<<\printfield{entrysetcount}>>%
+ <<\setunit*{\addnbspace}>>}
+ {}%
+ \finentry}
+\end{lstlisting}
+%
+The \bibfield{entrysetcount} field holds an integer indicating the position of a set member in the entry set. The conversion of this number to a letter or some other marker is handled by the formatting directive of the \bibfield{entrysetcount} field. All the driver needs to do is print the field and add some white space (or start a new line). Printing the markers in citations works in a similar way. Where a numeric style normally says |\printfield{labelnumber}|, you simply append the \bibfield{entrysetcount} field:
+
+\begin{lstlisting}[style=latex]{}
+\printfield{labelnumber}<<\printfield{entrysetcount}>>
+\end{lstlisting}
+%
+Since this field is only defined when processing citations referring to a set member, there is no need to add any additional tests.
+
+\subsubsection{Electronic Publishing Information}
+\label{aut:cav:epr}
+
+The standard styles feature dedicated support for arXiv references. Support for other resources is easily added. The standard styles handle the \bibfield{eprint} field as follows:
+
+\begin{lstlisting}[style=latex]{}
+\iffieldundef{eprinttype}
+ {\printfield{eprint}}
+ {\printfield[<<eprint:\strfield{eprinttype}>>]{eprint}}
+\end{lstlisting}
+%
+If an \bibfield{eprinttype} field is available, the above code tries to use the field format \texttt{eprint:\prm{eprinttype}}. If this format is undefined, \cmd{printfield} automatically falls back to the field format \texttt{eprint}. There are two predefined field formats, the type"=specific format \texttt{eprint:arxiv} and the fallback format \texttt{eprint}:
+
+\begin{lstlisting}[style=latex]{}
+\DeclareFieldFormat{<<eprint>>}{...}
+\DeclareFieldFormat{<<eprint:arxiv>>}{...}
+\end{lstlisting}
+%
+In other words, adding support for additional resources is as easy as defining a field format named \texttt{eprint:\prm{resource}} where \prm{resource} is an identifier to be used in the \bibfield{eprinttype} field.
+
+\subsubsection{External Abstracts and Annotations}
+\label{aut:cav:prf}
+
+External abstracts and annotations have been discussed in \secref{use:use:prf}. This section provides some more background for style authors. The standard styles use the following macros (from \path{biblatex.def}) to handle abstracts and annotations:
+
+\begin{lstlisting}[style=latex]{}
+\newbibmacro*{annotation}{%
+ \iffieldundef{annotation}
+ {\printfile[annotation]{<<\bibannotationprefix\thefield{entrykey}.tex>>}}%
+ {\printfield{annotation}}}
+\newcommand*{<<\bibannotationprefix>>}{bibannotation-}
+
+\newbibmacro*{abstract}{%
+ \iffieldundef{abstract}
+ {\printfile[abstract]{<<\bibabstractprefix\thefield{entrykey}.tex>>}}%
+ {\printfield{abstract}}}
+\newcommand*{<<\bibabstractprefix>>}{bibabstract-}
+\end{lstlisting}
+%
+If the \bibfield{abstract}\slash \bibfield{annotation} field is undefined, the above code tries to load the abstracts\slash annotations from an external file. The \cmd{printfile} commands also incorporate file name prefixes which may be redefined by users. Note that you must enable \cmd{printfile} explicitly by setting the \opt{loadfiles} package option from \secref{use:opt:pre:gen}. This feature is disabled by default for performance reasons.
+
+\subsubsection[Name Disambiguation]{Name Disambiguation\BiberOnlyMark}
+\label{aut:cav:amb}
+
+The \opt{uniquename} and \opt{uniquelist} options introduced in \secref{use:opt:pre:int} support various modes of operation. This section explains the differences between these modes by way of example. The \opt{uniquename} option disambiguates individual names in the \bibfield{labelname} list. The \opt{uniquelist} option disambiguates the \bibfield{labelname} list if it has become ambiguous after \opt{maxnames}\slash \opt{minnames} truncation. You can use either option stand-alone or combine both.
+
+\paragraph{Individual Names (\opt{uniquename})}
+
+Let's start off with some \opt{uniquename} examples. Consider the following data:
+
+\begin{lstlisting}{}
+John Doe 2008
+Edward Doe 2008
+John Smith 2008
+Jane Smith 2008
+\end{lstlisting}
+%
+Let's assume we're using an author-year style and set \kvopt{uniquename}{false}. In this case, we would get the following citations:
+
+\begin{lstlisting}{}
+Doe 2008a
+Doe 2008b
+Smith 2008a
+Smith 2008b
+\end{lstlisting}
+%
+Since the last names are ambiguous and all works have been published in the same year, an extra letter is appended to the year to disambiguate the citations. Many style guides, however, mandate that the extra letter be used to disambiguate works by the same authors only, not works by different authors with the same last name. In order to disambiguate the author's last name, you are expected to add additional parts of the name, either as initials or in full. This requirement is addressed by the \opt{uniquename} option. Here are the same citations with \kvopt{uniquename}{init}:
+
+\begin{lstlisting}{}
+J. Doe 2008
+E. Doe 2008
+Smith 2008a
+Smith 2008b
+\end{lstlisting}
+%
+\kvopt{uniquename}{init} restricts name disambiguation to initials. Since <J. Smith> would still be ambiguous, no additional name parts are added for the <Smiths>. With \kvopt{uniquename}{full}, names are printed in full where required:
+
+\begin{lstlisting}{}
+J. Doe 2008
+E. Doe 2008
+John Smith 2008
+Jane Smith 2008
+\end{lstlisting}
+%
+In order to illustrate the difference between \kvopt{uniquename}{init\slash full} and \texttt{allinit\slash allfull}, we need to introduce the notion of a <visible> name. In the following, <visible> names are all names at a position before the \opt{maxnames}\slash \opt{minnames}\slash \opt{uniquelist} truncation point. For example, given this data:
+
+\begin{lstlisting}{}
+William Jones/Edward Doe/Jane Smith
+John Doe
+John Smith
+\end{lstlisting}
+%
+and \kvopt{maxnames}{1}, \kvopt{minnames}{1}, \kvopt{uniquename}{init/full}, we would get the following names in citations:
+
+\begin{lstlisting}{}
+Jones et al.
+Doe
+Smith
+\end{lstlisting}
+%
+When disambiguating names, \kvopt{uniquename}{init/full} only consider the visible names. Since all visible last names are distinct in this example, no further name parts are added. Let's compare that to the output of \kvopt{uniquename}{allinit}:
+
+\begin{lstlisting}{}
+Jones et al.
+J. Doe
+Smith
+\end{lstlisting}
+%
+\texttt{allinit} considers all names in all \bibfield{labelname} lists, including those which are hidden and replaced by <et al.> as the list is truncated. In this example, <John Doe> is disambiguated from <Edward Doe>. Since the ambiguity of the two <Smiths> can't be resolved by adding initials, no initials are added in this case. Now let's compare that to the output of \kvopt{uniquename}{allfull} which also disambiguates <John Smith> from <Jane Smith>:
+
+\begin{lstlisting}{}
+Jones et al.
+J. Doe
+John Smith
+\end{lstlisting}
+%
+The options \kvopt{uniquename}{mininit/minfull} are similar to \texttt{init\slash full} in that they only consider visible names, but they perform minimal disambiguation. That is, they will disambiguate individual names only if they occur in identical lists of last names. Consider the following data:
+
+\begin{lstlisting}{}
+John Doe/William Jones
+Edward Doe/William Jones
+John Smith/William Edwards
+Edward Smith/Allan Johnson
+\end{lstlisting}
+%
+With \kvopt{uniquename}{init/full}, we would get:
+
+\begin{lstlisting}{}
+J. Doe and Jones
+E. Doe and Jones
+J. Smith and Edwards
+E. Smith and Johnson
+\end{lstlisting}
+%
+With \kvopt{uniquename}{mininit/minfull}:
+
+\begin{lstlisting}{}
+J. Doe and Jones
+E. Doe and Jones
+Smith and Edwards
+Smith and Johnson
+\end{lstlisting}
+%
+The <Smiths> are not disambiguated because the visible name lists are not ambiguous and the \opt{mininit/minfull} options serve to disambiguate names occurring in identical last name lists only. Another way of looking at this is that they globally disambiguate last name lists. When it comes to ambiguous lists, note that a truncated list is considered to be distinct from an untruncated one even if the visible names are identical. For example, consider the following data:
+
+\begin{lstlisting}{}
+John Doe/William Jones
+Edward Doe
+\end{lstlisting}
+%
+With \kvopt{maxnames}{1}, \kvopt{uniquename}{init/full}, we would get:
+
+\begin{lstlisting}{}
+J. Doe et al.
+E. Doe
+\end{lstlisting}
+%
+With \kvopt{uniquename}{mininit/minfull}:
+
+\begin{lstlisting}{}
+Doe et al.
+Doe
+\end{lstlisting}
+%
+Because the lists differ in the <et al.>, the names are not disambiguated.
+
+\paragraph{Lists of Names (\opt{uniquelist})}
+
+Ambiguity is also an issue with name lists. If the \bibfield{labelname} list is truncated by the \opt{maxnames}\slash \opt{minnames} options, it may become ambiguous. This type of ambiguity is addressed by the \opt{uniquelist} option. Consider the following data:
+
+\begin{lstlisting}{}
+Doe/Jones/Smith 2005
+Smith/Johnson/Doe 2005
+Smith/Doe/Edwards 2005
+Smith/Doe/Jones 2005
+\end{lstlisting}
+%
+Many author-year styles truncate long author/editor lists in citations. For example, with \kvopt{maxnames}{1} we would get:
+
+\begin{lstlisting}{}
+Doe et al. 2005
+Smith et al. 2005a
+Smith et al. 2005b
+Smith et al. 2005c
+\end{lstlisting}
+%
+Since the authors are ambiguous after truncation, the extra letter is added to the year 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 are usually required to add more names, exceeding the \opt{maxnames}\slash \opt{minnames} truncation point. The \opt{uniquelist} feature addresses this requirement. With \kvopt{uniquelist}{true}, we would get:
+
+\begin{lstlisting}{}
+Doe et al. 2005
+Smith, Johnson et al. 2005
+Smith, Doe and Edwards 2005
+Smith, Doe and Jones 2005
+\end{lstlisting}
+%
+The \opt{uniquelist} option overrides \opt{maxnames}\slash \opt{minnames} on a per-entry basis. Essentially, what happens is that the <et al.> part of the citation is expanded to the point of no ambiguity~-- but no further than that. \opt{uniquelist} may also be combined with \opt{uniquename}. Consider the following data:
+
+\begin{lstlisting}{}
+John Doe/Allan Johnson/William Jones 2009
+John Doe/Edward Johnson/William Jones 2009
+John Doe/Jane Smith/William Jones 2009
+John Doe/John Smith/William Jones 2009
+John Doe/John Edwards/William Jones 2009
+John Doe/John Edwards/Jack Johnson 2009
+\end{lstlisting}
+%
+With \kvopt{maxnames}{1}:
+
+\begin{lstlisting}{}
+Doe et al. 2009a
+Doe et al. 2009b
+Doe et al. 2009c
+Doe et al. 2009d
+Doe et al. 2009e
+Doe et al. 2009f
+\end{lstlisting}
+%
+With \kvopt{maxnames}{1}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}:
+
+\begin{lstlisting}{}
+Doe, A. Johnson et al. 2009
+Doe, E. Johnson et al. 2009
+Doe, Jane Smith et al. 2009
+Doe, John Smith et al. 2009
+Doe, Edwards and Jones 2009
+Doe, Edwards and Johnson 2009
+\end{lstlisting}
+%
+With \kvopt{uniquelist}{minyear}, list disambiguation only happens if the visible list is identical to another visible list with the same \bibfield{labelyear}. This is useful for author-year styles which only require that the citation as a whole be unique, but do not guarantee unambiguous authorship information in citations. This mode is conceptually related to \kvopt{uniquename}{mininit/minfull}. Consider this example:
+
+\begin{lstlisting}{}
+Smith/Jones 2000
+Smith/Johnson 2001
+\end{lstlisting}
+%
+With \kvopt{maxnames}{1} and \kvopt{uniquelist}{true}, we would get:
+
+\begin{lstlisting}{}
+Smith and Jones 2000
+Smith and Johnson 2001
+\end{lstlisting}
+%
+With \kvopt{uniquelist}{minyear}:
+
+\begin{lstlisting}{}
+Smith et al. 2000
+Smith et al. 2001
+\end{lstlisting}
+%
+With \kvopt{uniquelist}{minyear}, it is not clear that the authors are different for the two works but the citations as a whole are still unambiguous since the year is different. In contrast to that, \kvopt{uniquelist}{true} disambiguates the authorship even if this information is not required to uniquely locate the works in the bibliography. Let's consider another example:
+
+\begin{lstlisting}{}
+Vogel/Beast/Garble/Rook 2000
+Vogel/Beast/Tremble/Bite 2000
+Vogel/Beast/Acid/Squeeze 2001
+\end{lstlisting}
+%
+With \kvopt{maxnames}{3}, \kvopt{minnames}{1}, \kvopt{uniquelist}{true}, we would get:
+
+\begin{lstlisting}{}
+Vogel, Beast, Garble et al. 2000
+Vogel, Beast, Tremble et al. 2000
+Vogel, Beast, Acid et al. 2001
+\end{lstlisting}
+%
+With \kvopt{uniquelist}{minyear}:
+
+\begin{lstlisting}{}
+Vogel, Beast, Garble et al. 2000
+Vogel, Beast, Tremble et al. 2000
+Vogel et al. 2001
+\end{lstlisting}
+%
+In the last citation, \kvopt{uniquelist}{minyear} does not override \opt{maxnames}\slash \opt{minnames} as the citation does not need disambiguating from the other two because the year is different.
+
+\subsubsection{Trackers in Floats and \acr{TOC}/\acr{LOT}/\acr{LOF}}
+\label{aut:cav:flt}
+
+If a citation is given in a float (typically in the caption of a figure or table), scholarly back references like <ibidem> or back references based on the page tracker get ambiguous because floats are objects which are (physically and logically) placed outside the flow of text, hence the logic of such references applies poorly to them. To avoid any such ambiguities, the citation and page trackers are temporarily disabled in all floats. In addition to that, these trackers plus the back reference tracker (\opt{backref}) are temporarily disabled in the table of contents, the list of figures, and the list of tables.
+
\subsubsection{Mixing Programming Interfaces}
\label{aut:cav:mif}
@@ -7895,41 +8220,6 @@ When defining \cmd{bbx@xref}, the \prm{precode}, \prm{postcode}, and \prm{sepcod
}
\end{ltxexample}
-\subsubsection{Entry Sets}
-\label{aut:cav:set}
-
-Entry sets have already been introduced in \secref{use:use:set}. This section discusses how to process entry sets in a bibliography style. From the perspective of the driver, there is no difference between static and dynamic entry sets. Both types are handled in the same way. You will normally use the \cmd{entryset} command from \secref{aut:bib:dat} to loop over all set members (in the order in which they are listed in the \bibfield{entryset} field of the \bibtype{set} entry, or in the order in which they were passed to \cmd{defbibentryset}, respectively) and append \cmd{finentry} at the end. That's it. The formatting is handled by the drivers for the entry types of the individual set members:
-
-\begin{lstlisting}[style=latex]{}
-\DeclareBibliographyDriver{set}{%
- <<\entryset>>{}{}%
- \finentry}
-\end{lstlisting}
-%
-You may have noticed that the \texttt{numeric} styles which ship with this package support subdivided entry sets, \ie the members of the set are marked with a letter or some other marker such that citations may either refer to the entire set or to a specific set member. The markers are generated as follows by the bibliography style:
-
-\begin{lstlisting}[style=latex]{}
-\DeclareBibliographyDriver{set}{%
- \entryset
- {<<\printfield{entrysetcount}>>%
- <<\setunit*{\addnbspace}>>}
- {}%
- \finentry}
-\end{lstlisting}
-%
-The \bibfield{entrysetcount} field holds an integer indicating the position of a set member in the entry set. The conversion of this number to a letter or some other marker is handled by the formatting directive of the \bibfield{entrysetcount} field. All the driver needs to do is print the field and add some white space (or start a new line). Printing the markers in citations works in a similar way. Where a numeric style normally says |\printfield{labelnumber}|, you simply append the \bibfield{entrysetcount} field:
-
-\begin{lstlisting}[style=latex]{}
-\printfield{labelnumber}<<\printfield{entrysetcount}>>
-\end{lstlisting}
-%
-Since this field is only defined when processing citations referring to a set member, there is no need to add any additional tests.
-
-\subsubsection{Trackers in Floats and \acr{TOC}/\acr{LOT}/\acr{LOF}}
-\label{aut:cav:flt}
-
-If a citation is given in a float (typically in the caption of a figure or table), scholarly back references like <ibidem> or back references based on the page tracker get ambiguous because floats are objects which are (physically and logically) placed outside the flow of text, hence the logic of such references applies poorly to them. To avoid any such ambiguities, the citation and page trackers are temporarily disabled in all floats. In addition to that, these trackers plus the back reference tracker (\opt{backref}) are temporarily disabled in the table of contents, the list of figures, and the list of tables.
-
\subsubsection{Using the Punctuation Tracker}
\label{aut:cav:pct}
@@ -8132,47 +8422,6 @@ This can be handled by the following code:
%
Since the punctuation after the location is special if there is no publisher, we need one \cmd{iflistundef} test to catch this case. Everything else is handled by the punctuation tracker.
-\subsubsection{Electronic Publishing Information}
-\label{aut:cav:epr}
-
-The standard styles feature dedicated support for arXiv references. Support for other resources is easily added. The standard styles handle the \bibfield{eprint} field as follows:
-
-\begin{lstlisting}[style=latex]{}
-\iffieldundef{eprinttype}
- {\printfield{eprint}}
- {\printfield[<<eprint:\strfield{eprinttype}>>]{eprint}}
-\end{lstlisting}
-%
-If an \bibfield{eprinttype} field is available, the above code tries to use the field format \texttt{eprint:\prm{eprinttype}}. If this format is undefined, \cmd{printfield} automatically falls back to the field format \texttt{eprint}. There are two predefined field formats, the type"=specific format \texttt{eprint:arxiv} and the fallback format \texttt{eprint}:
-
-\begin{lstlisting}[style=latex]{}
-\DeclareFieldFormat{<<eprint>>}{...}
-\DeclareFieldFormat{<<eprint:arxiv>>}{...}
-\end{lstlisting}
-%
-In other words, adding support for additional resources is as easy as defining a field format named \texttt{eprint:\prm{resource}} where \prm{resource} is an identifier to be used in the \bibfield{eprinttype} field.
-
-\subsubsection{External Abstracts and Annotations}
-\label{aut:cav:prf}
-
-External abstracts and annotations have been discussed in \secref{use:use:prf}. This section provides some more background for style authors. The standard styles use the following macros (from \path{biblatex.def}) to handle abstracts and annotations:
-
-\begin{lstlisting}[style=latex]{}
-\newbibmacro*{annotation}{%
- \iffieldundef{annotation}
- {\printfile[annotation]{<<\bibannotationprefix\thefield{entrykey}.tex>>}}%
- {\printfield{annotation}}}
-\newcommand*{<<\bibannotationprefix>>}{bibannotation-}
-
-\newbibmacro*{abstract}{%
- \iffieldundef{abstract}
- {\printfile[abstract]{<<\bibabstractprefix\thefield{entrykey}.tex>>}}%
- {\printfield{abstract}}}
-\newcommand*{<<\bibabstractprefix>>}{bibabstract-}
-\end{lstlisting}
-%
-If the \bibfield{abstract}\slash \bibfield{annotation} field is undefined, the above code tries to load the abstracts\slash annotations from an external file. The \cmd{printfile} commands also incorporate file name prefixes which may be redefined by users. Note that you must enable \cmd{printfile} explicitly by setting the \opt{loadfiles} package option from \secref{use:opt:pre:gen}. This feature is disabled by default for performance reasons.
-
\subsubsection{Custom Localization Modules}
\label{aut:cav:lng}
@@ -8465,6 +8714,18 @@ This revision history is a list of changes relevant to users of this package. Ch
\begin{changelog}
+\begin{release}{1.5}{2011-06-08}
+\item Added option \kvopt{uniquename}{mininit/minfull}\see{use:opt:pre:int}\BiberOnlyMark
+\item Added option \kvopt{uniquelist}{minyear}\see{use:opt:pre:int}\BiberOnlyMark
+\item Updated documentation of \cnt{uniquename} counter\see{aut:aux:tst}\BiberOnlyMark
+\item Updated documentation of \cnt{uniquelist} counter\see{aut:aux:tst}\BiberOnlyMark
+\item Expanded documentation for \opt{uniquename/uniquelist} options\see{aut:cav:amb}\BiberOnlyMark
+\item Added editorial role \texttt{reviser}\see{bib:use:edr}
+\item Added localization keys \texttt{reviser}, \texttt{revisers}, \texttt{byreviser}\see{aut:lng:key}
+\item Added bibliography heading \texttt{none}\see{use:bib:hdg}
+\item Fixed some \sty{memoir} compatibility issues
+\end{release}
+
\begin{release}{1.4c}{2011-05-12}
\item Fixed some bugs
\end{release}