summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-01-09 00:25:14 +0000
committerKarl Berry <karl@freefriends.org>2011-01-09 00:25:14 +0000
commit413763759a59c3a7b0cb538255d478ed95d0efe9 (patch)
tree21c5a92b16466881e9b086d6fc031df8fd67926f /Master/texmf-dist/doc
parent8df96d2bbfa496668439a51b245f01342fadbd8c (diff)
biblatex 1.1a (8jan11)
git-svn-id: svn://tug.org/texlive/trunk@20983 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/README2
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/RELEASE2
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.pdfbin763312 -> 766615 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex/biblatex.tex35
4 files changed, 25 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex/README b/Master/texmf-dist/doc/latex/biblatex/README
index b5e35ee93d5..e15ab1fff6a 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.1 2011/01/05 21:45:11 lehman stable $
+$Id: README,v 1.1a 2011/01/08 13:30:00 lehman stable $
ABOUT
diff --git a/Master/texmf-dist/doc/latex/biblatex/RELEASE b/Master/texmf-dist/doc/latex/biblatex/RELEASE
index b7ecb9f5278..f7544b077da 100644
--- a/Master/texmf-dist/doc/latex/biblatex/RELEASE
+++ b/Master/texmf-dist/doc/latex/biblatex/RELEASE
@@ -1,4 +1,4 @@
-$Id: RELEASE,v 1.1 2011/01/05 21:45:11 lehman stable $
+$Id: RELEASE,v 1.1a 2011/01/08 13:30:00 lehman stable $
RELEASE NOTES FOR VERSION 1.1
diff --git a/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf b/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf
index 296290d5815..7cdec4879a0 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 10a79c4ca37..1716985cf0b 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.1 2011/01/05 21:45:11 lehman stable $
+% $Id: biblatex.tex,v 1.1a 2011/01/08 13:30:00 lehman stable $
\documentclass{ltxdockit}[2010/11/19]
\usepackage{btxdockit}
\usepackage[latin9]{inputenc}
@@ -11,7 +11,7 @@
\MakeAutoQuote*{<}{>}
\MakeShortVerb{\|}
-\rcsid{$Id: biblatex.tex,v 1.1 2011/01/05 21:45:11 lehman stable $}
+\rcsid{$Id: biblatex.tex,v 1.1a 2011/01/08 13:30:00 lehman stable $}
\newcommand*{\BiblatexHome}{http://sourceforge.net/projects/biblatex/}
\newcommand*{\BiblatexOnCTAN}{http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/}
@@ -451,6 +451,10 @@ Works of the visual arts such as paintings, sculpture, and installations. This t
Audio recordings, typically on audio \acr{CD}, \acr{DVD}, audio casette, or similar media. This type is currently ignored by the standard styles. See also \bibtype{music}.
+\typeitem{bibnote}
+
+This special entry type is not meant to be used in the \file{bib} file like other types. It is provided for third-party packages like \sty{notes2bib} which merge notes into the bibliography. The notes should go into the \bibfield{note} field. By advised that the \bibtype{bibnote} type is not related to the \cmd{defbibnote} command in any way. \cmd{defbibnote} is for adding comments at the beginning or the end of the bibliography, whereas the \bibtype{bibnote} type is meant for packages which render endnotes as bibliography entries.
+
\typeitem{commentary}
Commentaries which have a status different from regular books, such as legal commentaries. This type is currently ignored by the standard styles.
@@ -2644,9 +2648,10 @@ ydnt &\bibfield{presort}&\new&\bibfield{sortyear} (desc.)
\begin{ltxsyntax}
-\cmditem{bibliography}{bib files}
+\cmditem{bibliography}{bibfile,...}
+\cmditem*{bibliography*}{bibfile,...}
-This command is used in the document preamble to specify a single \file{bib} file or a comma"=separated list of \file{bib} files. It does not print anything.
+This command specifies the database files. It is only available in the preamble. Its argument is a comma"=separated list of files. Note that the \file{.bib} suffix is omitted from the filename. Invoking this command multiple times to add more files is permissible. The starred version differs from the regular variant in that the files will be treated as global resources. This difference is only relevant if there are any reference sections in the document and the optional argument of \env{refsection} or \cmd{newrefsection} is used to specify alternative sources (see \ref{use:bib:sec}). In this case, the starred version will ensure that the files are added to the file list of all reference sections. In most cases, only the regular version will be used.
\cmditem{printbibliography}[key=value, \dots]
@@ -2758,11 +2763,11 @@ 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 \texttt{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}, \opt{maxnames}, \opt{minnames}, \opt{maxitems}, \opt{minitems}.
+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}, \opt{maxnames}, \opt{minnames}, \opt{maxitems}, \opt{minitems}.
\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 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 \texttt{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}, \opt{maxnames}, \opt{minnames}, \opt{maxitems}, \opt{minitems}, and \opt{section}.
+This command automatically loops over all reference segments. This is equivalent to giving one \cmd{printbibliography} command for every segment 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}, \opt{maxnames}, \opt{minnames}, \opt{maxitems}, \opt{minitems}, and \opt{section}.
\cmditem{bibbycategory}[key=value, \dots]
@@ -2794,13 +2799,13 @@ The \env{refsection} environment is used in the document body to mark a referenc
\begin{ltxsyntax}
-\envitem{refsection}[bib files]
+\envitem{refsection}[bibfile,...]
-Within a reference section all cited works are assigned labels which are local to the environment. \env{refsection} environments may not be nested, but you may use \env{refsegment} environments within a \env{refsection} to subdivide it into segments. Use the \opt{section} option of \cmd{printbibliography} to select a section when printing the bibliography and the corresponding option of \cmd{printshorthands} when printing the list of shorthands. Bibliography sections are numbered starting at~\texttt{1} and the number of the current section will be written to the transcript file. All citations given outside a \env{refsection} environment are assigned to section~\texttt{0}. If \cmd{printbibliography} is used within a \env{refsection}, it will automatically select the current section. The \opt{refsection} option is not required in this case. This also applies to \cmd{printshorthands}. If the optional argument \prm{bib files} is omitted, \sty{biblatex} uses the global list of \file{bib} files, as specified with \cmd{bibliography} in the preamble. Technically, reference sections are completely independent from document divisions such as \cmd{chapter} and \cmd{section} even though they will most likely be used per chapter or section. See the \opt{refsection} package option in \secref{use:opt:pre:gen} for a way to automate this. Also see \secref{use:use:mlt} for usage examples.
+Within a reference section, all cited works are assigned labels which are local to the environment. Reference sections may have their own \file{bib} files, use the optional argument to specify them. If the argument is omitted, the reference section will use the default list of \file{bib} files, as specified with \cmd{bibliography} in the preamble. If the argument is available, the default list will be ignored. Any global \file{bib} files specified with \cmd{bibliography*} are appended to the list in any case. \env{refsection} environments may not be nested, but you may use \env{refsegment} environments within a \env{refsection} to subdivide it into segments. Use the \opt{section} option of \cmd{printbibliography} to select a section when printing the bibliography, and the corresponding option of \cmd{printshorthands} when printing the list of shorthands. Bibliography sections are numbered starting at~\texttt{1}. The number of the current section is also written to the transcript file. All citations given outside a \env{refsection} environment are assigned to section~0. If \cmd{printbibliography} is used within a \env{refsection}, it will automatically select the current section. The \opt{section} option is not required in this case. This also applies to \cmd{printshorthands}. Technically, reference sections are completely independent from document divisions such as \cmd{chapter} and \cmd{section} even though they will most likely be used per chapter or section. See the \opt{refsection} package option in \secref{use:opt:pre:gen} for a way to automate this. Also see \secref{use:use:mlt} for usage examples.
-\cmditem{newrefsection}[bib files]
+\cmditem{newrefsection}[bibfile,...]
-This command is similar to the \env{refsection} environment except that it is a stand"=alone command rather than an environment. It automatically ends the previous reference section (if any) and immediately starts a new one. Note that the reference section started by the last \cmd{newrefsection} command will extend to the end of the document. Use \cmd{endrefsection} if you want to terminate it earlier. Also see the \opt{refsection} package option in \secref{use:opt:pre:gen}.
+This command is similar to the \env{refsection} environment except that it is a stand"=alone command rather than an environment. It automatically ends the previous reference section (if any) and immediately starts a new one. Note that the reference section started by the last \cmd{newrefsection} command in the document will extend to the very end of the document. Use \cmd{endrefsection} if you want to terminate it earlier. Also see the \opt{refsection} package option in \secref{use:opt:pre:gen}.
\end{ltxsyntax}
@@ -2813,7 +2818,7 @@ The \env{refsegment} environment is used in the document body to mark a referenc
\envitem{refsegment}
-The difference between a \env{refsection} and a \env{refsegment} environment is that the former creates labels which are local to the environment whereas the latter provides a target for the \opt{segment} filter of \cmd{printbibliography} without affecting the labels. They will be unique across the entire document. \env{refsegment} environments may not be nested, but you may use them in conjunction with \env{refsection} to subdivide a reference section into segments. In this case, the segments are local to the enclosing \env{refsection} environment. Use the \env{refsegment} option of \cmd{printbibliography} to select a segment when printing the bibliography. The reference segments are numbered starting at~\texttt{1} and the number of the current segment will be written to the transcript file. All citations given outside a \env{refsegment} environment are assigned to segment~\texttt{0}. In contrast to the \env{refsection} environment, the current segment is not selected automatically if \cmd{printbibliography} is used within a \env{refsegment} environment. Technically, reference segments are completely independent from document divisions such as \cmd{chapter} and \cmd{section} even though they will typically be used per chapter or section. See the \opt{refsegment} package option in \secref{use:opt:pre:gen} for a way to automate this. Also see \secref{use:use:mlt} for usage examples.
+The difference between a \env{refsection} and a \env{refsegment} environment is that the former creates labels which are local to the environment whereas the latter provides a target for the \opt{segment} filter of \cmd{printbibliography} without affecting the labels. They will be unique across the entire document. \env{refsegment} environments may not be nested, but you may use them in conjunction with \env{refsection} to subdivide a reference section into segments. In this case, the segments are local to the enclosing \env{refsection} environment. Use the \env{refsegment} option of \cmd{printbibliography} to select a segment when printing the bibliography. The reference segments are numbered starting at~\texttt{1} and the number of the current segment will be written to the transcript file. All citations given outside a \env{refsegment} environment are assigned to segment~0. In contrast to the \env{refsection} environment, the current segment is not selected automatically if \cmd{printbibliography} is used within a \env{refsegment} environment. Technically, reference segments are completely independent from document divisions such as \cmd{chapter} and \cmd{section} even though they will typically be used per chapter or section. See the \opt{refsegment} package option in \secref{use:opt:pre:gen} for a way to automate this. Also see \secref{use:use:mlt} for usage examples.
\csitem{newrefsegment}
@@ -4184,7 +4189,7 @@ When using \bibtex, which has no native support for entry sets, setting up entry
}
\end{lstlisting}
%
-Note that citing any set member will automatically load the entire set with \bibtex. If you want to refer to an item as part of a set in one document\slash refsection and as a stand-alone reference in another one, you need two distinct entries with.
+Note that citing any set member will automatically load the entire set with \bibtex. If you want to refer to an item as part of a set in one document\slash refsection and as a stand-alone reference in another one, you need two distinct entries with \bibtex.
\paragraph[Dynamic entry sets]{Dynamic entry sets\BiberOnlyMark}
@@ -7890,6 +7895,12 @@ This revision history is a list of changes relevant to users of this package. Ch
\begin{changelog}
+\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:sec}
+\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}