biblatex-apa (26jan12)

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

5 files changed, 40 insertions, 12 deletions

diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/README b/Master/texmf-dist/doc/latex/biblatex-apa/README
index acd4d0fecc5..cc7bea63f2b 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/README
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/README
@@ -1,4 +1,4 @@
-Version 4.3
+Version 4.4
 
 Permission is granted to copy, distribute and/or modify this software under
 the terms of the LaTeX Project Public License, version
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf
index e7400b0b65c..c33fe1068da 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex
index b46be700160..861260936a7 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex
@@ -119,7 +119,9 @@ it will only truncate two or more names. If it would truncate just one
 name, we just give the name:\\
 \apaex{\textcite{6.12c}}\\
 \apaex{\textcite{6.12d}}\\
-\apaex{\textcite{6.12c}}\\
+\apaex{\textcite{6.12c}}\footnote{This example is incorrect in the
+  APA manual because «et al» is replacing only one name. This has been
+  verified with the APA and will be corrected in future editions.}\\
 \apaex{\textcite{6.12d}}
 
 \noindent Multiple-authors in running text are separated by «and».
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf
index bd6a588859f..8766f52f150 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
index 3709d7bee45..7832e1dbb24 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
@@ -25,7 +25,7 @@
   url={http://www.ctan.org/tex-archive/macros/latex/exptl/biblatex-contrib/biblatex-apa/},
   author={Philip Kime},
   email={Philip@kime.org.uk},
-  revision={4.3},
+  revision={4.4},
   date={\today}}
 
 \hypersetup{%
@@ -45,6 +45,10 @@ Please see the revision history below (section \ref{rev}) for  details on change
 version. This section is just for important things like incompatible
 changes which users should be aware of.
 
+\minisec{4.4}
+The |\maxprtauth| command is now a package option called
+«apamaxprtauth», see section \ref{opts}.
+
 \minisec{4.3}
 Specifying entries as «in press» should now be done using the official |biblatex|
 mechanism for this. Instead of, for example:
@@ -165,6 +169,30 @@ APA-style sentence case in the References section. Unlike the References
 section, titles in citations in the APA style appear in normal case and the
 style will ensure this too.
 
+\subsection{Package options}\label{opts}
+
+The following options are set as usual in the options passed to
+|biblatex|.
+
+\begin{ltxcode}
+apabackref=true|false
+\end{ltxcode}% | stupid comment to stop emacs highlighting as verb due
+             % to single pipe
+
+\noindent It is not APA style to include backreferences in the References to
+pages where citations of the entry occur. However, this is very
+useful, especially in proofing and so if you set the |apabackref|
+option to «true», these are enabled. The default is «false».
+
+\begin{ltxcode}
+apamaxprtauth=<num>
+\end{ltxcode}
+
+\noindent This option controls the number of author/editor names which are
+printed in the References. APA style defaults to 7. You can change this if
+you really want to fully print all author list references in certain
+contexts (for example in a CV where you are an author in position 8 \ldots)
+
 \subsection{Localisation}
 
 Localisation is provided for APA-specific strings in the accompanying
@@ -313,12 +341,6 @@ general notes:
   citations and the references will be the localisation of the |PUBSTATE|
   value key (|PUBSTATE| takes a pre-defined set of localisation keys as
   values, see |biblatex| manual).
-\item The |\maxprtauth| commands returns the number of author/editor
-  names which are printed. APA style defaults to 7. You can reset this
-  after loading biblatex with, for example,
-  |\renewcommand{\maxprtauth}{25}| if you really want to fully print
-  all author list references in certain contexts (for example in a CV
-  where you are an author in position 8 \ldots)
 \item There are occasions where there is no sensible \path{.bib} key to
   use. This applies to things like |AUDIO| and |VIDEO| entries mainly. The
   format of these requires that different roles (Director, Producer etc.)
@@ -348,11 +370,15 @@ general notes:
 
 \begin{changelog}
 
-\begin{release}{4.3}{2012-01-21}
+\begin{release}{4.4}{2012-01-25}
+\item |\maxprtauth| command is now a package option «apamaxprtauth»
+\item New package option «apabackref» controlling whether
+  backreferences and links to citations appear in the References.
+\end{release}
+
+\begin{release}{4.3}{2012-01-22}
 \item «et al» now only replaces two or more names since it's plural
 \item «in press» items now should use the |biblatex| |PUBSTATE| field
-  (Requires |biber| $\geq$ 0.9.9 to fully support disambiguation of «in
-  press» items by the same author)
 \item Fixed «in press» hyphenation issue for disambiguation in references
 \item URLs are now by default in roman font as per APA style.
 \end{release}