summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-03-16 22:15:37 +0000
committerKarl Berry <karl@freefriends.org>2011-03-16 22:15:37 +0000
commitd34bf77a2d4ca330856db5dce536f6f65345b2d4 (patch)
tree5cdc5e41ec50be2e693ece37435231cb4107f2cc /Master/texmf-dist/doc/latex/biblatex
parentae6ef6b688e802ee3a36dde35e801dd71cc982a5 (diff)
biblatex 1.3 (15mar11)
git-svn-id: svn://tug.org/texlive/trunk@21736 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/README2
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/RELEASE61
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.pdfbin791040 -> 807613 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.tex266
4 files changed, 280 insertions, 49 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex/README b/Master/texmf-dist/doc/latex/biblatex/README
index 6c36ad4ede9..7ea5eac31db 100644
--- a/Master/texmf-dist/doc/latex/biblatex/README
+++ b/Master/texmf-dist/doc/latex/biblatex/README
@@ -1,4 +1,4 @@
-$Id: README,v 1.2a 2011/02/13 12:05:37 lehman stable $
+$Id: README,v 1.3 2011/03/14 18:25:44 lehman stable $
ABOUT
diff --git a/Master/texmf-dist/doc/latex/biblatex/RELEASE b/Master/texmf-dist/doc/latex/biblatex/RELEASE
index d46959aa328..917a5521c2a 100644
--- a/Master/texmf-dist/doc/latex/biblatex/RELEASE
+++ b/Master/texmf-dist/doc/latex/biblatex/RELEASE
@@ -1,4 +1,63 @@
-$Id: RELEASE,v 1.2a 2011/02/13 12:05:37 lehman stable $
+$Id: RELEASE,v 1.3 2011/03/14 18:25:44 lehman stable $
+
+RELEASE NOTES FOR VERSION 1.3
+
+The list of changes in Biblatex is fairly short this time. Most of
+the big feature improvements are found in Biber.
+
+* Biber 0.8.3, Biber in TeX Live main.
+
+ Update Biber to version 0.8.3 when upgrading to biblatex 1.3. Note
+ that Biber is now available from the main TeX Live repository.
+ This means that you don't need to point tlmgr to TLContrib any
+ more. It also implies that more architectures are supported.
+
+* Experimental Zotero and EndNote import [Biber only]
+
+ Biber now features import support for the Zotero RDF/XML and
+ EndNote XML formats. See the Biber manual for details and caveats.
+
+* Fine-grained name delimiter/spacing controls [Biber only]
+
+ The spacing between name parts and line breaks in names can now be
+ customized in great detail, especially with Biber. With BibTeX,
+ customization is much more limited but still possible to some
+ extent. See the manual for details.
+
+* Added citation counter
+
+ As its name suggests, the new 'citecounter' feature counts
+ citations, i.e., it indicates how many times an entry is cited in
+ a reference section. The value of the 'citecounter' counter refers
+ to the total per-entry/per-refsection citation count.
+
+ The counter works much like the citation trackers. It is useful
+ for styles which handle initial and repeated citations
+ differently. For example, you may want to suppress the
+ introduction of a shorthand of an entry in the initial citation if
+ it is cited only once anyway.
+
+* Added \smartcite command
+
+ I've added a new citation command called \smartcite (along with
+ \Smartcite, \smartcites, etc.). Essentially, this is a \footcite
+ command which behaves like \parencite when used in a footnote.
+ It's particularly useful in conjunction with autocite=footnote as
+ it makes \autocite even more versatile.
+
+ Style authors should note that the default setup for
+ autocite=footnote has been modified and now uses \smartcite
+ instead of \footcite. Providing a \smartcite command is
+ straightforward. In most cases, all you need to do in your style
+ is duplicate the definition of \footcite and adapt the wrapper
+ code like so:
+
+ \DeclareCiteCommand{\smartcite}
+ [\iffootnote{\mkbibparens}{\mkbibfootnote}]
+ {...}
+ {...}
+ {...}
+ {...}
RELEASE NOTES FOR VERSION 1.2
diff --git a/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf b/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf
index 2e1dc9fac62..05e81e08d60 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 65da61c6984..9c953baabe5 100644
--- a/Master/texmf-dist/doc/latex/biblatex/biblatex.tex
+++ b/Master/texmf-dist/doc/latex/biblatex/biblatex.tex
@@ -1,4 +1,4 @@
-% $Id: biblatex.tex,v 1.2a 2011/02/13 12:05:37 lehman stable $
+% $Id: biblatex.tex,v 1.3 2011/03/14 18:25:44 lehman stable $
\documentclass{ltxdockit}[2010/11/19]
\usepackage{btxdockit}
\usepackage[latin9]{inputenc}
@@ -12,7 +12,7 @@
\MakeAutoQuote*{<}{>}
\MakeShortVerb{\|}
-\rcsid{$Id: biblatex.tex,v 1.2a 2011/02/13 12:05:37 lehman stable $}
+\rcsid{$Id: biblatex.tex,v 1.3 2011/03/14 18:25:44 lehman stable $}
\newcommand*{\biber}{Biber\xspace}
\newcommand*{\biblatex}{Biblatex\xspace}
@@ -52,10 +52,47 @@
\setcounter{secnumdepth}{4}
+\makeatletter
+
+\newenvironment{nameparts}
+ {\trivlist\item
+ \tabular{@{}ll@{}}}
+ {\endtabular\endtrivlist}
+
+\newenvironment{namedelims}
+ {\trivlist\item
+ \tabularx{\textwidth}{@{}l@{=}lX@{}}}
+ {\endtabularx\endtrivlist}
+
+\newenvironment{namesample}
+ {\def\delim##1##2{\@delim{##1}{\normalfont\tiny\bfseries##2}}%
+ \def\@delim##1##2{{%
+ \setbox\@tempboxa\hbox{##1}%
+ \@tempdima=\wd\@tempboxa
+ \wd\@tempboxa=\z@
+ \box\@tempboxa
+ \begingroup\spotcolor
+ \setbox\@tempboxa\hb@xt@\@tempdima{\hss##2\hss}%
+ \vrule\lower1.25ex\box\@tempboxa
+ \endgroup}}%
+ \ttfamily\trivlist
+ \setlength\itemsep{0.5\baselineskip}}
+ {\endtrivlist}
+
+\makeatother
+
+\newrobustcmd*{\Deprecated}{%
+ \textcolor{spot}{Deprecated}}
+\newrobustcmd*{\DeprecatedMark}{%
+ \leavevmode\marginpar{\Deprecated}}
\newrobustcmd*{\BiberOnly}{%
\textcolor{spot}{Biber only}}
\newrobustcmd*{\BiberOnlyMark}{%
\leavevmode\marginpar{\BiberOnly}}
+\newrobustcmd*{\BibTeXOnly}{%
+ \textcolor{spot}{BibTeX only}}
+\newrobustcmd*{\BibTeXOnlyMark}{%
+ \leavevmode\marginpar{\BibTeXOnly}}
\hyphenation{%
star-red
@@ -416,7 +453,7 @@ A thesis written for an educational institution to satisfy the requirements for
A work with an author and a title which has not been formally published, such as a manuscript or the script of a talk. Use the fields \bibfield{howpublished} and \bibfield{note} to supply additional information in free format, if applicable.
\reqitem{author, title, year/date}
-\optitem{subtitle, titleaddon, language, howpublished, note, location, date, month, year, addendum, pubstate, url, urldate}
+\optitem{subtitle, titleaddon, language, howpublished, note, location, isbn, date, month, year, addendum, pubstate, url, urldate}
\typeitem{custom[a--f]}
@@ -431,25 +468,15 @@ The entry types listed in this section are provided for backwards compatibility
\begin{typelist}
-\typeitem{conference}
+\typeitem{conference}\DeprecatedMark A \bibtex legacy alias for \bibtype{inproceedings}.
-A \bibtex legacy alias for \bibtype{inproceedings}.
+\typeitem{electronic}\DeprecatedMark An alias for \bibtype{online}.
-\typeitem{electronic}
+\typeitem{mastersthesis}\DeprecatedMark Similar to \bibtype{thesis} except that the \bibfield{type} field is optional and defaults to the localized term <Master's thesis>. You may still use the \bibfield{type} field to override that.
-An alias for \bibtype{online}.
+\typeitem{phdthesis}\DeprecatedMark Similar to \bibtype{thesis} except that the \bibfield{type} field is optional and defaults to the localized term <PhD thesis>. You may still use the \bibfield{type} field to override that.
-\typeitem{mastersthesis}
-
-Similar to \bibtype{thesis} except that the \bibfield{type} field is optional and defaults to the localized term <Master's thesis>. You may still use the \bibfield{type} field to override that.
-
-\typeitem{phdthesis}
-
-Similar to \bibtype{thesis} except that the \bibfield{type} field is optional and defaults to the localized term <PhD thesis>. You may still use the \bibfield{type} field to override that.
-
-\typeitem{techreport}
-
-Similar to \bibtype{report} except that the \bibfield{type} field is optional and defaults to the localized term <technical report>. You may still use the \bibfield{type} field to override that.
+\typeitem{techreport}\DeprecatedMark Similar to \bibtype{report} except that the \bibfield{type} field is optional and defaults to the localized term <technical report>. You may still use the \bibfield{type} field to override that.
\typeitem{www}
@@ -990,7 +1017,7 @@ The gender of the author or the gender of the editor, if there is no author. The
\begin{table}
\tablesetup
-\begin{tabularx}{\columnwidth}{@{}p{100pt}@{}p{100pt}@{}X@{}}
+\begin{tabularx}{\textwidth}{@{}p{100pt}@{}p{100pt}@{}X@{}}
\toprule
\multicolumn{1}{@{}H}{Language} &
\multicolumn{1}{@{}H}{Region/Dialect} &
@@ -1387,7 +1414,7 @@ This entry will be printed as «\emph{Journal Name}. New ser. 9 (1998)». See \sec
\begin{table}
\tablesetup
-\begin{tabularx}{\columnwidth}{@{}>{\ttfamily}llX@{}}
+\begin{tabularx}{\textwidth}{@{}>{\ttfamily}llX@{}}
\toprule
\multicolumn{1}{@{}H}{Date Specification} &
\multicolumn{2}{H}{Formatted Date (Examples)} \\
@@ -1532,7 +1559,7 @@ These warning messages could indeed indicate that the entry \texttt{Jones1995} i
\begin{table}
\tablesetup
-\begin{tabularx}{\columnwidth}{@{}>{\raggedright\ttfamily}X%
+\begin{tabularx}{\textwidth}{@{}>{\raggedright\ttfamily}X%
@{}>{\raggedright\ttfamily}X%
rR{50pt}R{50pt}R{50pt}@{}}
\toprule
@@ -1890,7 +1917,7 @@ This option controls multilingual support. When set to \opt{auto}, \sty{biblatex
\begin{table}
\tablesetup
-\begin{tabularx}{\columnwidth}{@{}p{100pt}@{}p{100pt}@{}>{\ttfamily}X@{}}
+\begin{tabularx}{\textwidth}{@{}p{100pt}@{}p{100pt}@{}>{\ttfamily}X@{}}
\toprule
\multicolumn{1}{@{}H}{Language} &
\multicolumn{1}{@{}H}{Region/Dialect} &
@@ -2252,6 +2279,16 @@ This option controls the page tracker which is required by the \cmd{ifsamepage}
Note that this tracker is disabled in all floats, see \secref{aut:cav:flt}.
+\optitem[false]{citecounter}{\opt{true}, \opt{false}, \opt{context}}
+
+This option controls the citation counter which is required by \cnt{citecounter} from \secref{aut:aux:tst}. The possible choices are:
+
+\begin{valuelist}
+\item[true] Enable the citation counter in global mode.
+\item[false] Disable the citation counter.
+\item[context] Enable the citation counter in context"=sensitive mode. In this mode, citations in footnotes and in the body text are counted independently.
+\end{valuelist}
+
\optitem[false]{citetracker}{\opt{true}, \opt{false}, \opt{context}, \opt{strict}, \opt{constrict}}
This option controls the citation tracker which is required by the \cmd{ifciteseen} and \cmd{ifentryseen} tests from \secref{aut:aux:tst}. The possible choices are:
@@ -2336,7 +2373,7 @@ When enabled, all first and middle names will be rendered as initials. The optio
\boolitem[false]{terseinits}
-This option controls the format of all initials generated by \sty{biblatex}. By default, \sty{biblatex} adds a dot after an initial. If this option is enabled, it uses a terse format without dots and spaces. For example, the initials of Donald Ervin Knuth would be rendered as <D.~E.> by default, and as <DE> if this option is enabled. This terse format is required by some citation schemes.
+This option controls the format of initials generated by \sty{biblatex}. If enabled, initals are rendered using a terse format without dots and spaces. For example, the initials of Donald Ervin Knuth would be rendered as <D.~E.> by default, and as <DE> if this option is enabled. \BiberOnlyMark With Biber, the option works by redefining some macros which control the format of initials. See \secref{use:cav:nam} for details.
\boolitem[false]{labelalpha}
@@ -2448,8 +2485,7 @@ The following legacy option may be used globally in the optional argument to \cm
\begin{optionlist}
-\legitem{openbib}
-This option is provided for backwards compatibility with the standard LaTeX document classes. \opt{openbib} is similar to \kvopt{block}{par}.
+\legitem{openbib}\DeprecatedMark This option is provided for backwards compatibility with the standard LaTeX document classes. \opt{openbib} is similar to \kvopt{block}{par}.
\end{optionlist}
@@ -2663,11 +2699,15 @@ The type of resource. Currently, the only supported type is \texttt{file}.
The data type (format) of the resource. The following formats are currently supported:
-\begin{valuelist}
+\begin{valuelist}[zoterordfxml]
\item[bibtex] \bibtex format.
-\item[ris]\BiberOnlyMark Research Information Systems (\acr{RIS}) format.\fnurl{http://en.wikipedia.org/wiki/RIS_(file_format)} Note that an \texttt{ID} tag is required in all \acr{RIS} records. The \texttt{ID} value corresponds to the entry key. \acr{RIS} support is experimental.
+\item[ris]\BiberOnlyMark Research Information Systems (\acr{RIS}) format.\fnurl{http://en.wikipedia.org/wiki/RIS_(file_format)} Note that an \texttt{ID} tag is required in all \acr{RIS} records. The \texttt{ID} value corresponds to the entry key. Support for this format is experimental.
+
+\item[zoterordfxml]\BiberOnlyMark Zotero \acr{RDF}/\acr{XML} format. Support for this format is experimental. Refer to the Biber manual for details.
+
+\item[endnotexml]\BiberOnlyMark EndNote \acr{XML} format. Support for this format is experimental. Refer to the Biber manual for details.
\end{valuelist}
@@ -2681,7 +2721,7 @@ This command differs from \cmd{addbibresource} in that the \prm{resource} is add
This command differs from \cmd{addbibresource} in that the resource \prm{options} are registered but the \prm{resource} not added to any resource list. This is only required for resources which 1) are given exclusively in the optional argument of \env{refsection} (\ref{use:bib:sec}) and 2) require options different from the default settings. In this case, \cmd{addsectionbib} is employed to qualify the \prm{resource} prior to using it by setting the appropriate \prm{options} in the preamble. The \opt{label} option may be useful to assign a short name to the resource.
-\cmditem{bibliography}{bibfile, \dots}
+\cmditem{bibliography}{bibfile, \dots}|\DeprecatedMark|
The legacy command for adding bibliographic resources, supported for backwards compatibility. Like \cmd{addbibresource}, this command is only available in the preamble and adds resources to the default resource list. Its argument is a comma"=separated list of \file{bib} files. The \file{.bib} extension may be omitted from the filename. Invoking this command multiple times to add more files is permissible. This command is deprecated. Please consider using \cmd{addbibresource} instead.
@@ -3061,18 +3101,6 @@ The \prm{key} is the entry key of the set, which is used like any other entry ke
\end{ltxsyntax}
-\subsubsection{Legacy Commands}
-
-In standard \latex, the following command selects the \file{bst} file to be used by \bibtex.
-
-\begin{ltxsyntax}
-
-\cmditem{bibliographystyle}{bstfile}
-
-Since \sty{biblatex} interfaces with \bibtex in a different way, this command will issue a warning and do nothing.
-
-\end{ltxsyntax}
-
\subsection{Citation Commands}
\label{use:cit}
@@ -3122,6 +3150,11 @@ The following additional citation commands are only provided by some of the cita
These citation commands are provided by all non-verbose styles which ship with this package. They are intended for use in the flow of text, replacing the subject of a sentence. They print the authors or editors followed by a citation label which is enclosed in parentheses. Depending on the citation style, the label may be a number, the year of publication, an abridged version of the title, or something else. The numeric and alphabetic styles use square brackets instead of parentheses. \cmd{Textcite} is similar to \cmd{textcite} but capitalizes the name prefix of the first name in the citation if the \opt{useprefix} option is enabled, provided that there is a name prefix.
+\cmditem{smartcite}[prenote][postnote]{key}
+\cmditem{Smartcite}[prenote][postnote]{key}
+
+Like \cmd{parencite} in a footnote and like \cmd{footcite} in the body.
+
\cmditem{cite*}[prenote][postnote]{key}
This command is provided by all author-year and author-title styles. It is similar to the regular \cmd{cite} command but merely prints the year or the title, respectively.
@@ -3185,6 +3218,11 @@ The multicite version of \cmd{parencite} and \cmd{Parencite}, respectively.
The multicite version of \cmd{footcite} and \cmd{footcitetext}, respectively.
+\cmditem{smartcites}(pre)(post)[pre][post]{key}|...|[pre][post]{key}
+\cmditem{Smartcites}(pre)(post)[pre][post]{key}|...|[pre][post]{key}
+
+The multicite version of \cmd{smartcite} and \cmd{Smartcite}, respectively.
+
\cmditem{textcites}(pre)(post)[pre][post]{key}|...|[pre][post]{key}
\cmditem{Textcites}(pre)(post)[pre][post]{key}|...|[pre][post]{key}
@@ -3295,6 +3333,11 @@ Similar to \cmd{volcite} but based on \cmd{parencite}.
Similar to \cmd{volcite} but based on \cmd{footcite} and \cmd{footcitetext}, respectively.
+\cmditem{svolcite}[prenote]{volume}[page]{key}
+\cmditem{Svolcite}[prenote]{volume}[page]{key}
+
+Similar to \cmd{volcite} but based on \cmd{smartcite}.
+
\cmditem{tvolcite}[prenote]{volume}[page]{key}
\cmditem{Tvolcite}[prenote]{volume}[page]{key}
@@ -3568,6 +3611,27 @@ The separator inserted between <units> in the sense explained in \secref{aut:pct
The punctuation printed at the very end of every bibliography entry, usually a period. The default definition is a period.
+\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
+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}
+This delimiter controls the spacing between name parts. It is inserted between the name prefix and the last name if \kvopt{useprefix}{true}. 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{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{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
+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
+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{bibnamedash}
The dash to be used as a replacement for recurrent authors or editors in the bibliography. The default is an <em> or an <en> dash, depending on the indentation of the list of references.
@@ -3786,11 +3850,11 @@ This counter, which is used by the localization modules, holds the penalty used
\cntitem{highnamepenalty}
-This counter holds a penalty which affects the line"=breaking of names. This penalty is inserted between smaller chunks of a name, for example between the first and the middle name. This counter is initialized to \cmd{hyphenpenalty} at load-time. If you dislike such linebreaks, use a higher value. If you do not mind them at all, set this counter to zero. If you prefer the traditional \bibtex behavior (no linebreaks at \cnt{highnamepenalty} breakpoints), set it to <infinite> (10\,000 or higher).\footnote{By default, \bibtex inserts the special character \texttt{\textasciitilde} (a non-breakable space) between certain parts of a name. This can lead to overfull boxes in the bibliography or in citations. While discouraging linebreaks at certain places is a good idea, using unbreakable spaces seems disproportionate given that \tex offers much more flexible facilities for controlling linebreaks. Therefore, \sty{biblatex} redefines the active character \texttt{\textasciitilde} locally such that it inserts a space penalized by the value of the \cnt{highnamepenalty} counter. This redefinition is local to name lists and will not affect any other part of the document. Note that it will also affect explicitly inserted non-breakable spaces in name lists. If an explicit \texttt{\textasciitilde} in a name does not have the expected effect, you may need to set this counter to 10\,000.}
+This counter holds a penalty affecting line"=breaking in names. Please refer to \secref{use:cav:nam,use:fmt:fmt} for explanation. The counter is initialized to \cmd{hyphenpenalty} at load-time. Use a higher value if you dislike the respective linebreaks. If you do not mind them at all, set this counter to zero. If you prefer the traditional \bibtex behavior (no linebreaks at \cnt{highnamepenalty} breakpoints), set it to <infinite> (10\,000 or higher).
\cntitem{lownamepenalty}
-This counter holds a penalty which affects the line"=breaking of names. This penalty is inserted between larger chunks of a name, for example between the chunk consisting of all first names and the last name. This counter is initialized to half the \cmd{hyphenpenalty} at load-time. If you dislike such linebreaks, use a higher value. If you do not mind them at all, set this counter to zero.
+Similar to \cnt{highnamepenalty}. Please refer to \secref{use:cav:nam,use:fmt:fmt} for explanation. The counter is initialized to half the \cmd{hyphenpenalty} at load-time. Use a higher value if you dislike the respective linebreaks. If you do not mind them at all, set this counter to zero.
\end{ltxsyntax}
@@ -4439,6 +4503,65 @@ It is possible to suppress the prefix on a per"=entry basis by setting the \bibf
%
The \prm{postnote} argument is handled as a field and the formatting of this field is controlled by a field formatting directive which may be freely redefined. The above definition will simply print the postnote as is. See \secref{aut:cbx:fld, aut:bib:fmt} in the author guide for further details.
+\subsubsection{Name Parts and Name Spacing}
+\label{use:cav:nam}
+
+The \sty{biblatex} package gives users and style authors very fine"=grained control of name spacing and the line"=breaking behavior of names, especially when they are using Biber as backend. The commands discussed in the following are documented in \secref{use:fmt:fmt,aut:fmt:fmt}. This section is meant to give an overview of how they are put together. A note on terminology: a name \emph{part} is a basic part of the name, for example the first or the last name. Each part of a name may be a single name or it may be composed of multiple names. For example, the name part \enquote*{first name} may be composed of a first and a middle name. The latter are referred to as name \emph{elements} in this section. Let's consider a simple name first: \enquote{John Edward Doe}. This name is composed of the following parts:
+
+\begin{nameparts}
+First & John Edward \\
+Prefix & --- \\
+Last & Doe \\
+Suffix & --- \\
+\end{nameparts}
+%
+The spacing and the line"=breaking behavior of names is controlled by four macros:
+
+\begin{namedelims}
+a & \cmd{bibnamedelima} & Inserted by the backend after the first element of every name part if that element is less than three characters long and before the last element of every name part. \\
+b & \cmd{bibnamedelimb} & Inserted by the backend between all elements of a name part where \cmd{bibnamedelima} does not apply. \\
+c & \cmd{bibnamedelimc} & Inserted by a formatting directive between the name prefix and the last name if \kvopt{useprefix}{true}. If \kvopt{useprefix}{true}, \cmd{bibnamedelimd} is used instead. \\
+d & \cmd{bibnamedelimd} & Inserted by a formatting directive between name parts where \cmd{bibnamedelimc} does not apply. \\
+\end{namedelims}
+%
+This is how the delimiters are employed:
+
+\begin{namesample}
+\item John\delim{~}{a}Edward\delim{ }{d}Doe
+\end{namesample}
+%
+Let's consider a more complex name: \enquote{Charles-Jean Étienne Gustave Nicolas de La Vallée Poussin}. This name is composed of the following parts:
+
+\begin{nameparts}
+First & Charles-Jean Étienne Gustave Nicolas \\
+Prefix & de \\
+Last & La Vallée Poussin \\
+Suffix & --- \\
+\end{nameparts}
+%
+The delimiters:
+
+\begin{namesample}
+\item Charles-Jean\delim{~}{b}Étienne\delim{~}{b}Gustave\delim{~}{a}Nicolas\delim{ }{d}%
+ de\delim{ }{c}%
+ La\delim{~}{a}Vallée\delim{~}{a}Poussin
+\end{namesample}
+%
+Note that \cmd{bibnamedelima/b} are inserted by the backend. The backend processes the name parts and takes care of the delimiters between the elements that make up a name part, processing each part individually. In contrast to that, the delimiters between the parts of the complete name (\cmd{bibnamedelimc/d}) are added by name formatting directives at a later point in the processing chain. The spacing and punctuation of initals is also handled by the backend and may be customized by redefining the following three macros:
+
+\begin{namedelims}
+a & \cmd{bibinitperiod} & Inserted by the backend after initials.\\
+b & \cmd{bibinitdelim} & Inserted by the backend between multiple initials.\\
+c & \cmd{bibinithyphendelim} & Inserted by the backend between the initials of hyphenated name parts, replacing \cmd{bibinitperiod} and \cmd{bibinitdelim}.\\
+\end{namedelims}
+%
+This is how they are employed:
+
+\begin{namesample}
+\item J\delim{.}{a}\delim{~}{b}E\delim{.}{a} Doe
+\item K\delim{.-}{c}H\delim{.}{a} Mustermann
+\end{namesample}
+
\subsubsection{Bibliography Filters and Citation Labels}
\label{use:cav:lab}
@@ -4900,7 +5023,7 @@ will tell you if the corresponding date is defined and an open"=ended range. Ope
\begin{table}
\tablesetup
-\begin{tabularx}{\columnwidth}{@{}>{\ttfamily}lX>{\ttfamily}lX@{}}
+\begin{tabularx}{\textwidth}{@{}>{\ttfamily}lX>{\ttfamily}lX@{}}
\toprule
\multicolumn{2}{@{}H}{\file{bib} File} &
\multicolumn{2}{H}{Data Interface} \\
@@ -5099,12 +5222,13 @@ This command defines <multicite> commands (\secref{use:cit:mlt}). The \prm{comma
\cmditem{DeclareAutoCiteCommand}{name}[position]{cite}{multicite}
-This command provides definitions for the \cmd{autocite} and \cmd{autocites} commands from \secref{use:cit:aut}. The definitions are enabled with the \opt{autocite} package option from \secref{use:opt:pre:gen}. The \prm{name} is an identifier which serves as the value passed to the package option. The autocite commands are built on top of backend commands like \cmd{parencite} and \cmd{parencites}. The arguments \prm{cite} and \prm{multicite} specify the backend commands to use. The \prm{cite} argument refers to \cmd{autocite} and \prm{multicite} refers to \cmd{autocites}. The \prm{position} argument controls the handling of any punctuation marks after the citation. Possible values are <\texttt{l}> and <\texttt{r}>. <\texttt{r}> means that the punctuation is placed to the right of the citation, \ie it will not be moved around. <\texttt{l}> means that any punctuation after the citation is moved to the left of the citation. This is useful with citations in footnotes since it will place the footnote mark after the terminal punctuation. This argument is optional and defaults to \texttt{r}. See also \cmd{DeclareAutoPunctuation} in \secref{aut:pct:cfg} and the \opt{autopunct} package option in \secref{use:opt:pre:gen}. The following examples are real definitions taken from \path{biblatex.def}:
+This command provides definitions for the \cmd{autocite} and \cmd{autocites} commands from \secref{use:cit:aut}. The definitions are enabled with the \opt{autocite} package option from \secref{use:opt:pre:gen}. The \prm{name} is an identifier which serves as the value passed to the package option. The autocite commands are built on top of backend commands like \cmd{parencite} and \cmd{parencites}. The arguments \prm{cite} and \prm{multicite} specify the backend commands to use. The \prm{cite} argument refers to \cmd{autocite} and \prm{multicite} refers to \cmd{autocites}. The \prm{position} argument controls the handling of any punctuation marks after the citation. Possible values are \texttt{l}, \texttt{r}, \texttt{f}. \texttt{r} means that the punctuation is placed to the right of the citation, \ie it will not be moved around. \texttt{l} means that any punctuation after the citation is moved to the left of the citation. \texttt{f} is like \texttt{r} in a footnote and like \texttt{l} otherwise. This argument is optional and defaults to \texttt{r}. See also \cmd{DeclareAutoPunctuation} in \secref{aut:pct:cfg} and the \opt{autopunct} package option in \secref{use:opt:pre:gen}. The following examples are real definitions taken from \path{biblatex.def}:
\begin{lstlisting}[style=latex]{}
\DeclareAutoCiteCommand{plain}{\cite}{\cites}
\DeclareAutoCiteCommand{inline}{\parencite}{\parencites}
\DeclareAutoCiteCommand{footnote}[l]{\footcite}{\footcites}
+\DeclareAutoCiteCommand{footnote}[f]{\smartcite}{\smartcites}
\end{lstlisting}
\end{ltxsyntax}
@@ -5255,7 +5379,7 @@ Note that name affixes are referred to as the <junior part> of the name in the \
\item[\#8] The name affixes, given as initials.
\end{argumentlist}
%
-If a certain part of a name is not available, the corresponding argument will be empty, hence you may use \cmd{ifblank} tests to check for the inidividual parts of a name. The name of the name list currently being processed is available to the \prm{code} as \cmd{currentname}. All initials are sensitive to the \opt{terseinits} package option, see \secref{use:opt:pre:gen} for details. Note that the formatting directive also handles the punctuation to be inserted between separate names and between the individual parts of a name. You need to check whether you are in the middle of or at the end of the list, \ie whether \cnt{listcount} is smaller than or equal to \cnt{liststop}. The starred variant of this command is similar to the regular version, except that all type-specific formats are cleared.
+If a certain part of a name is not available, the corresponding argument will be empty, hence you may use \cmd{ifblank} tests to check for the inidividual parts of a name. The name of the name list currently being processed is available to the \prm{code} as \cmd{currentname}. Note that the formatting directive also handles the punctuation to be inserted between separate names and between the individual parts of a name. You need to check whether you are in the middle of or at the end of the list, \ie whether \cnt{listcount} is smaller than or equal to \cnt{liststop}. See also \secref{use:cav:nam}. The starred variant of this command is similar to the regular version, except that all type-specific formats are cleared.
\cmditem{DeclareIndexFieldFormat}[entrytype, \dots]{format}{code}
\cmditem*{DeclareIndexFieldFormat}*{format}{code}
@@ -5921,9 +6045,13 @@ Expands to \prm{true} or \prm{false} depending on the \opt{indexing} option from
Expands to \prm{true} when located in a footnote, and to \prm{false} otherwise. Note that footnotes in \env{minipage} environments are considered to be part of the body text. This command will only expand to \prm{true} in footnotes a the bottom of the page and in endnotes as provided by the \sty{endnotes} package.
+\cntitem{citecounter}
+
+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}
-The \cnt{uniquename} counter refers to the \bibfield{labelname} list. Its value is \texttt{0} if the author's or editor's last name is unique, \texttt{1} if adding the other parts of the name (first name, prefix, suffix) as initials will make it unique, and \texttt{2} if the full name is required to form a unique citation. 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} for all works by these authors. If there is one <John Doe> and one <Jane Doe>, the value of the counter will be \texttt{2}. Note that this feature needs to be enabled explicitly with the package option \opt{uniquename}. If the option is disabled, the value of the counter is always zero. If the option is set to \texttt{init}, the counter will be limited to \texttt{1}. This is useful for citations styles which use initials to disambiguate names but never print the full name in citations. Also note that this feature only works with single names. If the \bibfield{labelname} list holds multiple names, the value of the counter is always zero.
+This counter refers to the \bibfield{labelname} list. Its value is \texttt{0} if the author's or editor's last name is unique, \texttt{1} if adding the other parts of the name (first name, prefix, suffix) as initials will make it unique, and \texttt{2} if the full name is required to form a unique citation. 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} for all works by these authors. If there is one <John Doe> and one <Jane Doe>, the value of the counter will be \texttt{2}. Note that this feature needs to be enabled explicitly with the package option \opt{uniquename}. If the option is set to \texttt{init}, the counter will be limited to \texttt{1}. This is useful for citations styles which use initials to disambiguate names but never print the full name in citations. Also note that this feature only works with single names. If the \bibfield{labelname} list holds multiple names, the value of the counter is always zero.
\cntitem{parenlevel}
@@ -7127,6 +7255,27 @@ This section corresponds to \secref{use:fmt:fmt} in the user part of the manual.
\begin{ltxsyntax}
+\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
+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}
+This delimiter controls the spacing between name parts. The default name formats use it between the name prefix and the last name if \kvopt{useprefix}{true}. 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{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{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
+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
+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{bibnamedash}
The dash to be used as a replacement for recurrent authors or editors in the bibliography. The default is an <em> or an <en> dash, depending on the indentation of the list of references.
@@ -7963,7 +8112,7 @@ Note that \cmd{DeclareLanguageMapping} is not intended to handle language varian
\subsubsection{Grouping}
\label{aut:cav:grp}
-In a citation or bibliography style, you may need to set flags or store certain values for later use. In this case, it is crucial to understand the basic grouping structure imposed by this package. As a rule of thumb, you are working in a large group whenever author commands such a those discussed in \secref{aut:aux} are available because the author interface of this package is only enabled locally. If any bibliographic data is available, there is at least one additional group. Here are some general rules:
+In a citation or bibliography style, you may need to set flags or store certain values for later use. In this case, it is crucial to understand the basic grouping structure imposed by this package. As a rule of thumb, you are working in a large group whenever author commands such as those discussed in \secref{aut:aux} are available because the author interface of this package is only enabled locally. If any bibliographic data is available, there is at least one additional group. Here are some general rules:
\begin{itemize}
@@ -8220,6 +8369,29 @@ This revision history is a list of changes relevant to users of this package. Ch
\begin{changelog}
+\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}