citeall (3dec17)

git-svn-id: svn://tug.org/texlive/trunk@45975 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 14 insertions, 5 deletions

diff --git a/Master/texmf-dist/doc/latex/citeall/citeall.tex b/Master/texmf-dist/doc/latex/citeall/citeall.tex
index 310cd6855e3..115112a3e3e 100644
--- a/Master/texmf-dist/doc/latex/citeall/citeall.tex
+++ b/Master/texmf-dist/doc/latex/citeall/citeall.tex
@@ -1,5 +1,5 @@
 % !Mode:: "TeX:DE:UTF-8:Main"
-% $UFDate: 2015-04-28 13:27:07 +0200 -- Commit: f04431e -- master$
+% $UFDate: 2017-12-03 18:19:20 +0100 -- Commit: 4f26014 (HEAD, master) -- master$
 \documentclass[DIV=12]{scrartcl}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
@@ -19,18 +19,22 @@
   \divide\parsep by 2\relax}
 \makeatother
 \addbibresource{examples-citeall.bib}
-\title{The \pkg{citeall} package, v1.2}
+\title{The \pkg{citeall} package, v1.4}
 \author{Ulrike Fischer\thanks{fischer@troubleshooting-tex.de}}
 
 \begin{document}
 \maketitle
 \section{Changes}
+Version 1.4 changed the code to adapt the package to the newest biblatex 3.9.
+
+
+Version 1.3 added code to handle the @preamble field in a bib. Changed the definition of \verb+\sortlist+ to adapt to the newest biblatex.
 
 Version 1.2 adapts the package to biblatex 3.0 and correct some small bugs (e.g. unwanted spaces).
 \section{Important}
-\pkg{citeall} works only together with \pkg{biblatex}.  \pkg{biblatex} should be loaded before \pkg{citeall}.
+\pkg{citeall} works only together with (newer versions of) \pkg{biblatex}.  \pkg{biblatex} should be loaded before \pkg{citeall}.
 
-The package relies on some inner working of \pkg{biblatex}, so it could break with future versions.
+The package relies on some inner working of \pkg{biblatex}, so it could break with future or older versions (I tested with version 3.9).
 
 \section{The aim of the package}
 The \pkg{citeall} package is a package to help to adapt and debug \pkg{biblatex}
@@ -56,7 +60,7 @@ For each entrykey in the .bbl \cs{citeall} will loop through this list and pass
 \item If there are brackets e.g. from optional argument of a \cs{cite} you should protect them with braces.
 \item If there are commas you should protect them with braces.
 \item If you want to insert a paragraph break, use \cs{endgraf}
-\item Don't overdo the system. It is meant for simple debbugging not for complicated citation printouts.
+\item Don't overdo the system. It is meant for simple debugging not for complicated citation printouts.
 \end{itemize}
 
 \section{Some examples}
@@ -107,4 +111,9 @@ For each entrykey in the .bbl \cs{citeall} will loop through this list and pass
 By default the item of an entry are separated by a comma and a space. This can be changed by redefining \cs{citeallseparator}. The last item is finished by \cs{citeallfinentry} (default nothing). The entries are separated by a \cs{par}, this can be changed by redefining \cs{citeallgroupseparator}.
 The default cite command used by \cs{citeall} is (\cs{cite}). This can be changed by redefining \cs{citealldefaultcite}.
 
+\DescribeMacro\citeallpreambledefinition
+
+.bib files can contain a special entry type \texttt{@preamble} which can contain definitions that should be executed at the begin of the bibliography, e.g. to ensure that some commands are defined. Such a field lead to a command \verb+\preamble{...}+ in the .bbl. When \cs{citeall} reads the .bbl it redefines \cs{preamble} to do nothing. You can change this behaviour by redefining this macro. It should always have one argument!
+
+
 \end{document}