summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-04-01 22:31:32 +0000
committerKarl Berry <karl@freefriends.org>2011-04-01 22:31:32 +0000
commite849d55f9355c10511f579270dd6ded13edee8cc (patch)
treebe8e05a5e65c0290e38a07c925a6b8f0847a4b04 /Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
parent6a818ea209bfd552cbcc9b8df8ea962299dd850d (diff)
biblatex-apa (1apr11)
git-svn-id: svn://tug.org/texlive/trunk@21913 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex69
1 files changed, 23 insertions, 46 deletions
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 a53a1352583..390532b2d99 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
@@ -23,7 +23,7 @@
url={http://www.ctan.org/tex-archive/macros/latex/exptl/biblatex-contrib/biblatex-apa/},
author={Philip Kime},
email={Philip@kime.org.uk},
- revision={2.6},
+ revision={2.7},
date={\today}}
\hypersetup{%
@@ -60,14 +60,17 @@ APA Style Guide (6th Edition).
\subsection{Requirements}\label{ref:req}
You will need to be using \sty{csquotes} ($\geq$ 4.3) and \sty{biblatex}
-($\geq$ 0.9a). If you want to take advantage of the \sty{biblatex}
+($\geq$ 1.4). Some features will not work\footnote{Automatic name and name
+ list uniqueness disambiguation---see examples doc} without the
+\sty{biber} backend for \sty{biblatex} ($\geq$ 0.9) which is strongly
+recommended. If you want to take advantage of the \sty{biblatex}
|\DeclareQuotePunctuation| facility to enforce the APA required «American»
-punctuation, you should normally use the \sty{babel} package with the «american»
-option (see \sty{biblatex} manual section |3.9.1|). You can of course use
-other languages but in such cases, to adhere to APA «American» punctuation
-rules (following commas moved inside closing quotes etc.), then you should
-set up |\DeclareQuotePunctuation| yourself as per section |4.6.5| of the
-\sty{biblatex} manual.
+punctuation, you should normally use the \sty{babel} package with the
+«american» option (see \sty{biblatex} manual section |3.9.1|). You can of
+course use other languages but in such cases, to adhere to APA «American»
+punctuation rules (following commas moved inside closing quotes etc.), then
+you should set up |\DeclareQuotePunctuation| yourself as per section
+|4.7.5| of the \sty{biblatex} manual.
If you are using the |apa.cls| \latex class, you need be using version
$\geq$ 1.3.4. The class should be invoked with the |noapacite| class option
@@ -80,7 +83,7 @@ as per the |apa.cls| documentation. Without this class option, the
Permission is granted to copy, distribute and/or modify this software under
the terms of the \latex Project Public License, version
1.3c\footnote{\url{http://www.latex-project.org/lppl.txt}}. The current
-maintainer is Philip Kime (\textcopyright\ 2010).
+maintainer is Philip Kime (\textcopyright\ 2011).
\subsection{History}
@@ -194,45 +197,12 @@ lifted but that's not likely until after \sty{biblatex} version
\subsubsection{maxnames/minnames}
You can't reset these |biblatex| options in your document--you'll get a
-message about conflicting options. These are set to ``999'' in |apa.bbx|
+message about conflicting options. These are set to ``99'' in |apa.bbx|
because of the tricky requirements for APA name list truncation. The
truncation is then done in the author list code rather than by using these
-options. Sorry. This will be changed when |biblatex| moves to using |biber|
-as a backend with a more sophisticated data model.
-
-\subsubsection{Citation Limitations}
-
-\begin{itemize}
-\item \apa{6.14} Disambiguation of truncated author name lists. This is
- currently impossible to automate via a \sty{biblatex} style. The
- \sty{maxnames} and \sty{minnames} options of \sty{biblatex} only serve to
- specify the truncation limits but do not disambiguate name lists which
- truncate to the same string. This cannot be reliably done in the style
- since it would need to build a backwards and forward list of identical
- truncations and map these onto the internal \sty{fullhash} field of
- \sty{biblatex} in order to determine which truncations need
- disambiguating. Since there is no way of knowing, when you truncate
- something, whether something later in the document would have the same
- truncation (without \path{.aux} file support anyway), this is not really
- possible. It's also further complicated by the fact that \bibtex doesn't
- really support name lists in a way which would make this possible and
- since the main name list processing is done in \sty{biblatex} by \bibtex
- still, there isn't much that can be done about this at the moment until
- \sty{biblatex} moves to using something other than \bibtex for its data.
- See the following Usenet thread:\\
-
- \url{http://groups.google.com/group/comp.text.tex/browse_thread/thread/f3c50d7065159ad4#}\\
-
- A related issue is that the \sty{uniquename} option doesn't work in lists
- of authors, again because all the name processing is done by \bibtex.
- Currently, \sty{biblatex} disambiguates non-unique names in lists by
- using the \sty{labelyear} mechanisms which is against APA style (and most
- styles since this is supposed to disambiguate same author(s)/different
- year situations) but there's nothing really that can be done about it at
- the moment. Thankfully, these two problems are not that common and only
- occur when you have long lists of authors which share many members with
- variations in initials etc.
-\end{itemize}
+options. Specifically, the reason is that the APA requirements are that
+name list truncation is done only after the first cite for certain lengths
+of name list and so a global setting cannot be used.
\subsubsection{Reference Section Limitations}
@@ -349,6 +319,13 @@ to see how it was implemented. Some general notes:
\begin{changelog}
+\begin{release}{2.7}{2011-04-1}
+\item Biber is now a strongly recommended requirement due to APA name and
+ name list disambiguation requirements.
+\item Updated for biblatex 1.4/biber 0.9 with automatic list
+ disambiguation. Package now deals with all APA 6th Edition citation examples.
+\end{release}
+
\begin{release}{2.6}{2011-03-15}
\item Made fullcite use ampersand
\item Added fullcitebib macro to allow fake bib citations