summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-04-27 21:49:29 +0000
committerKarl Berry <karl@freefriends.org>2015-04-27 21:49:29 +0000
commit7be15899cb52af2136151bc4540f9c83e3032b8d (patch)
tree22ec7c4c9e32f1d9f71441c88533615163f048de /Master/texmf-dist/doc/latex/biblatex
parent08ec1f45ba4d7588654ca79b4f0b2b114db9e2db (diff)
biblatex (26apr15)
git-svn-id: svn://tug.org/texlive/trunk@37083 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/RELEASE57
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.pdfbin1157713 -> 1156634 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.tex849
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex8
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/examples/91-sorting-schemes.tex3
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib111
6 files changed, 629 insertions, 399 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex/RELEASE b/Master/texmf-dist/doc/latex/biblatex/RELEASE
index 405e74a34b5..c9117079c0b 100644
--- a/Master/texmf-dist/doc/latex/biblatex/RELEASE
+++ b/Master/texmf-dist/doc/latex/biblatex/RELEASE
@@ -1,3 +1,60 @@
+RELEASE NOTES FOR VERSION 3.0
+
+* Biber version 2.0 is required for biblatex 3.0
+* A new reference context mechanism to allow for future extensions has been
+ introduced. Effectively, this means the following. The 'sorting' option to
+ \printbibliography and \printbiblist is deprecated. You should use the
+ 'sorting' option to \newrefcontext or the
+ \begin{refcontext}\end{refcontext} environment. This allows the sorting
+ list context wider scope over citations etc. too. For example, some
+ information in citations like extrayear depends on the sort list order
+ but until this version, citation sorting was always determined by the global sort
+ list. Therefore it was not too difficult to get into a situation where
+ citations were incorrect for a bibliography list with a defined sorting scheme:
+
+ \usepackage[sorting=nty]{biblatex}
+ \cite{test1}
+ \cite{test2}
+ \printbibliography[sorting=nyt]
+
+ In this case, the citation labels may not match the bibliography
+ because the data used to generate the citations are drawn from a
+ different sort list. This was a general issue that entry data was
+ assumed to be the same over all bibliography lists. Only the order of
+ entries was assumed to be different, which is incorrect. The order of
+ items in a bibliography list can impact the actual data contents of
+ items in the case of things like the extra* fields. Now, the above can
+ be solved using the new refcontext mechanism which exposes the sorting
+ context to biblatex:
+
+ \usepackage[sorting=nty]{biblatex}
+ \newrefcontext[sorting=nyt]
+ \cite{test1}
+ \cite{test2}
+ \printbibliography
+
+ In this case, the \cite commands pull their data from the "nyt" sorting
+ list data which is also used by the following \printbibliography
+ This is all for biber only.
+* labelname and labeltitle are now instantiated by biblatex dynamically at
+ output time. Prior to this release, labelname and labeltitle were
+ statically instantiated by biber and put into the .bbl. This does not allow
+ for context-sensitive labelname/labeltitle determination which is
+ foreseen in future extensions.
+* New "pernottype" and "entryclone" sourcemapping verbs allow for negated
+ matches on entry types and the cloning of entries respectively. Requires
+ biber.
+* Biber now calculates the length of ranges (like page ranges) so that the
+ various range-length tests are far more accurate. See the "frangelen"
+ field documentation. This is very robust and can deal with roman numerals
+ in just about all of their Unicode and ASCII forms.
+* When a bibliography field is declared as a "name" field in the data
+ model, all options and counters to decide whether to use it or not are
+ automatically created. This effectively extends the existing "useauthor"
+ and "useeditor" options to all data mode name fields automatically. These
+ options are now just special cases of the general data model name
+ handling mechanism.
+
RELEASE NOTES FOR VERSION 2.9a
* Biber version 1.9 is required for biblatex 2.9a
diff --git a/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf b/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf
index 408a49237bd..d5227f7510d 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 872a07043af..c8e393f40f6 100644
--- a/Master/texmf-dist/doc/latex/biblatex/biblatex.tex
+++ b/Master/texmf-dist/doc/latex/biblatex/biblatex.tex
@@ -49,8 +49,8 @@
url={\biblatexhome},
author={Philipp Lehman \\(with Philip Kime, Audrey Boruvka and Joseph Wright)},
email={},
- revision={2.9a},
- date={24/06/2014}}
+ revision={3.0},
+ date={20/04/2015}}
\hypersetup{%
pdftitle={The \biblatex Package},
@@ -128,6 +128,13 @@
\newrobustcmd*{\LFMark}{%
\leavevmode\marginpar{\LF}}
+% following snippet is based on code by Michael Ummels (TeX Stack Exchange)
+% <http://tex.stackexchange.com/a/13073/8305>
+\makeatletter
+ \newcommand\fnurl@[1]{\footnote{\url@{#1}}}
+ \DeclareRobustCommand{\fnurl}{\hyper@normalise\fnurl@}
+\makeatother
+
\hyphenation{%
star-red
bib-lio-gra-phy
@@ -143,7 +150,7 @@
\section{Introduction}
\label{int}
-This document is a systematic reference manual for the \biblatex package. Look at the sample documents which ship with \biblatex to get a first impression.\fnurl{\biblatexctan/doc/examples}
+This document is a systematic reference manual for the \biblatex package. Look at the sample documents which ship with \biblatex to get a first impression.\fnurl{\biblatexctan doc/examples}
For a quick start guide, browse \secref{int:abt, bib:typ, bib:fld, bib:use, use:opt, use:xbx, use:bib, use:cit, use:use}.
\subsection[About]{About \biblatex}
@@ -167,6 +174,7 @@ Augusto Ritter Stoffel, Mateus Araújo (Brazilian);
Sebastià Vila-Marta (Catalan);
Ivo Pletikosić (Croatian);
Michal Hoftich (Czech);
+Jonas Nyrup (Danish);
Johannes Wilm (Danish\slash Norwegian);
Alexander van Loon, Pieter Belmans, Hendrik Maryns (Dutch);
Hannu Väisänen, Janne Kujanpää (Finnish);
@@ -668,6 +676,8 @@ In datasources such as a \file{bib} file, all bibliographic data is specified in
\item[Name lists] are parsed and split up into the individual items at the \texttt{and} delimiter. Each item in the list is then dissected into four name components: the first name, the name prefix (von, van, of, da, de, della, \dots), the last name, and the name suffix (junior, senior, \dots). Name lists may be truncated in the \file{bib} file with the keyword <\texttt{and others}>. Typical examples of name lists are \bibfield{author} and \bibfield{editor}.
+\BiberOnlyMark With \biber, name list fields automatically have an \cmd{ifuse*} test created as per the name lists in the default data model (see \secref{aut:aux:tst}). They are also automatically have a \opt{ifuse*} option created which controls labelling and sorting behaviour with the name (see \secref{use:opt:bib:hyb}).
+
\item[Literal lists] are parsed and split up into the individual items at the \texttt{and} delimiter but not dissected further. Literal lists may be truncated in the \file{bib} file with the keyword <\texttt{and others}>. There are two subtypes:
\begin{description}
@@ -2085,7 +2095,7 @@ Whether or not to use information from related entries or not. See \secref{use:r
\boolitem[false]{sortcites}
-Whether or not to sort citations if multiple entry keys are passed to a citation command. If this option is enabled, citations are sorted according to the global sorting order of the bibliography. This feature works with all citation styles.
+Whether or not to sort citations if multiple entry keys are passed to a citation command. If this option is enabled, citations are sorted according to the current bibliography context sorting scheme (see \secref{use:bib:context}). This feature works with all citation styles.
\intitem[3]{maxnames}
@@ -2620,7 +2630,7 @@ Whether or not to update the \cnt{uniquelist} counter, see \secref{aut:aux:tst}
\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{labeldate}{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.
+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.
\end{optionlist}
@@ -2647,29 +2657,29 @@ labeltitleyear & --- & extratitleyear & labeltitle+labelyear\\
\subsubsection{Entry Options}
\label{use:opt:bib}
-Entry options are package options which can be adjusted on a per"=entry basis in the \bibfield{options} field from \secref{bib:fld:spc}.
+Entry options are package options which determine how bibliography data entries are handled. They may be set at various scopes defined below.
\paragraph{Preamble/Type/Entry Options}
\label{use:opt:bib:hyb}
-The following options are settable on a per"=entry basis in the \bibfield{options} field. In addition to that, they may also be used in the optional argument to \cmd{usepackage} as well as in the configuration file and the document preamble. This is useful if you want to change the default behavior globally.
+The following options are settable on a per"=type basis or on a per"=entry in the \bibfield{options} field. In addition to that, they may also be used in the optional argument to \cmd{usepackage} as well as in the configuration file and the document preamble. This is useful if you want to change the default behaviour globally.
\begin{optionlist}
\boolitem[true]{useauthor}
Whether the \bibfield{author} is used in labels and considered during sorting. This may be useful if an entry includes an \bibfield{author} field but is usually not cited by author for some reason. Setting \kvopt{useauthor}{false} does not mean that the \bibfield{author} is ignored completely. It means that the \bibfield{author} is not used in labels and ignored during sorting. The entry will then be alphabetized by \bibfield{editor} or \bibfield{title}. With the standard styles, the \bibfield{author} is printed after the title in this case. See also \secref{use:srt}.
-\BiberOnlyMark With \biber, this option is also settable on a per-type basis.
+\BiberOnlyMark With \biber, this option is also settable on a per-type and per-entry basis.
\boolitem[true]{useeditor}
Whether the \bibfield{editor} replaces a missing \bibfield{author} in labels and during sorting. This may be useful if an entry includes an \bibfield{editor} field but is usually not cited by editor. Setting \kvopt{useeditor}{false} does not mean that the \bibfield{editor} is ignored completely. It means that the \bibfield{editor} does not replace a missing \bibfield{author} in labels and during sorting. The entry will then be alphabetized by \bibfield{title}. With the standard styles, the \bibfield{editor} is printed after the title in this case. See also \secref{use:srt}.
-\BiberOnlyMark With \biber, this option is also settable on a per-type basis.
+\BiberOnlyMark With \biber, this option is also settable on a per-type and per-entry basis.
\boolitem[false]{usetranslator}
Whether the \bibfield{translator} replaces a missing \bibfield{author}\slash \bibfield{editor} in labels and during sorting. Setting \kvopt{usetranslator}{true} does not mean that the \bibfield{translator} overrides the \bibfield{author}\slash \bibfield{editor}. It means that the \bibfield{translator} is considered as a fallback if the \bibfield{author}\slash \bibfield{editor} is missing or if \opt{useauthor} and \opt{useeditor} are set to \texttt{false}. In other words, in order to cite a book by translator rather than by author, you need to set the following options:
-\BiberOnlyMark With \biber, this option is also settable on a per-type basis.
+\BiberOnlyMark With \biber, this option is also settable on a per-type and per-entry basis.
\begin{lstlisting}[style=bibtex]{}
@Book{...,
@@ -2681,6 +2691,10 @@ Whether the \bibfield{translator} replaces a missing \bibfield{author}\slash \bi
%
With the standard styles, the \bibfield{translator} is printed after the title by default. See also \secref{use:srt}.
+\boolitem[true]{use$<$name$>$}
+
+As per \opt{useauthor}, \opt{useeditor} and \opt{usetranslator}, all name lists defined in the data model have an option controlling their behaviour in sorting and labelling automatically
+defined. Global, per-type and per-entry options called <use$<$name$>$>are automatically created.
\boolitem[false]{useprefix}
Whether the name prefix (von, van, of, da, de, della, etc.) is considered when printing the last name in citations. This also affects the sorting and formatting of the bibliography as well as the generation of certain types of labels. If this option is enabled, \biblatex always precedes the last name with the prefix. For example, Ludwig van Beethoven would be cited as «Beethoven» and alphabetized as «Beethoven, Ludwig van» by default. If this option is enabled, he is cited as «van Beethoven» and alphabetized as «Van Beethoven, Ludwig» instead.
@@ -2695,7 +2709,7 @@ The \opt{indexing} option is also settable per-type or per-entry basis. See \sec
\paragraph{Type/Entry Options}
\label{use:opt:bib:ded}
-The following options are only settable on a per"=entry basis in the \bibfield{options} field. They are not available globally.
+The following options are settable on a per"=type basis or on a per"=entry in the \bibfield{options} field. They are not available globally.
\begin{optionlist}
@@ -2704,10 +2718,15 @@ The following options are only settable on a per"=entry basis in the \bibfield{o
If this option is enabled, the entry is excluded from the bibliography but it may still be cited.
\BiberOnlyMark With \biber, this option is also settable on a per-type basis.
-\boolitem[false]{skiplos}
+\boolitem[false]{skiplos}[\BibTeXOnly]
+If this option is enabled, the entry is excluded from the list of shorthands. It is still included in the bibliography and it may also be cited by shorthand. This option is deprecated when using \biber as the backend. Use \opt{skipbiblist} instead.
+
+\boolitem[false]{skipbiblist}[\BiberOnly]
+
+This is the same as the \opt{skiplos} option when using the \bibtex backend. It is renamed for \biber to be consistent with the more generalised bibliography list functionality See \secref{use:bib:biblist}.
If this option is enabled, the entry is excluded from the list of shorthands. It is still included in the bibliography and it may also be cited by shorthand.
-\BiberOnlyMark With \biber, this option is also settable on a per-type basis.
+This option is also settable on a per-type basis.
\boolitem[false]{skiplab}
@@ -2716,9 +2735,14 @@ If this option is enabled, \biblatex will not assign any labels to the entry. It
\boolitem[false]{dataonly}
-Setting this option is equivalent to \kvopt{uniquename}{false}, \kvopt{uniquelist}{false, }\opt{skipbib}, \opt{skiplos}, and \opt{skiplab}. It is not required for normal operation. Use it with care.
+Setting this option is equivalent to \kvopt{uniquename}{false}, \kvopt{uniquelist}{false, }\opt{skipbib}, \opt{skiplos}/\opt{skipbiblist}, and \opt{skiplab}. It is not required for normal operation. Use it with care.
\BiberOnlyMark With \biber, this option is also settable on a per-type basis.
+\paragraph{Entry Only Options}
+\label{use:opt:bib:entry}
+
+The following options are settable only on a per"=entry in the \bibfield{options} field. They are not available globally or per"=type.
+
\valitem{labelnamefield}{fieldname}
Specifies the field to consider first when looking for a \bibfield{labelname} candidate. It is essentially prepended to the search list created by \cmd{DeclareLabelname} for just this entry.
@@ -2970,14 +2994,14 @@ Multiple relations to the same entry are also possible:
%
Note the the order of the keys in lists of multiple related entries is important. The data from multiple related entries is printed in the order of the keys listed in this field. See \secref{aut:ctm:rel} for a more details on the mechanisms behind this feature. You can turn this feature off using the package option \opt{related} from \secref{use:opt:pre:gen}.
-You can use the \bibfield{relatedoptions} to set options on the related entry data clone. This is useful if you need to override the \opt{dataonly} option which is set by default on all related entry clones. For example, if you will expose some of the names in the related clone in your document, you may want to have them disambiguated from names in other entries but normally this won't happen as related clones have the per"=entry \opt{dataonly} option set and this in turn sets \kvopt{uniquename}{false} and \kvopt{uniquelist}{false}. In such a case, you can set \bibfield{relatedoptions} to just \opt{skiplab, skipbib, skiplos}.
+You can use the \bibfield{relatedoptions} to set options on the related entry data clone. This is useful if you need to override the \opt{dataonly} option which is set by default on all related entry clones. For example, if you will expose some of the names in the related clone in your document, you may want to have them disambiguated from names in other entries but normally this won't happen as related clones have the per"=entry \opt{dataonly} option set and this in turn sets \kvopt{uniquename}{false} and \kvopt{uniquelist}{false}. In such a case, you can set \bibfield{relatedoptions} to just \opt{skiplab, skipbib, skiplos/skipbiblist}.
\subsection{Sorting Options}
\label{use:srt}
This package supports various sorting schemes for the bibliography. The sorting scheme is selected with the \opt{sorting} package option from \secref{use:opt:pre:gen}. Apart from the regular data fields there are also some special fields which may be used to optimize the sorting of the bibliography. \Apxref{apx:srt:a1, apx:srt:a2} give an outline of the alphabetic sorting schemes supported by \biblatex. Chronological sorting schemes are listed in \apxref{apx:srt:chr}. A few explanations concerning these schemes are in order.
-The first item considered in the sorting process is always the \bibfield{presort} field of the entry. If this field is undefined, \biblatex will use the default value <\texttt{mm}> as a presort string. The next item considered is the \bibfield{sortkey} field. If this field is defined, it serves as the master sort key. Apart from the \bibfield{presort} field, no further data is considered in this case. If the \bibfield{sortkey} field is undefined, sorting continues with the name. The package will try using the \bibfield{sortname}, \bibfield{author}, \bibfield{editor}, and \bibfield{translator} fields, in this order. Which fields are considered also depends on the setting of the \opt{useauthor}, \opt{useeditor}, and \opt{usetranslator} options. If all three of them are disabled, the \bibfield{sortname} field is ignored as well. Note that all name fields are responsive to \opt{maxnames} and \opt{minnames}. If no name field is available, either because all of them are undefined or because \opt{useauthor}, \opt{useeditor}, and \opt{usetranslator} are disabled, \biblatex will fall back to the \bibfield{sorttitle} and \bibfield{title} fields as a last resort. The remaining items are, in various order: the \bibfield{sortyear} field, if defined, or the first four digits of the \bibfield{year} field otherwise; the \bibfield{sorttitle} field, if defined, or the \bibfield{title} field otherwise; the \bibfield{volume} field, which is padded to four digits with leading zeros, or the string \texttt{0000} otherwise. Note that the sorting schemes shown in \apxref{apx:srt:a2} include an additional item: \bibfield{labelalpha} is the label used by <alphabetic> bibliography styles. Strictly speaking, the string used for sorting is \bibfield{labelalpha}~+ \bibfield{extraalpha}. The sorting schemes in \apxref{apx:srt:a2} are intended to be used in conjunction with alphabetic styles only.
+The first item considered in the sorting process is always the \bibfield{presort} field of the entry. If this field is undefined, \biblatex will use the default value <\texttt{mm}> as a presort string. The next item considered is the \bibfield{sortkey} field. If this field is defined, it serves as the master sort key. Apart from the \bibfield{presort} field, no further data is considered in this case. If the \bibfield{sortkey} field is undefined, sorting continues with the name. The package will try using the \bibfield{sortname}, \bibfield{author}, \bibfield{editor}, and \bibfield{translator} fields, in this order. Which fields are considered also depends on the setting of the \opt{use$<$name$>$} options. If all such options are disabled, the \bibfield{sortname} field is ignored as well. Note that all name fields are responsive to \opt{maxnames} and \opt{minnames}. If no name field is available, either because all of them are undefined or because all \opt{use$<$name$>$} options are disabled, \biblatex will fall back to the \bibfield{sorttitle} and \bibfield{title} fields as a last resort. The remaining items are, in various order: the \bibfield{sortyear} field, if defined, or the first four digits of the \bibfield{year} field otherwise; the \bibfield{sorttitle} field, if defined, or the \bibfield{title} field otherwise; the \bibfield{volume} field, which is padded to four digits with leading zeros, or the string \texttt{0000} otherwise. Note that the sorting schemes shown in \apxref{apx:srt:a2} include an additional item: \bibfield{labelalpha} is the label used by <alphabetic> bibliography styles. Strictly speaking, the string used for sorting is \bibfield{labelalpha}~+ \bibfield{extraalpha}. The sorting schemes in \apxref{apx:srt:a2} are intended to be used in conjunction with alphabetic styles only.
The chronological sorting schemes presented in \apxref{apx:srt:chr} also make use of the \bibfield{presort} and \bibfield{sortkey} fields, if defined. The next item considered is the \bibfield{sortyear} or the \bibfield{year} field, depending on availability. The \opt{ynt} scheme extracts the first four Arabic figures from the field. If both fields are undefined, the string \texttt{9999} is used as a fallback value. This means that all entries without a year will be moved to the end of the list. The \opt{ydnt} scheme is similar in concept but sorts the year in descending order. As with the \opt{ynt} scheme, the string \texttt{9999} is used as a fallback value. The remaining items are similar to the alphabetic sorting schemes discussed above. Note that the \opt{ydnt} sorting scheme will only sort the date in descending order. All other items are sorted in ascending order as usual.
@@ -3087,10 +3111,6 @@ Print only entries cited in reference section \prm{integer}. The reference secti
Print only entries cited in reference segment \prm{integer}. The reference segments are numbered starting at~1. All citations given outside a \env{refsegment} environment are assigned to segment~0. See \secref{use:bib:seg} for details and \secref{use:use:mlt} for usage examples. Remember that segments within a section are numbered local to the section so the segment you request will be the nth segment in the requested (or currently active enclosing) section.
-\valitem{sorting}{name}[\BiberOnly]
-
-Sort the bibliography according to a built-in or user specified sorting scheme defined with \cmd{DeclareSortingScheme}. If omitted, the global sorting scheme specified with package \opt{sorting} option is used. This option facilitates multiple bibliography lists within a refsection, each of which can be sorted differently.
-
\valitem{type}{entrytype}
Print only entries whose entry type is \prm{entrytype}.
@@ -3149,21 +3169,23 @@ This option applies to numerical citation\slash bibliography styles only and req
\cmditem{bibbysection}[key=value, \dots]
-This command automatically loops over all reference sections. This is equivalent to giving one \cmd{printbibliography} command for every section but has the additional benefit of automatically skipping sections without references. Note that \cmd{bibbysection} starts looking for references in section \texttt{1}. It will ignore references given outside of \env{refsection} environments since they are assigned to section~0. See \secref{use:use:mlt} for usage examples. The options are a subset of those supported by \cmd{printbibliography}. Valid options are \opt{env}, \opt{heading}, \opt{prenote}, \opt{postnote}. The global sorting scheme specified with package \opt{sorting} option is used for all sections.
+This command automatically loops over all reference sections. This is equivalent to giving one \cmd{printbibliography} command for every section but has the additional benefit of automatically skipping sections without references. Note that \cmd{bibbysection} starts looking for references in section \texttt{1}. It will ignore references given outside of \env{refsection} environments since they are assigned to section~0. See \secref{use:use:mlt} for usage examples. The options are a subset of those supported by \cmd{printbibliography}. Valid options are \opt{env}, \opt{heading}, \opt{prenote}, \opt{postnote}. The current bibliography context sorting scheme is used for all sections (see \secref{use:bib:context}).
\cmditem{bibbysegment}[key=value, \dots]
-This command automatically loops over all reference segments. This is equivalent to giving one \cmd{printbibliography} command for every segment in the current \env{refsection} but has the additional benefit of automatically skipping segments without references. Note that \cmd{bibbysegment} starts looking for references in segment \texttt{1}. It will ignore references given outside of \env{refsegment} environments since they are assigned to segment~0. See \secref{use:use:mlt} for usage examples. The options are a subset of those supported by \cmd{printbibliography}. Valid options are \opt{env}, \opt{heading}, \opt{prenote}, \opt{postnote}. The global sorting scheme specified with package \opt{sorting} option is used for all segments.
+This command automatically loops over all reference segments. This is equivalent to giving one \cmd{printbibliography} command for every segment in the current \env{refsection} but has the additional benefit of automatically skipping segments without references. Note that \cmd{bibbysegment} starts looking for references in segment \texttt{1}. It will ignore references given outside of \env{refsegment} environments since they are assigned to segment~0. See \secref{use:use:mlt} for usage examples. The options are a subset of those supported by \cmd{printbibliography}. Valid options are \opt{env}, \opt{heading}, \opt{prenote}, \opt{postnote}. The current bibliography context sorting scheme is used for all segments (see \secref{use:bib:context}).
\cmditem{bibbycategory}[key=value, \dots]
-This command loops over all bibliography categories. This is equivalent to giving one \cmd{printbibliography} command for every category but has the additional benefit of automatically skipping empty categories. The categories are processed in the order in which they were declared. See \secref{use:use:mlt} for usage examples. The options are a subset of those supported by \cmd{printbibliography}. Valid options are \opt{env}, \opt{prenote}, \opt{postnote}, \opt{section}. Note that \opt{heading} is not available with this command. The name of the current category is automatically used as the heading name. This is equivalent to passing \texttt{heading=\prm{category}} to \cmd{printbibliography} and implies that there must be a matching heading definition for every category. The global sorting scheme specified with package \opt{sorting} option is used for all categories.
+This command loops over all bibliography categories. This is equivalent to giving one \cmd{printbibliography} command for every category but has the additional benefit of automatically skipping empty categories. The categories are processed in the order in which they were declared. See \secref{use:use:mlt} for usage examples. The options are a subset of those supported by \cmd{printbibliography}. Valid options are \opt{env}, \opt{prenote}, \opt{postnote}, \opt{section}. Note that \opt{heading} is not available with this command. The name of the current category is automatically used as the heading name. This is equivalent to passing \texttt{heading=\prm{category}} to \cmd{printbibliography} and implies that there must be a matching heading definition for every category. The current bibliography context sorting scheme is used for all categories (see \secref{use:bib:context}).
\cmditem{printbibheading}[key=value, \dots]
This command prints a bibliography heading defined with \cmd{defbibheading}. It takes one optional argument, which is a list of options given in \keyval notation. The options are a small subset of those supported by \cmd{printbibliography}. Valid options are \opt{heading} and \opt{title}. By default, this command uses the heading \texttt{bibliography}. See \secref{use:bib:hdg} for details. Also see \secref{use:use:mlt,use:use:div} for usage examples.
\end{ltxsyntax}
+%
+To print a bibliography with a different sorting scheme than the global sorting scheme, use the bibliography context switching commands from \secref{use:bib:context}.
\subsubsection{The List of Shorthands}
\label{use:bib:los}
@@ -3199,13 +3221,14 @@ This command prints a bibliography list. It takes an optional argument, which is
The \prm{biblistname} is a mandatory argument which names the bibliography list. This name is used to identify:
\begin{itemize}
-\item The bibliography driver used to print the list entries
-\item A filter declared with \cmd{DeclareBiblistFilter} used to filter the entries returned from \biber
+\item The default bibliography driver used to print the list entries
+\item A default filter declared with \cmd{DeclareBiblistFilter} (see \secref{aut:ctm:bibfilt}) used to filter the entries returned from \biber
+\item A default check declared with \cmd{defbibcheck} (see \secref{use:bib:flt}) used to post-process the list entries
\item The default bib environment to use
-\item The default sorting scheme name to use if the \opt{sorting} option is not set
+\item The default sorting scheme name to use
\end{itemize}
-Note that the \opt{sorting} option differs from \cmd{printbibliography} in that if omitted, the default is to sort use the sorting scheme named after the bibliography list and only then to fall back to the global sorting scheme is this is not defined.
+In terms of sorting the list, the default is to sort use the sorting scheme named after the bibliography list (if it exists) and only then to fall back to the current context sorting scheme is this is not defined (see \secref{use:bib:context}).
The most common bibliography list is a list of shorthand abbreviations for certain entries and so this has a convenience alias \cmd{printshorthands[\dots]} for backwards compatibility which is defined as:
@@ -3240,12 +3263,33 @@ Since \bibfield{shortjournal} is defined in the default data model as a <Label f
\item Uses the automatically created <shortjournal> bibliography list filter to return only entries with a \bibfield{shortjournal} field in the \file{.bbl}
\item Uses the defined <shortjournal> bibliography driver to print the entries
\item Uses the default <biblist> heading but overrides the title with <Journal Shorthands>
-\item Uses the global sorting scheme since no \opt{sorting} option is passed to \cmd{printbiblist} and no scheme exists with the name \bibfield{shortjournal}
+\item Uses the current bibliography context sorting scheme no scheme exists with the name \bibfield{shortjournal}
\end{itemize}
%
+Often, you will want to sort on the label field of the list and since a sorting scheme is automatically picked up if it is named after the list, in this case you could simply do:
+
+\begin{lstlisting}[style=latex]{}
+\DeclareSortingScheme{shortjournal}{
+ \sort{
+ \field{shortjournal}
+ }
+}
+\end{lstlisting}
+
Naturally all defaults can be overridden by options to \cmd{printbiblist} and definitions of the environments, filters etc. and in this way arbitrary types of bibliography lists can be printed containing a variety of information from the bibliography data.
\end{ltxsyntax}
+Bibliography lists are often used to print lists of various kinds of shorthands and this can result in duplicate entries if more than one bibliography entry has the same shorthand. For example, several journal articles in the same journal would result in duplicate entries in a list of journal shorthands. You can use the fact that such lists automatically pick up a \cmd{bibcheck} with the same name as the list to define a check to remove duplicates. If you are defining a list to print all of the journal shorthands using the \bibfield{shortjournal} field, you could define a \cmd{bibcheck} like this:
+
+\begin{lstlisting}[style=latex]{}
+\defbibcheck{shortjournal}{%
+ \iffieldundef{shortjournal}{\skipentry}{%
+ \iffieldundef{journal}{\skipentry}{%
+ \ifcsdef{\strfield{shortjournal}=\strfield{journal}}
+ {\skipentry}
+ {\savefieldcs{journal}{\strfield{shortjournal}=\strfield{journal}}}}}}
+\end{lstlisting}
+
\subsubsection{Bibliography Sections}
\label{use:bib:sec}
@@ -3470,6 +3514,53 @@ See the author guide, in particular \secref{aut:aux:tst,aut:aux:ife}, for furthe
\end{ltxsyntax}
+\subsubsection{Bibliography Contexts}
+\label{use:bib:context}
+
+References in a bibliography are cited and printed in a <context>. The context determines the data which is actually used for an entry. A context consists currently of the following information (the <context> concept is designed for future extensibility):
+
+\begin{itemize}
+ \item A specific sorting scheme
+\end{itemize}
+%
+The data for an entry can vary depending on the context. This is most obvious in the case of the \opt{extra*} fields like \opt{extrayear} which are generated by the backend according to the order of entries \emph{after} sorting so that they come out in the expected <a, b, c> order. This clearly shows that the \emph{data} in an entry can be different between sorting schemes. If a document contains more than one bibliography list with different sorting schemes, it can happen then that the \file{.bbl} contains sorting lists with the same entry but containing different data (a different value for \bibfield{extrayear}, for example). The purpose of bibliography contexts is to encapsulate things inside a context so that \biblatex can use the correct entry data. An example is printing a bibliography list with a different sorting order to the global sorting order:
+
+\begin{lstlisting}[style=latex]{}
+\usepackage[sorting=nyt]{biblatex}
+\cite{one}
+\cite{two}
+\printbibliography
+\newrefcontext[sorting=yndt]
+\cite{one}
+\cite{two}
+\printbibliography
+\end{lstlisting}
+%
+Here, the second use of the citations, along with the \cmd{printbibliography} command will use data from the context of the <yndt> sorting scheme which may well be different from the data associated with the default <nyt> scheme.
+
+\begin{ltxsyntax}
+
+\envitem{refcontext}[key=value, \dots]
+
+Wraps a bibliography context environment. The options define the context attributes. All context attributes are optional and default to the global settings if absent. The current options are:
+
+\begin{optionlist*}
+
+\valitem{sorting}{name}
+
+Specify a sorting scheme defined previously with \cmd{DeclareSortingScheme}. This scheme is used to determine which data to retrieve and/or print for an entry in the commands inside the context.
+
+\end{optionlist*}
+%
+The \opt{refcontext} environment cannot be nested and \biblatex will generate an error if you try to do so.
+
+\cmditem{newrefcontext}[key=value, \dots]
+
+This command is similar to the \env{refcontext} environment except that it is a stand"=alone command rather than an environment. It automatically ends the previous context section (if any) and immediately starts a new one. Note that the context section started by the last \cmd{newrefcontext} command in the document will extend to the very end of the document. Use \cmd{endrefcontext} if you want to terminate it earlier.
+\end{ltxsyntax}
+%
+At the beginning of the document, there is always a global context containing global settings for each of the context attributes.
+
\subsubsection{Dynamic Entry Sets}
\label{use:bib:set}
@@ -3477,7 +3568,7 @@ In addition to the \bibtype{set} entry type, \biblatex also supports dynamic ent
\begin{ltxsyntax}
-\cmditem{defbibentryset}{key}{key1,key2,key3, \dots}|\BiberOnlyMark|
+\cmditem{defbibentryset}{key}{key1,key2,key3, \dots}\BiberOnlyMark
The \prm{key} is the entry key of the set, which is used like any other entry key when referring to the set. The \prm{key} must be unique and it must not conflict with any other entry key. The second argument is a comma"=separated list of the entry keys which make up the set. \cmd{defbibentryset} implies the equivalent of a \cmd{nocite} command, \ie all sets which are declared are also added to the bibliography. When declaring the same set more than once, only the first invocation of \cmd{defbibentryset} will define the set. Subsequent definitions of the same \prm{key} are ignored and work like \cmd{nocite}\prm{key}. Dynamic entry sets defined in the document body are local to the enclosing \env{refsection} environment, if any. Otherwise, they are assigned to reference section~0. Those defined in the preamble are assigned to reference section~0. Note that dynamic entry sets require \biber. They will not work with any other backend. See \secref{use:use:set} for further details.
@@ -4021,13 +4112,13 @@ The separator inserted between <units> in the sense explained in \secref{aut:pct
\csitem{finentrypunct}
The punctuation printed at the very end of every bibliography entry, usually a period. The default definition is a period.
-\csitem{entrysetpunct}|\BiberOnlyMark|
+\csitem{entrysetpunct}\BiberOnlyMark
The punctuation printed between bibliography subentries of an entry set. The default definition is a semicolon and a space.
-\csitem{bibnamedelima}|\BiberOnlyMark|
+\csitem{bibnamedelima}\BiberOnlyMark
This delimiter controls the spacing between the elements which make up a name part. It is inserted automatically after the first name element if the element is less than three characters long and before the last element. The default definition is an interword space penalized by the value of the \cnt{highnamepenalty} counter (\secref{use:fmt:len}). Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibnamedelimb}|\BiberOnlyMark|
+\csitem{bibnamedelimb}\BiberOnlyMark
This delimiter is inserted between the elements which make up a name part where \cmd{bibnamedelima} does not apply. The default definition is an interword space penalized by the value of the \cnt{lownamepenalty} counter (\secref{use:fmt:len}). Please refer to \secref{use:cav:nam} for further details.
\csitem{bibnamedelimc}
@@ -4036,16 +4127,16 @@ This delimiter controls the spacing between name parts. It is inserted between t
\csitem{bibnamedelimd}
This delimiter is inserted between all name parts where \cmd{bibnamedelimc} does not apply. The default definition is an interword space penalized by the value of the \cnt{lownamepenalty} counter (\secref{use:fmt:len}). Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibnamedelimi}|\BiberOnlyMark|
+\csitem{bibnamedelimi}\BiberOnlyMark
This delimiter replaces \cmd{bibnamedelima/b} after initials. Note that this only applies to initials given as such in the \file{bib} file, not to the initials automatically generated by \biblatex which use their own set of delimiters.
-\csitem{bibinitperiod}|\BiberOnlyMark|
+\csitem{bibinitperiod}\BiberOnlyMark
The punctuation inserted after initials unless \cmd{bibinithyphendelim} applies. The default definition is a period (\cmd{adddot}). Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibinitdelim}|\BiberOnlyMark|
+\csitem{bibinitdelim}\BiberOnlyMark
The spacing inserted between multiple initials unless \cmd{bibinithyphendelim} applies. The default definition is an unbreakable interword space. Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibinithyphendelim}|\BiberOnlyMark|
+\csitem{bibinithyphendelim}\BiberOnlyMark
The punctuation inserted between the initials of hyphenated name parts, replacing \cmd{bibinitperiod} and \cmd{bibinitdelim}. The default definition is a period followed by an unbreakable hyphen. Please refer to \secref{use:cav:nam} for further details.
\csitem{bibindexnamedelima}
@@ -4154,7 +4245,7 @@ The delimiter printed between the author\slash editor and the year by author-yea
\csitem{labelalphaothers}
A string to be appended to the non"=numeric portion of the \bibfield{labelalpha} field (\ie the field holding the citation label used by alphabetic citation styles) if the number of authors\slash editors exceeds the \opt{maxalphanames} threshold or the \bibfield{author}\slash \bibfield{editor} list was truncated in the \file{bib} file with the keyword <\texttt{and others}>. This will typically be a single character such as a plus sign or an asterisk. The default is a plus sign. This command may also be redefined to an empty string to disable this feature. In any case, it must be redefined in the preamble.
-\csitem{sortalphaothers}|\BiberOnlyMark|
+\csitem{sortalphaothers}\BiberOnlyMark
Similar to \cmd{labelalphaothers} but used in the sorting process. Setting it to a different value is advisable if the latter contains formatting commands, for example:
\begin{lstlisting}[style=latex]{}
@@ -4215,7 +4306,7 @@ The commands in this section are language specific. When redefining them, you ne
The language specific dash to be used for ranges of numbers.
-\csitem{bibrangessep}|\BiberOnlyMark|
+\csitem{bibrangessep}\BiberOnlyMark
The language specific separator to be used between multiple ranges.
@@ -4939,7 +5030,7 @@ This section provides additional usage hints and addresses some common problems
\subsubsection{Usage with \acr{KOMA}-Script Classes}
\label{use:cav:scr}
-When using \biblatex in conjunction with one of the \sty{scrbook}, \sty{scrreprt}, or \sty{scrartcl} classes, the headings \texttt{bibliography} and \texttt{biblist} from \secref{use:bib:hdg} are responsive to the bibliography"=related options of these classes.\footnote{This applies to the traditional syntax of these options (\opt{bibtotoc} and \opt{bibtotocnumbered}) as well as to the \keyval syntax introduced in \acr{KOMA}-Script 3.x, \ie to \kvopt{bibliography}{nottotoc}, \kvopt{bibliography}{totoc}, and \kvopt{bibliography}{totocnumbered}, The global \kvopt{toc}{bibliography} and \kvopt{toc}{bibliographynumbered} options as well as their aliases are detected as well. In any case, the options must be set globally in the optional argument to \cmd{documentclass}.} You can override the default headings by using the \opt{heading} option of \cmd{printbibliography}, \cmd{printbibheading} and \cmd{printbiblist}. See \secref{use:bib:bib, use:bib:biblist, use:bib:hdg} for details. All default headings are adapted at load-time such that they blend with the behavior of these classes. If one of the above classes is detected, \biblatex will also provide the following additional tests which may be useful in custom heading definitions:
+When using \biblatex in conjunction with one of the \sty{scrbook}, \sty{scrreprt}, or \sty{scrartcl} classes, the headings \texttt{bibliography} and \texttt{biblist} from \secref{use:bib:hdg} are responsive to the bibliography"=related options of these classes.\footnote{This applies to the traditional syntax of these options (\opt{bibtotoc} and \opt{bibtotocnumbered}) as well as to the \keyval syntax introduced in \acr{KOMA}-Script 3.x, \ie to \kvopt{bibliography}{nottotoc}, \kvopt{bibliography}{totoc}, and \kvopt{bibliography}{totocnumbered}. The global \kvopt{toc}{bibliography} and \kvopt{toc}{bibliographynumbered} options as well as their aliases are detected as well. In any case, the options must be set globally in the optional argument to \cmd{documentclass}.} You can override the default headings by using the \opt{heading} option of \cmd{printbibliography}, \cmd{printbibheading} and \cmd{printbiblist}. See \secref{use:bib:bib, use:bib:biblist, use:bib:hdg} for details. All default headings are adapted at load-time such that they blend with the behavior of these classes. If one of the above classes is detected, \biblatex will also provide the following additional tests which may be useful in custom heading definitions:
\begin{ltxsyntax}
@@ -5318,7 +5409,7 @@ Defines a bibliography driver. A <driver> is a macro which handles a specific en
\cmditem{DeclareBibliographyAlias}{alias}{entrytype}
-If a bibliography driver covers more than one entry type, this command may be used to define an alias. This command is optional. The \prm{entrytype} argument may also be an asterisk. In this case, the alias serves as a fallback which is used if no specific driver for the entry type has been defined.
+If a bibliography driver covers more than one entry type, this command may be used to define an alias where \prm{entrytype} is the name of a defined driver. This command is optional. The \prm{alias} argument may also be an asterisk. In this case, the \prm{entrytype} driver serves as a fallback which is used if no specific driver for an entry has been defined.
\cmditem{DeclareBibliographyOption}{key}[value]{code}
@@ -5480,7 +5571,7 @@ When citing a subentry of an entry set, \biblatex provides the data of the paren
Holds the prefix coming before <date> of the date field name chosen by \cmd{DeclareLabeldate}. For example, if the label date field is \bibfield{eventdate}, then \bibfield{datelabelsource} will be <event>. In case \cmd{DeclareLabeldate} selects the \bibfield{date} field, then \bibfield{datelabelsource} will be defined but will be an empty string as the prefix coming before <date> in the date label name is empty. This is so that the contents of \bibfield{datelabelsource} can be used in constructing references to the field which \cmd{DeclareLabeldate} chooses. Since \cmd{DeclareLabeldate} can also select literal strings for fallbacks, if \bibfield{datelabelsource} is undefined, then either the \opt{labeldate} package option is set to false or \cmd{DeclareLabeldate} chose a literal string instead of a date field. Bear in mind that \cmd{DeclareLabeldate} can also be used to select non-date fields as a fallback and so \bibfield{datelabelsource} might contain a field name. So, in summary, the rules are
\begin{lstlisting}[style=latex]{}
-\iffieldundef{datalabelsource}
+\iffieldundef{datelabelsource}
{
% labeldate package option is not set or \DeclareLabeldate resolved to a literal string
}
@@ -5554,7 +5645,7 @@ The <alphabetic> citation scheme usually requires a letter to be appended to the
\listitem{labelname}{name}
-The name to be printed in citations. This list is a copy of either the \bibfield{shortauthor}, the \bibfield{author}, the \bibfield{shorteditor}, the \bibfield{editor}, or the \bibfield{translator} list, which are normally checked for in this order. If no authors and editors are available, this list is undefined. Note that this list is also responsive to the \opt{useauthor}, \opt{useeditor}, and \opt{usetranslator} options, see \secref{use:opt:bib}. Citation styles should use this list when printing the name in a citation. This list is provided for convenience only and does not carry any additional meaning.
+The name to be printed in citations. This list is a copy of either the \bibfield{shortauthor}, the \bibfield{author}, the \bibfield{shorteditor}, the \bibfield{editor}, or the \bibfield{translator} list, which are normally checked for in this order. If no authors and editors are available, this list is undefined. Note that this list is also responsive to the \opt{use$<$name$>$}, options, see \secref{use:opt:bib}. Citation styles should use this list when printing the name in a citation. This list is provided for convenience only and does not carry any additional meaning.
\BiberOnlyMark With \biber, this field may be customized. See \secref{aut:ctm:fld} for details.
\fielditem{labelnumber}{literal}
@@ -6106,7 +6197,7 @@ in a defined order. See the \biblatex\ manual regarding these macros:\\[2ex]
\begin{ltxsyntax}
-\cmditem{DeclareSourcemap}{specification}|\BiberOnlyMark|
+\cmditem{DeclareSourcemap}{specification}\BiberOnlyMark
Defines source data modification (mapping) rules which can be used to perform any combination of the following tasks:
@@ -6161,6 +6252,10 @@ Restricts all \cmd{step}s in this \cmd{map} element to entries from the named \p
Restricts all \cmd{step}s in this \cmd{map} element to entries of the named \prm{entrytype}. Multiple \cmd{pertype} restrictions are allowed within a \cmd{map} element.
+\cmditem{pernottype}{entrytype}
+
+Restricts all \cmd{step}s in this \cmd{map} element to entries not of the named \prm{entrytype}. Multiple \cmd{pernottype} restrictions are allowed within a \cmd{map} element.
+
\cmditem{step}
A mapping step. Each step is applied sequentially to every relevant entry where <relevant> means those entries which correspond to the data source type, entrytype and data source name restrictions mentioned above. Each step is applied to the entry as it appears after the application of all previous steps. The mapping performed by the step is determined by the following options:
@@ -6176,6 +6271,8 @@ A mapping step. Each step is applied sequentially to every relevant entry where
\valitem{replace}{regexp}
\valitem{fieldset}{entryfield}
\valitem{fieldvalue}{string}
+\valitem{entryclone}{string}
+\boolitem[false]{entrynull}
\boolitem[false]{append}
\boolitem[false]{final}
\boolitem[false]{null}
@@ -6193,6 +6290,12 @@ For all boolean \cmd{step} options, the short form \opt{option} is equivalent to
as if it did not exist in the datasource. Obviously, you should
select the entries which you want to apply this to using prior
mapping steps.
+\item If \texttt{entryclone} is set, a clone of the entry is created with
+ an entry key prefixed by \texttt{prefix}. Obviously this may cause
+ labelling problems in author/year styles etc. and should be used with
+ care. It is mainly intended for numbering issues with numeric styles and
+ multiple bibliographies where the same entries occur in more than one
+ bibliography.
\item Change the \texttt{typesource} \prm{entrytype} to the
\texttt{typetarget} \prm{entrytype}, if defined. If
\texttt{final} is \texttt{true} then if the \prm{entrytype} of the entry is not \texttt{typesource}, processing of the parent \cmd{map} immediately terminates.
@@ -6231,7 +6334,7 @@ be changed (used as \texttt{fieldset}, \texttt{fieldtarget} or changed using \te
\begin{ltxsyntax}
-\cmditem{DeclareStyleSourcemap}{specification}|\BiberOnlyMark|
+\cmditem{DeclareStyleSourcemap}{specification}\BiberOnlyMark
This command sets the source mappings used by a style. Such mappings are conceptually separate from user mappings defined with \cmd{DeclareSourcemap} and are applied directly after user maps. The syntax is identical to \cmd{DeclareSourcemap}. This command is provided for style authors so that any maps defined for the style do not interfere with user maps or the default driver maps defined with \cmd{DeclareDriverSourcemap}. This command is for use in style files and can only be used once---subsequent uses will overwrite earlier definitions.
@@ -6239,7 +6342,7 @@ This command sets the source mappings used by a style. Such mappings are concept
\begin{ltxsyntax}
-\cmditem{DeclareDriverSourcemap}[datatype=driver]{specification}|\BiberOnlyMark|
+\cmditem{DeclareDriverSourcemap}[datatype=driver]{specification}\BiberOnlyMark
This command sets the driver default source mappings for the specified \prm{driver}. Such mappings are conceptually separate from user mappings defined with \cmd{DeclareSourcemap} and style mapping defined with \cmd{DeclareStyleSourcemap}. They consist of mappings which are part of the driver setup. Users should not normally need to change these. Driver default mapping are applied after user mappings (\cmd{DeclareSourcemap}) and style mappings (\cmd{DeclareStyleSourcemap}). These defaults are described in Appendix \secref{apx:maps}. The \prm{specification} is identical to that for \cmd{DeclareSourcemap} but without the \cmd{maps} elements: the \prm{specification} is just a list of \cmd{map} elements since each \cmd{DeclareDriverSourcemap} only applies to one datatype driver. See the default definitions in Appendix \secref{apx:maps} for examples.
@@ -6513,7 +6616,34 @@ This example assumes you have created a field called \bibfield{autourl} using th
%
Any entry with a \bibfield{title} field matching <A Title> will be completely ignored.
%
-\subsubsection{Data Model Specification}|\BiberOnlyMark|
+\begin{lstlisting}[style=latex]{}
+\DeclareSourcemap{
+ \maps[datatype=bibtex]{
+ \map{
+ \pernottype{book}
+ \pernottype{article}
+ \step[entrynull]
+ }
+ }
+}
+\end{lstlisting}
+%
+Any entry which is not a \bibtype{book} or \bibtype{article} will be ignored.
+%
+\begin{lstlisting}[style=latex]{}
+\DeclareSourcemap{
+ \maps[datatype=bibtex]{
+ \map{
+ \perdatasource{<<biblatex-examples.bib>>}
+ \step[entryclone={rel-}]
+ }
+ }
+}
+\end{lstlisting}
+%
+Here, a clone of an entry from the specified data source will be created. The entry key of the clone will be the same as the original but prefixed by the value of the \texttt{entryclone} parameter. The cloned entry would still need to be cited in the document using its new entry key. This type of mapping step should be used with care as it may produce labelling problems in authoryear styles which use, for example, \opt{extrayear}. One use case is for numeric styles which contain multiple bibliographies containing the same entry. In this case, you may need different bibliography number labeld for the same entry and this is very tricky when there is only one entry which needs different labels. Creating clones with different entry keys solves this problem.
+%
+\subsubsection{Data Model Specification}\BiberOnlyMark
\label{aut:ctm:dm}
The data model which \biblatex uses consists of four main elements:
@@ -6548,7 +6678,7 @@ Alternatively, the name of the data model file can be different from any of the
\begin{ltxsyntax}
-\cmditem{DeclareDatamodelEntrytypes}[options]{entrytypes}|\BiberOnlyMark|
+\cmditem{DeclareDatamodelEntrytypes}[options]{entrytypes}\BiberOnlyMark
Declares the comma"=separated list of \prm{entrytypes} to be valid entrytypes in the data model. As usual in \tex csv lists, make sure each element is immediately followed by a comma or the closing brace---no extraneous whitespace.
@@ -6560,7 +6690,7 @@ This entrytype is not output to the \file{.bbl}. Typically used for special entr
\end{optionlist*}
-\cmditem{DeclareDatamodelFields}[options]{fields}|\BiberOnlyMark|
+\cmditem{DeclareDatamodelFields}[options]{fields}\BiberOnlyMark
Declares the comma"=separated list of \prm{fields} to be valid fields in the data model with associated comma"=separated \prm{options}. The \prm{type} and \prm{datatype} options are mandatory. All valid \prm{options} are:
@@ -6592,11 +6722,11 @@ The field can be used as a label in a bibliography or bibliography list. Specify
\end{optionlist*}
-\cmditem{DeclareDatamodelEntryfields}[entrytypes]{fields}|\BiberOnlyMark|
+\cmditem{DeclareDatamodelEntryfields}[entrytypes]{fields}\BiberOnlyMark
Declares that the comma"=separated list of \prm{fields} is valid for the comma"=separated list of \prm{entrytypes}. If \prm{entrytypes} is not given, the fields are valid for all entrytypes. As usual in \tex csv lists, make sure each element is immediately followed by a comma or the closing brace---no extraneous whitespace.
-\cmditem{DeclareDatamodelConstraints}[entrytypes]{specification}|\BiberOnlyMark|
+\cmditem{DeclareDatamodelConstraints}[entrytypes]{specification}\BiberOnlyMark
If a comma"=separated list of \prm{entrytypes} is given, the constraints apply only to those entrytypes. The \prm{specification} is an undelimited list of \cmd{constraint} directives which specify a constraint. Spaces, tabs, and line endings may be used freely to visually arrange the \prm{specification}. Blank lines are not permissible.
@@ -6752,7 +6882,7 @@ Alphabetic styles use a label to identify bibliography entries. This label is co
\begin{ltxsyntax}
-\cmditem{DeclareLabelalphaTemplate}[entrytype, \dots]{specification}|\BiberOnlyMark|
+\cmditem{DeclareLabelalphaTemplate}[entrytype, \dots]{specification}\BiberOnlyMark
Defines the alphabetic label template for the given entrytypes. If no entrytypes are specified in the first argument, then the global label template is defined. The \prm{specification} is an undelimited list of \cmd{labelelement} directives which specify the elements used to build the label. Spaces, tabs, and line endings may be used freely to visually arrange the \prm{specification}. Blank lines are not permissible. This command may only be used in the preamble.
@@ -7037,7 +7167,7 @@ In addition to the predefined sorting schemes discussed in \secref{use:srt}, it
\begin{ltxsyntax}
-\cmditem{DeclareSortingScheme}[options]{name}{specification}|\BiberOnlyMark|
+\cmditem{DeclareSortingScheme}[options]{name}{specification}\BiberOnlyMark
Defines the sorting scheme \prm{name}. The \prm{name} is the identifier passed to the \opt{sorting} option (\secref{use:opt:pre:gen}) when selecting the sorting scheme. The \cmd{DeclareSortingScheme} command supports the following optional arguments:
@@ -7146,7 +7276,7 @@ This sorts «two» before «one», even though lexically, «one» would sort bef
\end{ltxsyntax}
-Here are some examples of sorting schemes. In the first example, we define a simple name\slash title\slash year scheme. The name element may be either the \bibfield{author}, the \bibfield{editor}, or the \bibfield{translator}. Given this specification, the sorting routine will use the first element which is available and continue with the \bibfield{title}. Note that the options \opt{useauthor}, \opt{useeditor}, and \opt{usetranslator} are considered automatically in the sorting process:
+Here are some examples of sorting schemes. In the first example, we define a simple name\slash title\slash year scheme. The name element may be either the \bibfield{author}, the \bibfield{editor}, or the \bibfield{translator}. Given this specification, the sorting routine will use the first element which is available and continue with the \bibfield{title}. Note that the options \opt{use$<$name$>$} options are considered automatically in the sorting process:
\begin{lstlisting}[style=latex]{}
\DeclareSortingScheme{sample}{
@@ -7213,11 +7343,11 @@ Finally, here is an example of a sorting scheme which overrides the global sorti
\begin{ltxsyntax}
-\cmditem{DeclareSortExclusion}{entrytype, \dots}{field, \dots}|\BiberOnlyMark|
+\cmditem{DeclareSortExclusion}{entrytype, \dots}{field, \dots}\BiberOnlyMark
Specifies fields to be excluded from sorting on a per-type basis. The \prm{entrytype} argument and the \prm{field} argument may be a comma"=separated list of values. A blank \prm{field} argument will clear all exclusions for this \prm{entrytype}. This command may only be used in the preamble.
-\cmditem{DeclarePresort}[entrytype, \dots]{string}|\BiberOnlyMark|
+\cmditem{DeclarePresort}[entrytype, \dots]{string}\BiberOnlyMark
Specifies a string to be used to automatically populate the \bibfield{presort} field of entries without a \bibfield{presort} field. The \bibfield{presort} may be defined globally or on a per-type basis. If the optional \prm{entrytype} argument is given, the \prm{string} applies to the respective entry type. If not, it serves as the global default value. Specifying an \prm{entrytype} in conjunction with a blank \prm{string} will clear the type-specific setting. The \prm{entrytype} argument may be a comma"=separated list of values. This command may only be used in the preamble.
@@ -7229,7 +7359,7 @@ Specifies a string to be used to automatically populate the \bibfield{presort} f
When using customisable bibliography lists (See \secref{use:bib:biblist}), usually one wants to return in the \file{.bbl} only those entries which have the particular fields which the bibliography list is summarising. For example, when printing a normal list of shorthands, you want the list returned by \biber in the \file{.bbl} to contain only those entries which have a \bibfield{shorthand} field. This is accomplished by defining a bibliography list filter using the \cmd{DeclareBiblistFilter} command. This differs from the filters defined using \cmd{defbibfilter} (see \secref{use:bib:flt}) since the filters defined by \cmd{defbibfilter} run inside \biblatex after the \file{.bbl} has been generated. In addition, bibliography lists in the \file{.bbl} do not contain entry data, only the citation keys for the entries and so no filtering by \biblatex using \cmd{defbibfilter} is possible for bibliography lists.
\begin{ltxsyntax}
-\cmditem{DeclareBiblistFilter}{name}{specification}|\BiberOnlyMark|
+\cmditem{DeclareBiblistFilter}{name}{specification}\BiberOnlyMark
Defines a bibliography list filter with \prm{name}. The \prm{specification} consists of one or more \cmd{filter} or \cmd{filteror} macros, all of which must be satisfied for the entry to pass the filter:
@@ -7268,7 +7398,7 @@ Generating initials for name parts from a given name involves some difficulties
\begin{ltxsyntax}
-\cmditem{DeclareNoinit}{specification}|\BiberOnlyMark|
+\cmditem{DeclareNoinit}{specification}\BiberOnlyMark
Defines regular expressions to strip from names before generating initials. The \prm{specification} is an undelimited list of \cmd{noinit} directives which specify the regular expressions to remove from the name. Spaces, tabs and line endings may be used freely to visually arrange the \prm{specification}. Blank lines are not permissible. This command may only be used in the preamble.
@@ -7298,7 +7428,7 @@ It can be useful to fine tune sorting so that it ignores certain parts of partic
\begin{ltxsyntax}
-\cmditem{DeclareNosort}{specification}|\BiberOnlyMark|
+\cmditem{DeclareNosort}{specification}\BiberOnlyMark
Defines regular expressions to strip from particular fields or types of fields when sorting. The \prm{specification} is an undelimited list of \cmd{nosort} directives which specify the regular expressions to remove from particular fields or type of field. Spaces, tabs and line endings may be used freely to visually arrange the \prm{specification}. Blank lines are not permissible. This command may only be used in the preamble.
@@ -7380,7 +7510,7 @@ Some of the automatically generated fields from \secref{aut:bbx:fld:lab} may be
\begin{ltxsyntax}
-\cmditem{DeclareLabelname}[entrytype, \dots]{specification}|\BiberOnlyMark|
+\cmditem{DeclareLabelname}[entrytype, \dots]{specification}\BiberOnlyMark
Defines the fields to consider when generating the \bibfield{labelname} field (see \secref{aut:bbx:fld:lab}). The \prm{specification} is an ordered list of \cmd{field} commands. The fields are checked in the order listed and the first field which is available will be used as \bibfield{labelname}. This is the default definition:
@@ -7396,7 +7526,7 @@ Defines the fields to consider when generating the \bibfield{labelname} field (s
%
The \bibfield{labelname} field may be customized globally or on a per-type basis. If the optional \prm{entrytype} argument is given, the specification applies to the respective entry type. If not, it is applied globally. The \prm{entrytype} argument may be a comma"=separated list of values. This command may only be used in the preamble.
-\cmditem{DeclareLabeldate}[entrytype, \dots]{specification}|\BiberOnlyMark|
+\cmditem{DeclareLabeldate}[entrytype, \dots]{specification}\BiberOnlyMark
Defines the date components to consider when generating \bibfield{labelyear}, \bibfield{labelmonth} and \bibfield{labelday} fields (see \secref{aut:bbx:fld:lab}). The \prm{specification} is an ordered list of \cmd{field} or \cmd{literal} commands. The items are checked in the order listed and the first item which is available will be used to popluate the \bibfield{labelyear}, \bibfield{labelmonth} and \bibfield{labelday} fields. Note that the \cmd{field} items do not have to be datetype <date> in the data model so that you can create pseudo-year labels by, for example, using a \bibfield{pubstate} field contents, if available, as the year label by defining \cmd{DeclareLabeldate} suitably. Note also that a \cmd{literal} command will always be used when found and so this should always be the last thing in the list. If the value of a \cmd{literal} command is a valid localization string, then this will be resolved in the current language, otherwise the value is used as a literal string as-is. This is the default definition:
@@ -7413,7 +7543,7 @@ Defines the date components to consider when generating \bibfield{labelyear}, \b
Note that the \bibfield{date} field is split by the backend into \bibfield{year}, \bibfield{month} which are also valid fields in the default data model. In order to support legacy data which directly sets \bibfield{year} and/or \bibfield{month}, the specification <\bibfield{date}> in \cmd{DeclareLabeldate} will also match \bibfield{year} and \bibfield{month} fields, if present.
The \bibfield{labelyear}, \bibfield{labelmonth} and \bibfield{labelday} fields may be customized globally or on a per-type basis. If the optional \prm{entrytype} argument is given, the specification applies to the respective entry type. If not, it is applied globally. The \prm{entrytype} argument may be a comma"=separated list of values. This command may only be used in the preamble. See also \secref{aut:bbx:fld:dat}.
-\cmditem{DeclareLabeltitle}[entrytype, \dots]{specification}|\BiberOnlyMark|
+\cmditem{DeclareLabeltitle}[entrytype, \dots]{specification}\BiberOnlyMark
Defines the fields to consider when generating the \bibfield{labeltitle} field (see \secref{aut:bbx:fld:lab}). The \prm{specification} is an ordered list of \cmd{field} commands. The fields are checked in the order listed and the first field which is available will be used as \bibfield{labeltitle}. This is the default definition:
@@ -7435,7 +7565,7 @@ The \bibfield{labeltitle} field may be customized globally or on a per-type basi
\begin{ltxsyntax}
-\cmditem{DefaultInheritance}[exceptions]{options}|\BiberOnlyMark|
+\cmditem{DefaultInheritance}[exceptions]{options}\BiberOnlyMark
Configures the default inheritance behavior. This command may only be used in the preamble. The default behavior may be customized be setting the following \prm{options}:
@@ -7453,7 +7583,7 @@ The optional \prm{exceptions} are an undelimited list of \cmd{except} directives
Sets the \prm{options} for a specific \prm{source} and \prm{target} combination. The \prm{source} and \prm{target} arguments specify the parent and the child entry type. The asterisk matches all types and is permissible in either argument.
-\cmditem{DeclareDataInheritance}{source, \dots}{target, \dots}{rules}|\BiberOnlyMark|
+\cmditem{DeclareDataInheritance}{source, \dots}{target, \dots}{rules}\BiberOnlyMark
Declares inheritance rules. The \prm{source} and \prm{target} arguments specify the parent and the child entry type. Either argument may be a single entry type, a comma"=separated list of types, or an asterisk. The asterisk matches all entry types. The \prm{rules} are an undelimited list of \cmd{inherit} and\slash or \cmd{noinherit} directives. Spaces, tabs, and line endings may be used freely to visually arrange the \prm{rules}. Blank lines are not permissible. This command may only be used in the preamble.
@@ -7465,7 +7595,7 @@ Defines an inheritance rule by mapping a \prm{source} field to a \prm{target} fi
Unconditionally prevents inheritance of the \prm{source} field.
-\csitem{ResetDataInheritance}|\BiberOnlyMark|
+\csitem{ResetDataInheritance}\BiberOnlyMark
Clears all inheritance rules defined with \cmd{DeclareDataInheritance}. This command may only be used in the preamble.
@@ -7711,15 +7841,19 @@ Expands to \prm{true} if the \opt{useprefix} option is enabled (either globally
\cmditem{ifuseauthor}{true}{false}
-Expands to \prm{true} if the \opt{useauthor} option is enabled (either globally or for the current entry), and \prm{false} otherwise. See \secref{use:opt:bib} for details on this option.
+This is just a particular case of the \cmd{ifuse$<$name$>$} macro below but is mentioned here as \bibfield{author} is part of the default data model. Expands to \prm{true} if the \opt{useauthor} option is enabled (either globally or for the current entry), and \prm{false} otherwise. See \secref{use:opt:bib} for details on this option.
\cmditem{ifuseeditor}{true}{false}
-Expands to \prm{true} if the \opt{useeditor} option is enabled (either globally or for the current entry), and \prm{false} otherwise. See \secref{use:opt:bib} for details on this option.
+This is just a particular case of the \cmd{ifuse$<$name$>$} macro below but is mentioned here as \bibfield{editor} is part of the default data model. Expands to \prm{true} if the \opt{useeditor} option is enabled (either globally or for the current entry), and \prm{false} otherwise. See \secref{use:opt:bib} for details on this option.
\cmditem{ifusetranslator}{true}{false}
-Expands to \prm{true} if the \opt{usetranslator} option is enabled (either globally or for the current entry), and \prm{false} otherwise. See \secref{use:opt:bib} for details on this option.
+This is just a particular case of the \cmd{ifuse$<$name$>$} macro below but is mentioned here as \bibfield{translator} is part of the default data model. Expands to \prm{true} if the \opt{usetranslator} option is enabled (either globally or for the current entry), and \prm{false} otherwise. See \secref{use:opt:bib} for details on this option.
+
+\cmditem{ifuse$<$name$>$}{true}{false}
+
+Expands to \prm{true} if the \opt{use$<$name$>$} option is enabled (either globally or for the current entry), and \prm{false} otherwise. See \secref{use:opt:bib} for details on this option.
\cmditem{ifsingletitle}{true}{false}
@@ -7901,10 +8035,10 @@ 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|
+\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|
+\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}
@@ -8137,7 +8271,7 @@ The optional argument \bibfield{bookpagination} is omissible in this case.
\cmditem{mkcomprange}[postpro]{text}
\cmditem*{mkcomprange*}[postpro]{text}
-This command, which is intended for use in field formatting directives, will parse its \prm{text} argument for page ranges and compress them. For example, «125--129» may be formatted as «125--9». You may configure the behavior of \cmd{mkcomprange} by adjusting the \latex counters \cnt{mincomprange}, \cnt{maxcomprange}, and \cnt{mincompwidth}, as illustrated in \tabref{aut:aux:tab1}. The default settings are \texttt{10}, \texttt{100000}, and \texttt{1}, respectively. This means that the command tries to compress as much as possible by default. Use \cmd{setcounter} to adjust the parameters. The scanner recognizes \cmd{bibrangedash} and hyphens as range dashes. It will normalize the dash by replacing any number of consecutive hyphens with \cmd{bibrangedash}. Lists of ranges delimited with \cmd{bibrangessep} (\biber\footnote{\biber will always convert commas/semicolon multi-range separators into \cmd{bibrangessep} so that it can be controlled in the style.}) or commas/semicolons (BibTeX) are also supported. With \biber, The scanner will normalise any comma or semi-colons surrounded by optional space by replacing them with \cmd{bibrangessep}. If you want to hide a character from the list/range scanner for some reason, wrap the character or the entire string in curly braces. The optional \prm{postpro} argument specifies a macro to be used for post-processing the \prm{text}. This is important if you want to combine \cmd{mkcomprange} with other formatting macros which also need to parse their \prm{text} argument, such as \cmd{mkpageprefix}. Simply nesting these commands will not work as expected. Use the \prm{postpro} argument to set up the processing chain as follows:
+This command, which is intended for use in field formatting directives, will parse its \prm{text} argument for page ranges and compress them. For example, «125--129» may be formatted as «125--9». You may configure the behavior of \cmd{mkcomprange} by adjusting the \latex counters \cnt{mincomprange}, \cnt{maxcomprange}, and \cnt{mincompwidth}, as illustrated in \tabref{aut:aux:tab1}. The default settings are \texttt{10}, \texttt{100000}, and \texttt{1}, respectively. This means that the command tries to compress as much as possible by default. Use \cmd{setcounter} to adjust the parameters. The scanner recognizes \cmd{bibrangedash} and hyphens as range dashes. It will normalize the dash by replacing any number of consecutive hyphens with \cmd{bibrangedash}. Lists of ranges delimited with \cmd{bibrangessep} (\biber\footnote{\biber will always convert commas/semicolon multi-range separators into \cmd{bibrangessep} so that it can be controlled in the style.}) or commas/semicolons (BibTeX) are also supported. With \biber, the scanner will normalise any comma or semi-colons surrounded by optional space by replacing them with \cmd{bibrangessep}. If you want to hide a character from the list/range scanner for some reason, wrap the character or the entire string in curly braces. The optional \prm{postpro} argument specifies a macro to be used for post-processing the \prm{text}. This is important if you want to combine \cmd{mkcomprange} with other formatting macros which also need to parse their \prm{text} argument, such as \cmd{mkpageprefix}. Simply nesting these commands will not work as expected. Use the \prm{postpro} argument to set up the processing chain as follows:
\begin{lstlisting}[style=latex]{}
\DeclareFieldFormat{postnote}{\mkcomprange[<<{>>\mkpageprefix[pagination]<<}>>]{#1}}
@@ -8176,7 +8310,7 @@ p. 5, p. 123, p. 423
\cmditem{rangelen}{text}
-This command will parse its argument as a range and return the length of the range. It will return 0 for open-ended ranges.
+This command will parse its argument as a range and return the length of the range. It will return -1 for open-ended ranges.
\begin{lstlisting}[style=latex]{}
\rangelen{5-10} returns '5'
@@ -8185,12 +8319,44 @@ This command will parse its argument as a range and return the length of the ran
\rangelen{5} returns '1'
\end{lstlisting}
%
-This can be used as part of tests in styles which require, for example, <f> as a suffix for ranges of only two pages, for example, when a page range <36-37> should be printed as <36f>. This could be done using \cmd{ifnumcomp}:
+This can be used as part of tests in styles which require, for example, <f> as a suffix for ranges of only two pages as when a page range <36-37> should be printed as <36f>. This could be done using \cmd{ifnumcomp}:
\begin{lstlisting}[style=latex]{}
\ifnumcomp{\rangelen{\thefield{pages}}}{=}{1}{add 'f'}{do nothing}
\end{lstlisting}
+\cmditem{frangelen}{rangefield}\BiberOnlyMark
+
+Takes the name of a bibfield declared as a range field in the data model and returns the length of the range. This is calculated by \biber, can handle many special cases and is generally more robust than \cmd{rangelen}. It will return -1 for open ended ranges. Specifically \cmd{frangelen} can:
+
+\begin{itemize}
+\item Calculate the total of multiple ranges in the same field such as <1-10, 20-30>
+\item Handle implicit ranges such as <22-4> and <130-33>
+\item Handle roman numeral ranges in upper and lower case and consisting of both ASCII and Unicode roman numeral representations.
+\end{itemize}
+%
+Here are some examples:
+
+\begin{tabular}{ll}
+pages = <10> & |\frangelen{pages}| returns '1'\\
+pages = <10-15> & |\frangelen{pages}| returns '6'\\
+pages = <10-15,47-53> & |\frangelen{pages}| returns '13'\\
+pages = <10-> & |\frangelen{pages}| returns '-1'\\
+pages = <-10> & |\frangelen{pages}| returns '-1'\\
+pages = <48-9> & |\frangelen{pages}| returns '2'\\
+pages = <172-77> & |\frangelen{pages}| returns '6'\\
+pages = <i-vi> & |\frangelen{pages}| returns '6'\\
+pages = <X-XX> & |\frangelen{pages}| returns '11'\\
+pages = <ⅥⅠ-ⅻ> & |\frangelen{pages}| returns '6'\\
+pages = <ⅥⅠ-ⅻ, 145-7, 135-39> & |\frangelen{pages}| returns '14'
+\end{tabular}
+
+As with \cmd{rangelen}, \cmd{frangelen} can be used in tests:
+
+\begin{lstlisting}[style=latex]{}
+\ifnumcomp{\frangelen{pages}}{=}{1}{add 'f'}{do nothing}
+\end{lstlisting}
+
\cmditem{DeclareNumChars}{characters}
\cmditem*{DeclareNumChars*}{characters}
@@ -9255,10 +9421,10 @@ This section corresponds to \secref{use:fmt:fmt} in the user part of the manual.
\begin{ltxsyntax}
-\csitem{bibnamedelima}|\BiberOnlyMark|
+\csitem{bibnamedelima}\BiberOnlyMark
This delimiter controls the spacing between the elements which make up a name part. It is inserted automatically by the backend after the first name element if the element is less than three characters long and before the last element. The default definition is \cmd{addhighpenspace}, \ie a space penalized by the value of the \cnt{highnamepenalty} counter (\secref{use:fmt:len}). Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibnamedelimb}|\BiberOnlyMark|
+\csitem{bibnamedelimb}\BiberOnlyMark
This delimiter controls the spacing between the elements which make up a name part. It is inserted automatically by the backend between all name elements where \cmd{bibnamedelima} does not apply. The default definition is \cmd{addlowpenspace}, \ie a space penalized by the value of the \cnt{lownamepenalty} counter (\secref{use:fmt:len}). Please refer to \secref{use:cav:nam} for further details.
\csitem{bibnamedelimc}
@@ -9267,16 +9433,16 @@ This delimiter controls the spacing between name parts. The default name formats
\csitem{bibnamedelimd}
This delimiter controls the spacing between name parts. The default name formats use it between all name parts where \cmd{bibnamedelimc} does not apply. The default definition is \cmd{addlowpenspace}, \ie a space penalized by the value of the \cnt{lownamepenalty} counter (\secref{use:fmt:len}). Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibnamedelimi}|\BiberOnlyMark|
+\csitem{bibnamedelimi}\BiberOnlyMark
This delimiter replaces \cmd{bibnamedelima/b} after initials. Note that this only applies to initials given as such in the \file{bib} file, not to the initials automatically generated by \biblatex which use their own set of delimiters.
-\csitem{bibinitperiod}|\BiberOnlyMark|
+\csitem{bibinitperiod}\BiberOnlyMark
The punctuation inserted automatically by the backend after all initials unless \cmd{bibinithyphendelim} applies. The default definition is a period (\cmd{adddot}). Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibinitdelim}|\BiberOnlyMark|
+\csitem{bibinitdelim}\BiberOnlyMark
The spacing inserted automatically by the backend between multiple initials unless \cmd{bibinithyphendelim} applies. The default definition is an unbreakable interword space. Please refer to \secref{use:cav:nam} for further details.
-\csitem{bibinithyphendelim}|\BiberOnlyMark|
+\csitem{bibinithyphendelim}\BiberOnlyMark
The punctuation inserted automatically by the backend between the initials of hyphenated name parts, replacing \cmd{bibinitperiod} and \cmd{bibinitdelim}. The default definition is a period followed by an unbreakable hyphen. Please refer to \secref{use:cav:nam} for further details.
\csitem{bibindexnamedelima}
@@ -9593,7 +9759,7 @@ This command strips leading zeros from a number. It is intended for date formatt
A special field formatting directive which is used internally by \biblatex. When the bibliographic data is read from the \file{bbl} file, \biblatex measures the values of all \bibfield{shorthand} fields and sets the length register \cmd{shorthandwidth} to the width of the widest shorthand (see \secref{aut:fmt:ilc}). In order to determine the correct width, the package considers two factors: the definition of \cmd{bibfont} and this formatting directive. All styles should adjust this directive such that it corresponds to the format used in the list of shorthands.
-\optitem{<labelfield>width}|\BiberOnlyMark|
+\optitem{<labelfield>width}\BiberOnlyMark
With \biber, for every field marked as a <Label field> in the data model, a formatting directive is created as per \texttt{shorthandwidth} above. Since \bibfield{shorthand} is so marked in the default data model, this functionality is a superset of that described for \texttt{shorthandwidth}.
@@ -9658,7 +9824,7 @@ The length registers and counters discussed here are used by \biblatex to pass i
This length register indicates the width of the widest \bibfield{shorthand}. Bibliography styles should incorporate this length in the definition of the list of shorthands, if applicable.
-\lenitem{<labelfield>width}|\BiberOnlyMark|
+\lenitem{<labelfield>width}\BiberOnlyMark
With \biber, for every field marked as a <Label field> in the data model, a length register is created as per \texttt{shorthandwidth} above. Since \bibfield{shorthand} is so marked in the default data model, this functionality is a superset of that described for \texttt{shorthandwidth}.
@@ -9772,7 +9938,7 @@ When using \biber, this is just an alias for:
\AtBeginBiblist{shorthand}{code}
\end{lstlisting}
-\cmditem{AtBeginBiblist}{biblistname}{code}|\BiberOnlyMark|
+\cmditem{AtBeginBiblist}{biblistname}{code}\BiberOnlyMark
Appends the \prm{code} to an internal hook executed at the beginning of the bibliography list \prm{biblistname}. The \prm{code} is executed at the beginning of the bibliography list, immediately after the \prm{begin code} of \cmd{defbibenvironment}. This command may only be used in the preamble.
@@ -9790,7 +9956,7 @@ When using \biber, this is just an alias for:
\AtEveryBiblistitem{shorthand}{code}
\end{lstlisting}
-\cmditem{AtEveryBiblistitem}{biblistname}{code}|\BiberOnlyMark|
+\cmditem{AtEveryBiblistitem}{biblistname}{code}\BiberOnlyMark
Appends the \prm{code} to an internal hook executed at the beginning of every item in the bibliography list named \prm{biblistname}. The \prm{code} is executed immediately after the \prm{item code} of \cmd{defbibenvironment}. The bibliographic data of the respective entry is available at this point. This command may only be used in the preamble.
@@ -11149,13 +11315,9 @@ indexing &\+&\+&\+&\+\\
isbn &\+&\+&\_&\_\\ % style
labelalpha &\+&\+&\+&\_\\
labelnamefield &\_&\_&\_&\+\\
-labelnameform &\_&\_&\_&\+\\
-labelnamelang &\_&\_&\_&\+\\
labelnumber &\+&\+&\+&\_\\
labeltitle &\+&\+&\+&\_\\
labeltitlefield &\_&\_&\_&\+\\
-labeltitleform &\_&\_&\_&\+\\
-labeltitlelang &\_&\_&\_&\+\\
labeltitleyear &\+&\+&\+&\_\\
labeldate &\+&\+&\+&\_\\
language &\+&\+&\_&\_\\
@@ -11187,6 +11349,7 @@ refsegment &\+&\+&\_&\_\\
safeinputenc &\+&\+&\_&\_\\
singletitle &\+&\+&\+&\_\\
skipbib &\_&\_&\+&\+\\
+skipbiblist &\_&\_&\+&\+\\
skiplab &\_&\_&\+&\+\\
skiplos &\_&\_&\+&\+\\
sortcase &\+&\+&\_&\_\\
@@ -11202,11 +11365,9 @@ texencoding &\+&\+&\_&\_\\
uniquelist &\+&\+&\+&\+\\
uniquename &\+&\+&\+&\+\\
urldate &\+&\+&\_&\_\\
-url &\+&\+&\_&\_\\ % style
-useauthor &\+&\+&\+&\+\\
-useeditor &\+&\+&\+&\+\\
+url &\+&\+&\_&\_\\
useprefix &\+&\+&\+&\+\\
-usetranslator &\+&\+&\+&\+\\
+use$<$name$>$ &\+&\+&\+&\+\\
\end{longtable}
\endgroup
@@ -11217,7 +11378,17 @@ This revision history is a list of changes relevant to users of this package. Ch
\begin{changelog}
-\begin{release}{2.9a}{2014}
+\begin{release}{3.0}{2015-04-20}
+\item Improved Danish (Jonas Nyrup) and Spanish (ludenticus) translations
+\item \bibfield{labelname} and \bibfield{labeltitle} are now resolved by \biblatex instead of \biber for more flexibility and future extensibility
+\item New \cmd{entryclone} sourcemap verb for cloning entries during sourcemapping\see{aut:ctm:map}
+\item New \cmd{pernottype} negated per-type sourcemap verb\see{aut:ctm:map}
+\item New range calculation command \cmd{frangelen}\see{aut:aux:msc}
+\item New bibliography context functionality\see{use:bib:context}
+\item Name lists in the data model now automatically create internals for \cmd{ifuse$<$name$>$} tests and booleans\see{use:opt:bib:hyb} and \see{aut:aux:tst}
+\end{release}
+
+\begin{release}{2.9a}{2014-06-25}
\item \texttt{resetnumbers} now allows passing a number to reset to\see{use:bib:bib}
\end{release}
@@ -11342,254 +11513,254 @@ This revision history is a list of changes relevant to users of this package. Ch
\item Added \cmd{citeyear*} and \cmd{citedate*}\see{use:cit:txt}
\end{release}
-\begin{release}{1.7}{2011-11-13}
-\item Added \texttt{xdata} containers\see{use:use:xdat}\BiberOnlyMark
-\item Added special entry type \bibfield{xdata}\see{bib:typ:blx}\BiberOnlyMark
-\item Added special field \bibfield{xdata}\see{bib:fld:spc}\BiberOnlyMark
-\item Support \opt{maxnames}/\opt{minnames} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
-\item Support \opt{maxbibnames}/\opt{minbibnames} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
-\item Support \opt{maxcitenames}/\opt{mincitenames} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
-\item Support \opt{maxitems}/\opt{minitems} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
-\item Support \opt{maxalphanames}/\opt{minalphanames} globally/per-type/per-entry\see{use:opt:pre:int}\BiberOnlyMark
-\item Support \opt{uniquelist} globally/per-type/per-entry\see{use:opt:pre:int}\BiberOnlyMark
-\item Support \opt{uniquename} globally/per-type/per-entry\see{use:opt:pre:int}\BiberOnlyMark
-\item Added \cmd{textcite} and \cmd{textcites} to all \texttt{verbose} citation styles\see{use:xbx:cbx}
-\item Added special field formats \texttt{date}, \texttt{urldate}, \texttt{origdate}, \texttt{eventdate}\see{aut:fmt:ich}
-\item Added \cmd{mkcomprange*}\see{aut:aux:msc}
-\item Added \cmd{mkfirstpage*}\see{aut:aux:msc}
-\item Added \cmd{volcitedelim}\see{aut:fmt:fmt}
-\item Added missing documentation for \cmd{ifentrytype}\see{aut:aux:tst}
-\item Added \cmd{mkbibneutord}\see{use:fmt:lng}
-\item Added counter \cnt{biburlnumpenalty}\see{aut:fmt:len}
-\item Added counter \cnt{biburlucpenalty}\see{aut:fmt:len}
-\item Added counter \cnt{biburllcpenalty}\see{aut:fmt:len}
-\item Added localization keys \texttt{book}, \texttt{part}, \texttt{issue}, \texttt{forthcoming}\see{aut:lng:key}
-\item Added some \texttt{lang...} and \texttt{from...} localization keys\see{aut:lng:key}
-\item Expanded documentation\see{apx:opt}
-\item Added support for Russian (Oleg Domanov)
-\item Updated support for Dutch (Pieter Belmans)
-\item Fixed compatibility issue with \sty{textcase} package
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.6}{2011-07-29}
-\item Added special field \bibfield{sortshorthand}\see{bib:fld:spc}\BiberOnlyMark
-\item Revised options \opt{maxnames}/\opt{minnames}\see{use:opt:pre:gen}
-\item Options \opt{maxcitenames}/\opt{mincitenames} now supported by backend\see{use:opt:pre:gen}\BiberOnlyMark
-\item Options \opt{maxbibnames}/\opt{minbibnames} now supported by backend\see{use:opt:pre:gen}\BiberOnlyMark
-\item Added options \opt{maxalphanames}/\opt{minalphanames}\see{use:opt:pre:int}\BiberOnlyMark
-\item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{printbibliography}\see{use:bib:bib}
-\item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{printbibliography}\see{use:bib:bib}
-\item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{bibbysection}\see{use:bib:bib}
-\item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{bibbysection}\see{use:bib:bib}
-\item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{bibbysegment}\see{use:bib:bib}
-\item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{bibbysegment}\see{use:bib:bib}
-\item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{bibbycategory}\see{use:bib:bib}
-\item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{bibbycategory}\see{use:bib:bib}
-\item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{printshorthands}\see{use:bib:biblist}
-\item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{printshorthands}\see{use:bib:biblist}
-\item Added special field format \bibfield{volcitevolume}\see{use:cit:spc}
-\item Added special field format \bibfield{volcitepages}\see{use:cit:spc}
-\item Added special field \bibfield{hash}\see{aut:bbx:fld:gen}\BiberOnlyMark
-\item Added \cmd{mkcomprange}\see{aut:aux:msc}
-\item Added \cmd{mkfirstpage}\see{aut:aux:msc}
-\item Removed \cmd{mkpagefirst}\see{aut:aux:msc}
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.5a}{2011-06-17}
-\item Fixed some bugs
-\end{release}
-
-\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}
-
-\begin{release}{1.4b}{2011-04-12}
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.4a}{2011-04-06}
-\item Enable \opt{uniquename} and \opt{uniquelist} in all \texttt{authortitle} styles\see{use:xbx:cbx}
-\item Enable \opt{uniquename} and \opt{uniquelist} in all \texttt{authoryear} styles\see{use:xbx:cbx}
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.4}{2011-03-31}
-\item Added package option \opt{uniquelist}\see{use:opt:pre:int}\BiberOnlyMark
-\item Added special counter \cnt{uniquelist}\see{aut:aux:tst}\BiberOnlyMark
-\item Revised and improved package option \opt{uniquename}\see{use:opt:pre:int}\BiberOnlyMark
-\item Revised and improved special counter \cnt{uniquename}\see{aut:aux:tst}\BiberOnlyMark
-\item Added \cmd{bibnamedelimi}\see{use:fmt:fmt}\BiberOnlyMark
-\item Added \cmd{bibindexnamedelima}\see{use:fmt:fmt}
-\item Added \cmd{bibindexnamedelimb}\see{use:fmt:fmt}
-\item Added \cmd{bibindexnamedelimc}\see{use:fmt:fmt}
-\item Added \cmd{bibindexnamedelimd}\see{use:fmt:fmt}
-\item Added \cmd{bibindexnamedelimi}\see{use:fmt:fmt}
-\item Added \cmd{bibindexinitperiod}\see{use:fmt:fmt}
-\item Added \cmd{bibindexinitdelim}\see{use:fmt:fmt}
-\item Added \cmd{bibindexinithyphendelim}\see{use:fmt:fmt}
-\item Fixed conflict with some \acr{AMS} classes
-\end{release}
-
-\begin{release}{1.3a}{2011-03-18}
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.3}{2011-03-14}
-\item Support \bibtype{thesis} with \bibfield{isbn}\see{bib:typ:blx}
-\item Updated \opt{terseinits} option\see{use:opt:pre:gen}
-\item Allow macros in argument to \cmd{addbibresource} and friends\see{use:bib:res}
-\item Allow macros in argument to \cmd{bibliography}\see{use:bib:res}
-\item Introducing experimental support for Zotero \acr{RDF}/\acr{XML}\see{use:bib:res}\BiberOnlyMark
-\item Introducing experimental support for EndNote \acr{XML}\see{use:bib:res}\BiberOnlyMark
-\item Added option \opt{citecounter}\see{use:opt:pre:int}
-\item Added \cnt{citecounter}\see{aut:aux:tst}
-\item Added \cmd{smartcite} and \cmd{Smartcite}\see{use:cit:cbx}
-\item Added \cmd{smartcites} and \cmd{Smartcites}\see{use:cit:mlt}
-\item Added \cmd{svolcite} and \cmd{Svolcite}\see{use:cit:spc}
-\item Added \cmd{bibnamedelima}\see{use:fmt:fmt}\BiberOnlyMark
-\item Added \cmd{bibnamedelimb}\see{use:fmt:fmt}\BiberOnlyMark
-\item Added \cmd{bibnamedelimc}\see{use:fmt:fmt}
-\item Added \cmd{bibnamedelimd}\see{use:fmt:fmt}
-\item Added \cmd{bibinitperiod}\see{use:fmt:fmt}\BiberOnlyMark
-\item Added \cmd{bibinitdelim}\see{use:fmt:fmt}\BiberOnlyMark
-\item Added \cmd{bibinithyphendelim}\see{use:fmt:fmt}\BiberOnlyMark
-\item Expanded documentation\see{use:cav:nam}
-\item Added \prm{position} parameter \texttt{f} to \cmd{DeclareAutoCiteCommand}\see{aut:cbx:cbx}
-\end{release}
-
-\begin{release}{1.2a}{2011-02-13}
-\item Fix in \cmd{mkbibmonth}\see{aut:fmt:ich}
-\end{release}
-
-\begin{release}{1.2}{2011-02-12}
-\item Added entry type \bibtype{mvbook}\see{bib:typ:blx}
-\item Added entry type \bibtype{mvcollection}\see{bib:typ:blx}
-\item Added entry type \bibtype{mvproceedings}\see{bib:typ:blx}
-\item Added entry type \bibtype{mvreference}\see{bib:typ:blx}
-\item Introducing remote resources\see{use:bib:res}\BiberOnlyMark
-\item Introducing experimental \acr{RIS} support\see{use:bib:res}\BiberOnlyMark
-\item Added \cmd{addbibresource}\see{use:bib:res}
-\item \cmd{bibliography} now deprecated\see{use:bib:res}
-\item \cmd{bibliography*} replaced by \cmd{addglobalbib}\see{use:bib:res}
-\item Added \cmd{addsectionbib}\see{use:bib:res}
-\item Updated and expanded documentation\see{bib:cav:ref}
-\item Introducing smart \bibfield{crossref} data inheritance\see{bib:cav:ref:bbr}\BiberOnlyMark
-\item Introducing \bibfield{crossref} configuration interface\see{aut:ctm:ref}\BiberOnlyMark
-\item Added \cmd{DefaultInheritance}\see{aut:ctm:ref}\BiberOnlyMark
-\item Added \cmd{DeclareDataInheritance}\see{aut:ctm:ref}\BiberOnlyMark
-\item Added \cmd{ResetDataInheritance}\see{aut:ctm:ref}\BiberOnlyMark
-\item Added \cmd{ifkeyword}\see{aut:aux:tst}
-\item Added \cmd{ifentrykeyword}\see{aut:aux:tst}
-\item Added \cmd{ifcategory}\see{aut:aux:tst}
-\item Added \cmd{ifentrycategory}\see{aut:aux:tst}
-\item Added \cmd{ifdriver}\see{aut:aux:tst}
-\item Added \cmd{forcsvfield}\see{aut:aux:msc}
-\item Extended \cmd{mkpageprefix}\see{aut:aux:msc}
-\item Extended \cmd{mkpagetotal}\see{aut:aux:msc}
-\item Extended \cmd{mkpagefirst}\see{aut:aux:msc}
-\item Added localization key \texttt{inpreparation}\see{aut:lng:key}
-\item Rearranged manual slightly, moving some tables to the appendix
-\end{release}
-
-\begin{release}{1.1b}{2011-02-04}
-\item Added option \opt{texencoding}\see{use:opt:pre:gen}\BiberOnlyMark
-\item Added option \opt{safeinputenc}\see{use:opt:pre:gen}\BiberOnlyMark
-\item Expanded documentation\see{bib:cav:enc:enc}
-\item Improved \opt{mergedate} option of bibliography style \texttt{authoryear}\see{use:xbx:bbx}
-\item Removed \opt{pass} option of \cmd{DeclareSortingScheme}\see{aut:ctm:srt}\BiberOnlyMark
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.1a}{2011-01-08}
-\item Added unsupported entry type \bibtype{bibnote}\see{bib:typ:ctm}
-\item Added \cmd{bibliography*}\see{use:bib:res}
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.1}{2011-01-05}
-\item Added option \opt{maxbibnames}\see{use:opt:pre:gen}
-\item Added option \opt{minbibnames}\see{use:opt:pre:gen}
-\item Added option \opt{maxcitenames}\see{use:opt:pre:gen}
-\item Added option \opt{mincitenames}\see{use:opt:pre:gen}
-\item Fixed \kvopt{idemtracker}{strict} and \kvopt{idemtracker}{constrict}\see{use:opt:pre:int}
-\item Added option \opt{mergedate} to bibliography style \texttt{authoryear}\see{use:xbx:bbx}
-\item Added support for \opt{prefixnumbers} to bibliography style \texttt{alphabetic}\see{use:xbx:bbx}
-\item Made option \bibfield{useprefix} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \bibfield{useauthor} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \bibfield{useeditor} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \opt{usetranslator} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \opt{skipbib} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \opt{skiplos} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \opt{skiplab} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \opt{dataonly} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
-\item Made option \opt{labelalpha} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
-\item Made option \opt{labelnumber} settable on a per-type basis\see{use:opt:pre:int}
-\item Made option \opt{labelyear} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
-\item Made option \opt{singletitle} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
-\item Made option \opt{uniquename} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
-\item Made option \opt{indexing} settable on a per-type basis\see{use:opt:pre:gen}
-\item Made option \opt{indexing} settable on a per-entry basis\see{use:opt:pre:gen}
-\item Extended \cmd{ExecuteBibliographyOptions}\see{use:cfg:opt}
-\item Added \cmd{citedate}\see{use:cit:txt}
-\item Improved static entry sets\see{use:use:set}\BiberOnlyMark
-\item Introducing dynamic entry sets\see{use:use:set}\BiberOnlyMark
-\item Added \cmd{defbibentryset}\see{use:bib:set}\BiberOnlyMark
-\item Added option \opt{mcite}\see{use:opt:ldt}\BiberOnlyMark
-\item Added \sty{mcite}\slash\sty{mciteplus}-like commands\see{use:cit:mct}\BiberOnlyMark
-\item Added \cmd{sortalphaothers}\see{use:fmt:fmt}\BiberOnlyMark
-\item Extended \cmd{DeclareNameFormat}\see{aut:bib:fmt}
-\item Extended \cmd{DeclareIndexNameFormat}\see{aut:bib:fmt}
-\item Extended \cmd{DeclareListFormat}\see{aut:bib:fmt}
-\item Extended \cmd{DeclareIndexListFormat}\see{aut:bib:fmt}
-\item Extended \cmd{DeclareFieldFormat}\see{aut:bib:fmt}
-\item Extended \cmd{DeclareIndexFieldFormat}\see{aut:bib:fmt}
-\item Added \cmd{DeclareNameFormat*}\see{aut:bib:fmt}
-\item Added \cmd{DeclareIndexNameFormat*}\see{aut:bib:fmt}
-\item Added \cmd{DeclareListFormat*}\see{aut:bib:fmt}
-\item Added \cmd{DeclareIndexListFormat*}\see{aut:bib:fmt}
-\item Added \cmd{DeclareFieldFormat*}\see{aut:bib:fmt}
-\item Added \cmd{DeclareIndexFieldFormat*}\see{aut:bib:fmt}
-\item Introducing configurable sorting schemes\BiberOnlyMark
-\item Added \cmd{DeclareSortingScheme}\see{aut:ctm:srt}\BiberOnlyMark
-\item Added \cmd{DeclarePresort}\see{aut:ctm:srt}\BiberOnlyMark
-\item Added \cmd{DeclareSortExclusion}\see{aut:ctm:srt}\BiberOnlyMark
-\item Added \cmd{DeclareLabelname}\see{aut:ctm:fld}\BiberOnlyMark
-\item Added \cmd{DeclareLabelyear}\see{aut:ctm:fld}\BiberOnlyMark
-\item Improved special field \bibfield{labelname}\see{aut:bbx:fld}\BiberOnlyMark
-\item Improved special field \bibfield{labelyear}\see{aut:bbx:fld}\BiberOnlyMark
-\item Added \cmd{entrydata*}\see{aut:bib:dat}
-\item Added \cmd{RequireBiber}\see{aut:aux:msc}
-\item Added option \opt{check} to \cmd{printbibliography}\see{use:bib:bib}
-\item Added option \opt{check} to \cmd{printshorthands}\see{use:bib:biblist}
-\item Added \cmd{defbibcheck}\see{use:bib:flt}
-\item Updated support for Portuguese (José Carlos Santos)
-\item Fixed conflict with \sty{titletoc}
-\item Fixed some bugs
-\end{release}
-
-\begin{release}{1.0}{2010-11-19}
-\item First officially stable release
-\item Renamed option \kvopt{bibencoding}{inputenc} to \kvopt{bibencoding}{auto}\see{use:opt:pre:gen}
-\item Made \kvopt{bibencoding}{auto} the package default\see{use:opt:pre:gen}
-\item Added option \kvopt{backend}{bibtexu}\see{use:opt:pre:gen}
-\item Slightly updated documentation\see{bib:cav:enc}
-\item Updated support for Dutch (Alexander van Loon)
-\item Updated support for Italian (Andrea Marchitelli)
-\end{release}
+% \begin{release}{1.7}{2011-11-13}
+% \item Added \texttt{xdata} containers\see{use:use:xdat}\BiberOnlyMark
+% \item Added special entry type \bibfield{xdata}\see{bib:typ:blx}\BiberOnlyMark
+% \item Added special field \bibfield{xdata}\see{bib:fld:spc}\BiberOnlyMark
+% \item Support \opt{maxnames}/\opt{minnames} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Support \opt{maxbibnames}/\opt{minbibnames} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Support \opt{maxcitenames}/\opt{mincitenames} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Support \opt{maxitems}/\opt{minitems} globally/per-type/per-entry\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Support \opt{maxalphanames}/\opt{minalphanames} globally/per-type/per-entry\see{use:opt:pre:int}\BiberOnlyMark
+% \item Support \opt{uniquelist} globally/per-type/per-entry\see{use:opt:pre:int}\BiberOnlyMark
+% \item Support \opt{uniquename} globally/per-type/per-entry\see{use:opt:pre:int}\BiberOnlyMark
+% \item Added \cmd{textcite} and \cmd{textcites} to all \texttt{verbose} citation styles\see{use:xbx:cbx}
+% \item Added special field formats \texttt{date}, \texttt{urldate}, \texttt{origdate}, \texttt{eventdate}\see{aut:fmt:ich}
+% \item Added \cmd{mkcomprange*}\see{aut:aux:msc}
+% \item Added \cmd{mkfirstpage*}\see{aut:aux:msc}
+% \item Added \cmd{volcitedelim}\see{aut:fmt:fmt}
+% \item Added missing documentation for \cmd{ifentrytype}\see{aut:aux:tst}
+% \item Added \cmd{mkbibneutord}\see{use:fmt:lng}
+% \item Added counter \cnt{biburlnumpenalty}\see{aut:fmt:len}
+% \item Added counter \cnt{biburlucpenalty}\see{aut:fmt:len}
+% \item Added counter \cnt{biburllcpenalty}\see{aut:fmt:len}
+% \item Added localization keys \texttt{book}, \texttt{part}, \texttt{issue}, \texttt{forthcoming}\see{aut:lng:key}
+% \item Added some \texttt{lang...} and \texttt{from...} localization keys\see{aut:lng:key}
+% \item Expanded documentation\see{apx:opt}
+% \item Added support for Russian (Oleg Domanov)
+% \item Updated support for Dutch (Pieter Belmans)
+% \item Fixed compatibility issue with \sty{textcase} package
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.6}{2011-07-29}
+% \item Added special field \bibfield{sortshorthand}\see{bib:fld:spc}\BiberOnlyMark
+% \item Revised options \opt{maxnames}/\opt{minnames}\see{use:opt:pre:gen}
+% \item Options \opt{maxcitenames}/\opt{mincitenames} now supported by backend\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Options \opt{maxbibnames}/\opt{minbibnames} now supported by backend\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Added options \opt{maxalphanames}/\opt{minalphanames}\see{use:opt:pre:int}\BiberOnlyMark
+% \item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{printbibliography}\see{use:bib:bib}
+% \item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{printbibliography}\see{use:bib:bib}
+% \item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{bibbysection}\see{use:bib:bib}
+% \item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{bibbysection}\see{use:bib:bib}
+% \item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{bibbysegment}\see{use:bib:bib}
+% \item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{bibbysegment}\see{use:bib:bib}
+% \item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{bibbycategory}\see{use:bib:bib}
+% \item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{bibbycategory}\see{use:bib:bib}
+% \item Removed local options \opt{maxnames}/\opt{minnames} from \cmd{printshorthands}\see{use:bib:biblist}
+% \item Removed local options \opt{maxitems}/\opt{minitems} from \cmd{printshorthands}\see{use:bib:biblist}
+% \item Added special field format \bibfield{volcitevolume}\see{use:cit:spc}
+% \item Added special field format \bibfield{volcitepages}\see{use:cit:spc}
+% \item Added special field \bibfield{hash}\see{aut:bbx:fld:gen}\BiberOnlyMark
+% \item Added \cmd{mkcomprange}\see{aut:aux:msc}
+% \item Added \cmd{mkfirstpage}\see{aut:aux:msc}
+% \item Removed \cmd{mkpagefirst}\see{aut:aux:msc}
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.5a}{2011-06-17}
+% \item Fixed some bugs
+% \end{release}
+
+% \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}
+
+% \begin{release}{1.4b}{2011-04-12}
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.4a}{2011-04-06}
+% \item Enable \opt{uniquename} and \opt{uniquelist} in all \texttt{authortitle} styles\see{use:xbx:cbx}
+% \item Enable \opt{uniquename} and \opt{uniquelist} in all \texttt{authoryear} styles\see{use:xbx:cbx}
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.4}{2011-03-31}
+% \item Added package option \opt{uniquelist}\see{use:opt:pre:int}\BiberOnlyMark
+% \item Added special counter \cnt{uniquelist}\see{aut:aux:tst}\BiberOnlyMark
+% \item Revised and improved package option \opt{uniquename}\see{use:opt:pre:int}\BiberOnlyMark
+% \item Revised and improved special counter \cnt{uniquename}\see{aut:aux:tst}\BiberOnlyMark
+% \item Added \cmd{bibnamedelimi}\see{use:fmt:fmt}\BiberOnlyMark
+% \item Added \cmd{bibindexnamedelima}\see{use:fmt:fmt}
+% \item Added \cmd{bibindexnamedelimb}\see{use:fmt:fmt}
+% \item Added \cmd{bibindexnamedelimc}\see{use:fmt:fmt}
+% \item Added \cmd{bibindexnamedelimd}\see{use:fmt:fmt}
+% \item Added \cmd{bibindexnamedelimi}\see{use:fmt:fmt}
+% \item Added \cmd{bibindexinitperiod}\see{use:fmt:fmt}
+% \item Added \cmd{bibindexinitdelim}\see{use:fmt:fmt}
+% \item Added \cmd{bibindexinithyphendelim}\see{use:fmt:fmt}
+% \item Fixed conflict with some \acr{AMS} classes
+% \end{release}
+
+% \begin{release}{1.3a}{2011-03-18}
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.3}{2011-03-14}
+% \item Support \bibtype{thesis} with \bibfield{isbn}\see{bib:typ:blx}
+% \item Updated \opt{terseinits} option\see{use:opt:pre:gen}
+% \item Allow macros in argument to \cmd{addbibresource} and friends\see{use:bib:res}
+% \item Allow macros in argument to \cmd{bibliography}\see{use:bib:res}
+% \item Introducing experimental support for Zotero \acr{RDF}/\acr{XML}\see{use:bib:res}\BiberOnlyMark
+% \item Introducing experimental support for EndNote \acr{XML}\see{use:bib:res}\BiberOnlyMark
+% \item Added option \opt{citecounter}\see{use:opt:pre:int}
+% \item Added \cnt{citecounter}\see{aut:aux:tst}
+% \item Added \cmd{smartcite} and \cmd{Smartcite}\see{use:cit:cbx}
+% \item Added \cmd{smartcites} and \cmd{Smartcites}\see{use:cit:mlt}
+% \item Added \cmd{svolcite} and \cmd{Svolcite}\see{use:cit:spc}
+% \item Added \cmd{bibnamedelima}\see{use:fmt:fmt}\BiberOnlyMark
+% \item Added \cmd{bibnamedelimb}\see{use:fmt:fmt}\BiberOnlyMark
+% \item Added \cmd{bibnamedelimc}\see{use:fmt:fmt}
+% \item Added \cmd{bibnamedelimd}\see{use:fmt:fmt}
+% \item Added \cmd{bibinitperiod}\see{use:fmt:fmt}\BiberOnlyMark
+% \item Added \cmd{bibinitdelim}\see{use:fmt:fmt}\BiberOnlyMark
+% \item Added \cmd{bibinithyphendelim}\see{use:fmt:fmt}\BiberOnlyMark
+% \item Expanded documentation\see{use:cav:nam}
+% \item Added \prm{position} parameter \texttt{f} to \cmd{DeclareAutoCiteCommand}\see{aut:cbx:cbx}
+% \end{release}
+
+% \begin{release}{1.2a}{2011-02-13}
+% \item Fix in \cmd{mkbibmonth}\see{aut:fmt:ich}
+% \end{release}
+
+% \begin{release}{1.2}{2011-02-12}
+% \item Added entry type \bibtype{mvbook}\see{bib:typ:blx}
+% \item Added entry type \bibtype{mvcollection}\see{bib:typ:blx}
+% \item Added entry type \bibtype{mvproceedings}\see{bib:typ:blx}
+% \item Added entry type \bibtype{mvreference}\see{bib:typ:blx}
+% \item Introducing remote resources\see{use:bib:res}\BiberOnlyMark
+% \item Introducing experimental \acr{RIS} support\see{use:bib:res}\BiberOnlyMark
+% \item Added \cmd{addbibresource}\see{use:bib:res}
+% \item \cmd{bibliography} now deprecated\see{use:bib:res}
+% \item \cmd{bibliography*} replaced by \cmd{addglobalbib}\see{use:bib:res}
+% \item Added \cmd{addsectionbib}\see{use:bib:res}
+% \item Updated and expanded documentation\see{bib:cav:ref}
+% \item Introducing smart \bibfield{crossref} data inheritance\see{bib:cav:ref:bbr}\BiberOnlyMark
+% \item Introducing \bibfield{crossref} configuration interface\see{aut:ctm:ref}\BiberOnlyMark
+% \item Added \cmd{DefaultInheritance}\see{aut:ctm:ref}\BiberOnlyMark
+% \item Added \cmd{DeclareDataInheritance}\see{aut:ctm:ref}\BiberOnlyMark
+% \item Added \cmd{ResetDataInheritance}\see{aut:ctm:ref}\BiberOnlyMark
+% \item Added \cmd{ifkeyword}\see{aut:aux:tst}
+% \item Added \cmd{ifentrykeyword}\see{aut:aux:tst}
+% \item Added \cmd{ifcategory}\see{aut:aux:tst}
+% \item Added \cmd{ifentrycategory}\see{aut:aux:tst}
+% \item Added \cmd{ifdriver}\see{aut:aux:tst}
+% \item Added \cmd{forcsvfield}\see{aut:aux:msc}
+% \item Extended \cmd{mkpageprefix}\see{aut:aux:msc}
+% \item Extended \cmd{mkpagetotal}\see{aut:aux:msc}
+% \item Extended \cmd{mkpagefirst}\see{aut:aux:msc}
+% \item Added localization key \texttt{inpreparation}\see{aut:lng:key}
+% \item Rearranged manual slightly, moving some tables to the appendix
+% \end{release}
+
+% \begin{release}{1.1b}{2011-02-04}
+% \item Added option \opt{texencoding}\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Added option \opt{safeinputenc}\see{use:opt:pre:gen}\BiberOnlyMark
+% \item Expanded documentation\see{bib:cav:enc:enc}
+% \item Improved \opt{mergedate} option of bibliography style \texttt{authoryear}\see{use:xbx:bbx}
+% \item Removed \opt{pass} option of \cmd{DeclareSortingScheme}\see{aut:ctm:srt}\BiberOnlyMark
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.1a}{2011-01-08}
+% \item Added unsupported entry type \bibtype{bibnote}\see{bib:typ:ctm}
+% \item Added \cmd{bibliography*}\see{use:bib:res}
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.1}{2011-01-05}
+% \item Added option \opt{maxbibnames}\see{use:opt:pre:gen}
+% \item Added option \opt{minbibnames}\see{use:opt:pre:gen}
+% \item Added option \opt{maxcitenames}\see{use:opt:pre:gen}
+% \item Added option \opt{mincitenames}\see{use:opt:pre:gen}
+% \item Fixed \kvopt{idemtracker}{strict} and \kvopt{idemtracker}{constrict}\see{use:opt:pre:int}
+% \item Added option \opt{mergedate} to bibliography style \texttt{authoryear}\see{use:xbx:bbx}
+% \item Added support for \opt{prefixnumbers} to bibliography style \texttt{alphabetic}\see{use:xbx:bbx}
+% \item Made option \bibfield{useprefix} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \bibfield{useauthor} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \bibfield{useeditor} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \opt{usetranslator} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \opt{skipbib} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \opt{skiplos} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \opt{skiplab} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \opt{dataonly} settable on a per-type basis\see{use:opt:bib}\BiberOnlyMark
+% \item Made option \opt{labelalpha} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
+% \item Made option \opt{labelnumber} settable on a per-type basis\see{use:opt:pre:int}
+% \item Made option \opt{labelyear} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
+% \item Made option \opt{singletitle} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
+% \item Made option \opt{uniquename} settable on a per-type basis\see{use:opt:pre:int}\BiberOnlyMark
+% \item Made option \opt{indexing} settable on a per-type basis\see{use:opt:pre:gen}
+% \item Made option \opt{indexing} settable on a per-entry basis\see{use:opt:pre:gen}
+% \item Extended \cmd{ExecuteBibliographyOptions}\see{use:cfg:opt}
+% \item Added \cmd{citedate}\see{use:cit:txt}
+% \item Improved static entry sets\see{use:use:set}\BiberOnlyMark
+% \item Introducing dynamic entry sets\see{use:use:set}\BiberOnlyMark
+% \item Added \cmd{defbibentryset}\see{use:bib:set}\BiberOnlyMark
+% \item Added option \opt{mcite}\see{use:opt:ldt}\BiberOnlyMark
+% \item Added \sty{mcite}\slash\sty{mciteplus}-like commands\see{use:cit:mct}\BiberOnlyMark
+% \item Added \cmd{sortalphaothers}\see{use:fmt:fmt}\BiberOnlyMark
+% \item Extended \cmd{DeclareNameFormat}\see{aut:bib:fmt}
+% \item Extended \cmd{DeclareIndexNameFormat}\see{aut:bib:fmt}
+% \item Extended \cmd{DeclareListFormat}\see{aut:bib:fmt}
+% \item Extended \cmd{DeclareIndexListFormat}\see{aut:bib:fmt}
+% \item Extended \cmd{DeclareFieldFormat}\see{aut:bib:fmt}
+% \item Extended \cmd{DeclareIndexFieldFormat}\see{aut:bib:fmt}
+% \item Added \cmd{DeclareNameFormat*}\see{aut:bib:fmt}
+% \item Added \cmd{DeclareIndexNameFormat*}\see{aut:bib:fmt}
+% \item Added \cmd{DeclareListFormat*}\see{aut:bib:fmt}
+% \item Added \cmd{DeclareIndexListFormat*}\see{aut:bib:fmt}
+% \item Added \cmd{DeclareFieldFormat*}\see{aut:bib:fmt}
+% \item Added \cmd{DeclareIndexFieldFormat*}\see{aut:bib:fmt}
+% \item Introducing configurable sorting schemes\BiberOnlyMark
+% \item Added \cmd{DeclareSortingScheme}\see{aut:ctm:srt}\BiberOnlyMark
+% \item Added \cmd{DeclarePresort}\see{aut:ctm:srt}\BiberOnlyMark
+% \item Added \cmd{DeclareSortExclusion}\see{aut:ctm:srt}\BiberOnlyMark
+% \item Added \cmd{DeclareLabelname}\see{aut:ctm:fld}\BiberOnlyMark
+% \item Added \cmd{DeclareLabelyear}\see{aut:ctm:fld}\BiberOnlyMark
+% \item Improved special field \bibfield{labelname}\see{aut:bbx:fld}\BiberOnlyMark
+% \item Improved special field \bibfield{labelyear}\see{aut:bbx:fld}\BiberOnlyMark
+% \item Added \cmd{entrydata*}\see{aut:bib:dat}
+% \item Added \cmd{RequireBiber}\see{aut:aux:msc}
+% \item Added option \opt{check} to \cmd{printbibliography}\see{use:bib:bib}
+% \item Added option \opt{check} to \cmd{printshorthands}\see{use:bib:biblist}
+% \item Added \cmd{defbibcheck}\see{use:bib:flt}
+% \item Updated support for Portuguese (José Carlos Santos)
+% \item Fixed conflict with \sty{titletoc}
+% \item Fixed some bugs
+% \end{release}
+
+% \begin{release}{1.0}{2010-11-19}
+% \item First officially stable release
+% \item Renamed option \kvopt{bibencoding}{inputenc} to \kvopt{bibencoding}{auto}\see{use:opt:pre:gen}
+% \item Made \kvopt{bibencoding}{auto} the package default\see{use:opt:pre:gen}
+% \item Added option \kvopt{backend}{bibtexu}\see{use:opt:pre:gen}
+% \item Slightly updated documentation\see{bib:cav:enc}
+% \item Updated support for Dutch (Alexander van Loon)
+% \item Updated support for Italian (Andrea Marchitelli)
+% \end{release}
%\begin{release}{0.9e}{2010-10-09}
%\item Updated and expanded manual\see{bib:cav:enc}
diff --git a/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex b/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex
index fd0541ec57c..87b12801f19 100644
--- a/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex
+++ b/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex
@@ -32,7 +32,7 @@
%\usepackage[utf8]{inputenc}
%\usepackage[russian]{babel}
% -- Greek
-%\usepackage[LGRx,T1]{fontenc}
+%\usepackage[T1]{fontenc}
%\usepackage[utf8]{inputenx}
%\usepackage[english,greek]{babel}
@@ -71,10 +71,10 @@
\begingroup
\keyitemhook%
\blx@bibinit%
- \midsentence\biblstring{#1}%
+ \midsentence\ifbibstring{#1}{}{\latintext}\biblstring{#1}%
\expandafter\lbx@initnamehook\lsmartoftext%
\par\nobreak
- \midsentence\bibsstring{#1}%
+ \midsentence\ifbibstring{#1}{}{\latintext}\bibsstring{#1}%
\expandafter\lbx@initnamehook\ssmartoftext%
\endgroup
\par\nobreak}
@@ -86,7 +86,7 @@
\preto{\UrlFont}{\latintext}
\pretocmd{\printbibliography}{\greektext}{}{}}{}
\AtBeginBibliography{\raggedright}
-\MakeAutoQuote*{<}{>}
+\AtBeginDocument{\MakeAutoQuote*{<}{>}}
% user-configurable commands
\newcommand{\keyitemhook}{}
diff --git a/Master/texmf-dist/doc/latex/biblatex/examples/91-sorting-schemes.tex b/Master/texmf-dist/doc/latex/biblatex/examples/91-sorting-schemes.tex
index 81d1bdecc0e..a00c9eb751d 100644
--- a/Master/texmf-dist/doc/latex/biblatex/examples/91-sorting-schemes.tex
+++ b/Master/texmf-dist/doc/latex/biblatex/examples/91-sorting-schemes.tex
@@ -11,5 +11,6 @@
\addbibresource{biblatex-examples.bib}
\begin{document}
Filler text \parencite{wassenberg,cicero,companion,angenendt}.
-\printbibliography[sorting=nyt]
+\newrefcontext[sorting=nyt]
+\printbibliography
\end{document}
diff --git a/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib b/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib
index 9bd2950221f..e9b21a3d53e 100644
--- a/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib
+++ b/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib
@@ -10,7 +10,7 @@
@incollection{westfahl:space,
author = {Westfahl, Gary},
title = {The True Frontier},
- subtitle = {Confronting and Avoiding the Realities of Space in American
+ subtitle = {Confronting and Avoiding the Realities of Space in {American}
Science Fiction Films},
pages = {55-65},
crossref = {westfahl:frontier},
@@ -45,7 +45,7 @@
and {\c{C}}etinkaya, Bekir and Ni, Chaoying and
B{\"u}y{\"u}kg{\"u}ng{\"o}r, Orhan and {\"O}zkal, Erhan},
title = {Effect of immobilization on catalytic characteristics of
- saturated Pd-N-heterocyclic carbenes in Mizoroki-Heck
+ saturated {Pd-N}-heterocyclic carbenes in {Mizoroki-Heck}
reactions},
journaltitle = jomch,
date = 2006,
@@ -73,7 +73,7 @@
@article{baez/article,
author = {Baez, John C. and Lauda, Aaron D.},
- title = {Higher-Dimensional Algebra V: 2-Groups},
+ title = {Higher-Dimensional Algebra {V}: 2-Groups},
journaltitle = {Theory and Applications of Categories},
date = 2004,
volume = 12,
@@ -92,7 +92,7 @@
@article{bertram,
author = {Bertram, Aaron and Wentworth, Richard},
- title = {Gromov invariants for holomorphic maps on Riemann surfaces},
+ title = {Gromov invariants for holomorphic maps on {Riemann} surfaces},
journaltitle = jams,
date = 1996,
volume = 9,
@@ -107,7 +107,7 @@
@article{doody,
author = {Doody, Terrence},
- title = {Hemingway's Style and Jake's Narration},
+ title = {Hemingway's Style and {Jake's} Narration},
year = 1974,
volume = 4,
number = 3,
@@ -139,7 +139,7 @@
@article{gillies,
author = {Gillies, Alexander},
- title = {Herder and the Preparation of Goethe's Idea of World
+ title = {Herder and the Preparation of {Goethe's} Idea of World
Literature},
journaltitle = {Publications of the English Goethe Society},
date = 1933,
@@ -165,7 +165,7 @@
@article{herrmann,
author = {Herrmann, Wolfgang A. and {\"O}fele, Karl and Schneider,
Sabine K. and Herdtweck, Eberhardt and Hoffmann, Stephan D.},
- title = {A carbocyclic carbene as an efficient catalyst ligand for C--C
+ title = {A carbocyclic carbene as an efficient catalyst ligand for {C--C}
coupling reactions},
journaltitle = anch-ie,
date = 2006,
@@ -181,7 +181,7 @@
free energies from molecular simulations},
journaltitle = jchph,
date = 2006,
- subtitle = {I. The electrostatic potential in molecular liquids},
+ subtitle = {{I}. {The} electrostatic potential in molecular liquids},
volume = 124,
eid = 124106,
doi = {10.1063/1.2172593},
@@ -224,7 +224,7 @@
Gary L. and Porter, Marc D. and Evans, Neal D. and Murray,
Royce W.},
title = {Alkanethiolate gold cluster molecules with core diameters from
- 1.5 to 5.2~nm},
+ 1.5 to 5.2~{nm}},
journaltitle = {Langmuir},
date = 1998,
subtitle = {Core and monolayer properties as a function of core size},
@@ -242,7 +242,7 @@
@article{reese,
author = {Reese, Trevor R.},
- title = {Georgia in Anglo-Spanish Diplomacy, 1736-1739},
+ title = {Georgia in {Anglo-Spanish} Diplomacy, 1736--1739},
journaltitle = {William and Mary Quarterly},
date = 1958,
series = 3,
@@ -340,7 +340,7 @@
@article{springer,
author = {Springer, Otto},
- title = {Mediaeval Pilgrim Routes from Scandinavia to Rome},
+ title = {Mediaeval Pilgrim Routes from {Scandinavia} to {Rome}},
journaltitle = {Mediaeval Studies},
date = 1950,
volume = 12,
@@ -364,7 +364,7 @@
author = {Yoon, Myeong S. and Ryu, Dowook and Kim, Jeongryul and Ahn,
Kyo Han},
title = {Palladium pincer complexes with reduced bond angle strain:
- efficient catalysts for the Heck reaction},
+ efficient catalysts for the {Heck} reaction},
journaltitle = {Organometallics},
date = 2006,
volume = 25,
@@ -406,7 +406,7 @@
title = {Poetics},
date = 1968,
editor = {Lucas, D. W.},
- series = {Clarendon Aristotle},
+ series = {Clarendon {Aristotle}},
publisher = {Clarendon Press},
location = {Oxford},
keywords = {primary},
@@ -419,8 +419,8 @@
@book{aristotle:rhetoric,
author = {Aristotle},
- title = {The Rhetoric of Aristotle with a commentary by the late Edward
- Meredith Cope},
+ title = {The Rhetoric of {Aristotle} with a commentary by the late {Edward
+ Meredith Cope}},
date = 1877,
editor = {Cope, Edward Meredith},
commentator = {Cope, Edward Meredith},
@@ -430,7 +430,7 @@
langid = {english},
langidopts = {variant=british},
sorttitle = {Rhetoric of Aristotle},
- indextitle = {Rhetoric of Aristotle, The},
+ indextitle = {Rhetoric of {Aristotle}, The},
shorttitle = {Rhetoric},
annotation = {A commented edition. Note the concatenation of the
\texttt{editor} and \texttt{commentator} fields as well as the
@@ -453,11 +453,11 @@
@book{averroes/bland,
author = {Averroes},
title = {The Epistle on the Possibility of Conjunction with the Active
- Intellect by Ibn Rushd with the Commentary of Moses Narboni},
+ Intellect by {Ibn Rushd} with the Commentary of {Moses Narboni}},
date = 1982,
editor = {Bland, Kalman P.},
translator = {Bland, Kalman P.},
- series = {Moreshet: Studies in Jewish History, Literature and Thought},
+ series = {Moreshet: Studies in {Jewish} History, Literature and Thought},
number = 7,
publisher = {Jewish Theological Seminary of America},
location = {New York},
@@ -539,11 +539,11 @@
@book{coleridge,
author = {Coleridge, Samuel Taylor},
- title = {Biographia literaria, or Biographical sketches of my literary
+ title = {Biographia literaria, or {Biographical} sketches of my literary
life and opinions},
date = 1983,
editor = {Coburn, Kathleen and Engell, James and Bate, W. Jackson},
- maintitle = {The collected works of Samuel Taylor Coleridge},
+ maintitle = {The collected works of {Samuel Taylor Coleridge}},
volume = 7,
part = 2,
series = {Bollingen Series},
@@ -563,7 +563,7 @@
@book{companion,
author = {Goossens, Michel and Mittelbach, Frank and Samarin, Alexander},
- title = {The LaTeX Companion},
+ title = {The {LaTeX} Companion},
date = 1994,
edition = 1,
publisher = {Addison-Wesley},
@@ -614,7 +614,7 @@
@book{gonzalez,
author = {Gonzalez, Ray},
- title = {The Ghost of John Wayne and Other Stories},
+ title = {The Ghost of {John Wayne} and Other Stories},
date = 2001,
publisher = {The University of Arizona Press},
location = {Tucson},
@@ -622,8 +622,8 @@
langid = {english},
langidopts = {variant=american},
sorttitle = {Ghost of John Wayne and Other Stories},
- indextitle = {Ghost of John Wayne and Other Stories, The},
- shorttitle = {Ghost of John Wayne},
+ indextitle = {Ghost of {John Wayne} and Other Stories, The},
+ shorttitle = {Ghost of {John Wayne}},
annotation = {A collection of short stories. This is a \texttt{book} entry.
Note the \texttt{sorttitle} and \texttt{indextitle} fields in
the database file. There's also an \texttt{isbn} field},
@@ -684,7 +684,7 @@
@book{knuth:ct:a,
author = {Knuth, Donald E.},
- title = {The \TeX book},
+ title = {The {\TeX} book},
date = 1984,
maintitle = {Computers \& Typesetting},
volume = {A},
@@ -727,7 +727,7 @@
@book{knuth:ct:c,
author = {Knuth, Donald E.},
- title = {The METAFONTbook},
+ title = {The {METAFONTbook}},
date = 1986,
maintitle = {Computers \& Typesetting},
volume = {C},
@@ -763,7 +763,7 @@
@book{knuth:ct:e,
author = {Knuth, Donald E.},
- title = {Computer Modern Typefaces},
+ title = {{Computer Modern} Typefaces},
date = 1986,
maintitle = {Computers \& Typesetting},
volume = {E},
@@ -837,7 +837,7 @@
@book{malinowski,
author = {Malinowski, Bronis{\l}aw},
- title = {Argonauts of the Western Pacific},
+ title = {Argonauts of the {Western Pacific}},
date = 1972,
edition = 8,
publisher = {Routledge {and} Kegan Paul},
@@ -845,7 +845,7 @@
langid = {english},
langidopts = {variant=british},
subtitle = {An account of native enterprise and adventure in the
- Archipelagoes of Melanesian New Guinea},
+ Archipelagoes of {Melanesian New Guinea}},
shorttitle = {Argonauts},
annotation = {This is a \texttt{book} entry. Note the format of the
\texttt{publisher} and \texttt{edition} fields as well as the
@@ -984,7 +984,7 @@
location = {Durham and London},
langid = {english},
langidopts = {variant=american},
- subtitle = {Crime in Mexico City, 1900--1931},
+ subtitle = {Crime in {Mexico City}, 1900--1931},
shorttitle = {City of Suspects},
annotation = {This is a \texttt{book} entry. Note the format of the
\texttt{location} field in the database file},
@@ -1084,7 +1084,7 @@
title = {The Importance of Being Earnest: A Trivial Comedy for Serious
People},
year = 1899,
- series = {English and American drama of the Nineteenth Century},
+ series = {English and {American} drama of the Nineteenth Century},
publisher = {Leonard Smithers {and} Company},
eprint = {4HIWAAAAYAAJ},
eprinttype = {googlebooks},
@@ -1102,7 +1102,7 @@
langidopts = {variant=american},
sorttitle = {Cast of Character},
indextitle = {Cast of Character, The},
- subtitle = {Style in Greek Literature},
+ subtitle = {Style in {Greek} Literature},
shorttitle = {Cast of Character},
annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and
\texttt{indextitle} fields},
@@ -1110,7 +1110,7 @@
@collection{britannica,
editor = {Preece, Warren E.},
- title = {The New Encyclop{\ae}dia Britannica},
+ title = {The {New Encyclop{\ae}dia Britannica}},
date = 2003,
edition = 15,
volumes = 32,
@@ -1121,8 +1121,8 @@
langid = {english},
langidopts = {variant=british},
sorttitle = {Encyclop{\ae}dia Britannica},
- indextitle = {Encyclop{\ae}dia Britannica, The New},
- shorttitle = {Encyclop{\ae}dia Britannica},
+ indextitle = {{Encyclop{\ae}dia Britannica}, The {New}},
+ shorttitle = {{Encyclop{\ae}dia Britannica}},
annotation = {This is a \texttt{collection} entry for an encyclopedia. Note
the \texttt{useeditor} option in the \texttt{options} field as
well as the \texttt{sorttitle} field. We want this entry to be
@@ -1169,6 +1169,7 @@
edition = 2,
volumes = 2,
location = {Leipzig},
+ langid = {latin},
editoratype = {redactor},
indextitle = {Regesta Pontificum Romanorum},
shorttitle = {Regesta Pontificum Romanorum},
@@ -1295,9 +1296,9 @@
author = {Arthur Hyman},
editor = {O'Meara, Dominic J.},
title = {Aristotle's Theory of the Intellect and its Interpretation by
- Averroes},
+ {Averroes}},
date = 1981,
- booktitle = {Studies in Aristotle},
+ booktitle = {Studies in {Aristotle}},
series = {Studies in Philosophy and the History of Philosophy},
number = 9,
publisher = {The Catholic University of America Press},
@@ -1315,18 +1316,18 @@
@incollection{pines,
author = {Pines, Shlomo},
editor = {Twersky, Isadore},
- title = {The Limitations of Human Knowledge According to Al-Farabi, ibn
- Bajja, and Maimonides},
+ title = {The Limitations of Human Knowledge According to {Al-Farabi}, {ibn
+ Bajja}, and {Maimonides}},
date = 1979,
- booktitle = {Studies in Medieval Jewish History and Literature},
+ booktitle = {Studies in Medieval {Jewish} History and Literature},
publisher = hup,
location = {Cambridge, Mass.},
pages = {82-109},
keywords = {secondary},
langid = {english},
langidopts = {variant=american},
- indextitle = {Limitations of Human Knowledge According to Al-Farabi, ibn
- Bajja, and Maimonides, The},
+ indextitle = {Limitations of Human Knowledge According to {Al-Farabi}, {ibn
+ Bajja}, and {Maimonides}, The},
shorttitle = {Limitations of Human Knowledge},
annotation = {A typical \texttt{incollection} entry. Note the
\texttt{indextitle} field},
@@ -1363,7 +1364,7 @@
date = 1968,
booktitle = {Elementary particle theory},
booksubtitle = {Relativistic groups and analyticity},
- booktitleaddon= {Proceedings of the Eighth Nobel Symposium},
+ booktitleaddon= {Proceedings of the {Eighth Nobel Symposium}},
eventdate = {1968-05-19/1968-05-25},
venue = {Aspen{\"a}sgarden, Lerum},
publisher = {Almquist \& Wiksell},
@@ -1372,7 +1373,7 @@
}
@manual{cms,
- title = {The Chicago Manual of Style},
+ title = {The {Chicago} Manual of Style},
date = 2003,
subtitle = {The Essential Guide for Writers, Editors, and Publishers},
edition = 15,
@@ -1397,7 +1398,7 @@
@online{baez/online,
author = {Baez, John C. and Lauda, Aaron D.},
- title = {Higher-Dimensional Algebra V: 2-Groups},
+ title = {Higher-Dimensional Algebra {V}: 2-Groups},
date = {2004-10-27},
version = 3,
langid = {english},
@@ -1414,7 +1415,7 @@
title = {CTAN},
date = 2006,
url = {http://www.ctan.org},
- subtitle = {The Comprehensive TeX Archive Network},
+ subtitle = {The {Comprehensive TeX Archive Network}},
urldate = {2006-10-01},
label = {CTAN},
langid = {english},
@@ -1431,7 +1432,7 @@
@online{itzhaki,
author = {Itzhaki, Nissan},
- title = {Some remarks on 't Hooft's S-matrix for black holes},
+ title = {Some remarks on {'t Hooft's} {S}-matrix for black holes},
date = {1996-03-11},
version = 1,
langid = {english},
@@ -1452,10 +1453,10 @@
@online{markey,
author = {Markey, Nicolas},
- title = {Tame the BeaST},
+ title = {Tame the {BeaST}},
date = {2005-10-16},
url = {http://tug.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf},
- subtitle = {The B to X of BibTeX},
+ subtitle = {The {B} to {X} of {BibTeX}},
version = {1.3},
urldate = {2006-10-01},
langid = {english},
@@ -1551,7 +1552,7 @@
@patent{sorace,
author = {Sorace, Ronald E. and Reinhardt, Victor S. and Vaughn, Steven
A.},
- title = {High-Speed Digital-to-RF Converter},
+ title = {High-Speed Digital-to-{RF} Converter},
number = 5668842,
date = {1997-09-16},
holder = {{Hughes Aircraft Company}},
@@ -1577,8 +1578,8 @@
@report{chiu,
author = {Chiu, Willy W. and Chow, We Min},
- title = {A Hybrid Hierarchical Model of a Multiple Virtual Storage
- (MVS) Operating System},
+ title = {A Hybrid Hierarchical Model of a {Multiple Virtual Storage}
+ ({MVS}) Operating System},
type = {resreport},
institution = {IBM},
date = 1978,
@@ -1597,7 +1598,7 @@
@report{padhye,
author = {Padhye, Jitendra and Firoiu, Victor and Towsley, Don},
- title = {A Stochastic Model of TCP Reno Congestion Avoidance and
+ title = {A Stochastic Model of {TCP Reno} Congestion Avoidance and
Control},
type = {techreport},
institution = {University of Massachusetts},
@@ -1608,7 +1609,7 @@
langidopts = {variant=american},
sorttitle = {A Stochastic Model of TCP Reno Congestion Avoidance and
Control},
- indextitle = {Stochastic Model of TCP Reno Congestion Avoidance and Control,
+ indextitle = {Stochastic Model of {TCP Reno} Congestion Avoidance and Control,
A},
annotation = {This is a \texttt{report} entry for a technical report. Note
the format of the \texttt{type} field in the database file
@@ -1645,7 +1646,7 @@
type = {phdthesis},
institution = {Uppsala Universitet},
date = 1985,
- subtitle = {The Orkney Earldom of the Twelfth Century. A Musicological
+ subtitle = {The {Orkney Earldom} of the Twelfth Century. {A} Musicological
Study},
location = {Uppsala},
options = {useprefix=false},