biblatex-apa (27nov19)

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

5 files changed, 466 insertions, 35 deletions

diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib
index 420eafd6950..8995de9111c 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib
@@ -810,7 +810,8 @@
   TITLE          = {From this article, it sounds like men are figuring
                     something out that women have known forever. {I} know of many},
   RELATED        = {10.1:18r},
-  RELATEDTYPE    = {commentonarticle},
+  RELATEDTYPE    = {commenton},
+  RELATEDSTRING  = {Comment on the article},
   JOURNALTITLE   = {The Washington Post},
   KEYWORDS       = {nonacademic},
   DATE           = {2019-01-15},
@@ -1547,7 +1548,8 @@
   AUTHOR         = {L. A. Mirabito and N. C. Heck},
   TITLE          = {Bringing {LGBTQ} Youth Theater into the Spotlight},
   RELATED        = {10.7:67r},
-  RELATEDTYPE    = {reviewoffilm},
+  RELATEDTYPE    = {reviewof},
+  RELATEDSTRING  = {Review of the film},
   JOURNALTITLE   = {Psychology of Sexual Orientation and Gender Diversity},
   VOLUME         = {3},
   NUMBER         = {4},
@@ -1571,7 +1573,8 @@
   AUTHOR         = {F. Santos},
   TITLE          = {Reframing Refugee Children's Stories},
   RELATED        = {10.7:68r},
-  RELATEDTYPE    = {reviewofbook},
+  RELATEDTYPE    = {reviewof},
+  RELATEDSTRING  = {Review of the book},
   JOURNALTITLE   = {The New York Times},
   KEYWORDS       = {nonacademic},
   DATE           = {2019-01-11},
@@ -1595,7 +1598,8 @@
   TITLE          = {\textup{The good place} ends its Remarkable Second
                     Season With Irrational Hope, Unexpected Gifts, and a Smile},
   RELATED        = {10.7:69r},
-  RELATEDTYPE    = {reviewoftv},
+  RELATEDTYPE    = {reviewof},
+  RELATEDSTRING  = {Review of the TV series episode},
   ORGANIZATION   = {A.V. Club},
   DATE           = {2018-02-01},
   URL            = {https://www.avclub.com/the-good-place-ends-its-remarkable-second-season-with-i-1822649316}
@@ -2416,6 +2420,217 @@
   URLDATE       = {2019-07-03}
 }
 
+% (APA 11.4 Example 1)
+@JURISDICTION{11.4:1,
+  TITLE         = {Brown v. Board of Education},
+  CITATION      = {347 U.S. 483},
+  URL           = {http://www.oyez.org/cases/1940-1955/347us483},
+  DATE          = {1954}
+}
+
+% (APA 11.4 Example 2)
+@JURISDICTION{11.4:2,
+  TITLE         = {Obergefell v. Hodges},
+  CITATION      = {576 U.S. \_\_\_},
+  URL           = {https://www.supremecourt.gov/opinions/14pdf/14-556_3204.pdf},
+  DATE          = {2015}
+}
+
+% (APA 11.4 Example 3)
+% court/date which applies to the entire CITATION list can be given in the
+% ORGANIZATION and DATE fields
+@JURISDICTION{11.4:3,
+  TITLE         = {Daubert v. Merrell Dow Pharmaceuticals, Inc.},
+  CITATION      = {951 F.2d 1128},
+  ORGANIZATION  = {9th Cir.},
+  URL           = {https://openjurist.org/951/f2d/1128/william-dabert-v-merrell-dow-pharmaceuticals},
+  DATE          = {1991}
+}
+
+% (APA 11.4 Example 4)
+@JURISDICTION{11.4:4,
+  TITLE         = {Burriola v. Greater Toledo YMCA},
+  CITATION      = {133 F.Supp.2d 1034},
+  ORGANIZATION  = {N.D. Ohio},
+  URL           = {https://law.justia.com/cases/federal/district-courts/FSupp2/133/1034/2293141/},
+  DATE          = {2001}
+}
+
+% (APA 11.4 Example 5)
+% For courts and year attached to specific elements of the citation list,
+% don't use ORGANIZATION/DATE, use literal citeorg/citedate annotations
+% use the citeinfo annotation with the special annotation value "appeal" for
+% any affirmed/repealed status in the citatation list
+% DATA/ORIGDATE are also included to make citations work
+@JURISDICTION{11.4:5,
+  TITLE                = {Durflinger v. Artiles},
+  CITATION             = {563 F.Supp. 332 and aff'd and 727 F.2d 888},
+  CITATION+an:citeorg  = {1="D. Kan.";3="10th Cir."},
+  CITATION+an:citedate = {1="1981";3="1984"},
+  CITATION+an:citeinfo = {2=appeal},
+  URL                  = {https://openjurist.org/727/f2d/888/durflinger-v-artiles},
+  DATE                 = {1984},
+  ORIGDATE             = {1981}
+}
+
+% (APA 11.4 Example 6)
+@JURISDICTION{11.4:6,
+  TITLE                = {Tarasoff v. Regents of the University of California},
+  CITATION             = {17 Cal.3d 425 and 131 Cal. Rptr. 14 and 551 P.2d 334},
+  URL                  = {https://www.casebriefs.com/blog/law/torts/tors-keyed-to-dobbs/the-duty-to-protect-from-third-persons/tarasoff-v-regents-of-university-of-california},
+  DATE                 = {1976}
+}
+
+% (APA 11.4 Example 7)
+@JURISDICTION{11.4:7,
+  TITLE                = {Texas v. Morales},
+  CITATION             = {826 S.W.2d 201},
+  CITATION+an:citeorg  = {1="Tex. Ct. App."},
+  CITATION+an:citedate = {1="1992"},
+  URL                  = {https://www.leagle.com/decision/19921027826sw2d20111010},
+  DATE                 = {1992}
+}
+
+% (APA 11.5 Example 8)
+% Notice the use of TITLEADDON here as this shouldn't appear in the
+% citation and so can't be in TITLE - the 11.5 APA section is inconsistent here
+@LEGISLATION{11.5:8,
+  TITLE                = {American With Disabilities Act},
+  TITLEADDON           = {of 1990},
+  LOCATION             = {42 U.S.C § 12101 \emph{et seq.}},
+  URL                  = {https://www.ada.gov/pubs/adastatute08.htm},
+  DATE                 = {1990}
+}
+
+% (APA 11.5 Example 9)
+% Notice the use of TITLEADDON here as this shouldn't appear in the
+% citation and so can't be in TITLE - the 11.5 APA section is inconsistent here
+@LEGISLATION{11.5:9,
+  TITLE                = {Civil Rights Act},
+  TITLEADDON           = {of 1964},
+  LOCATION             = {Pub. L. No. 88--352, 78 Stat. 241},
+  URL                  = {https://www.govinfo.gov/content/pkg/STATUE-78/pdf/STATUTE-78-Pg241.pdf},
+  DATE                 = {1964}
+}
+
+% (APA 11.5 Example 10)
+@LEGISLATION{11.5:10,
+  TITLE                = {Every Student Succeeds Act},
+  LOCATION             = {20 U.S.C § 6301},
+  URL                  = {https://www.congress.gov/114/plaws/publ95/PLAW-114publ95.pdf},
+  DATE                 = {2015}
+}
+
+% (APA 11.5 Example 11)
+@LEGISLATION{11.5:11,
+  TITLE                = {Lilly Leadbetter Fair Play Act},
+  TITLEADDON           = {of 2009},
+  LOCATION             = {Pub. L. No. 111-2, 123 Stat. 5},
+  URL                  = {https://www.govinfo.gov/content/pkg/PLAW-111publ2/pdf/PLAW-111publ2.pdf},
+  DATE                 = {2009}
+}
+
+% (APA 11.5 Example 12)
+@LEGISLATION{11.5:12,
+  TITLE                = {Patsy Mink Equal Opportunity in Education Act},
+  LOCATION             = {20 U.S.C § 1681 \emph{et seq.}},
+  URL                  = {https://www.justice.org/crt/title-ix-education-amendments-1972},
+  DATE                 = {1972}
+}
+
+% (APA 11.5 Example 13)
+@LEGISLATION{11.5:13,
+  TITLE                = {Florida Mental Health Act},
+  LOCATION             = {Fla. Stat. § 394},
+  URL                  = {http://www.leg.state.fl.us/statues/index.cfm?App_mode=Display_Statute&URL=0300-0399/0394/0394.html},
+  DATE                 = {2009},
+  ORIGDATE             = {1971}
+}
+
+% (APA 11.6 Example 14)
+@LEGMATERIAL{11.6:14,
+  TITLE                = {Federal Real Property Reform},
+  SUBTITLE             = {How cutting red tape and better management count
+                          achieve billions in savings, U.S. Senate
+                          Committee on Homeland Security and Governmental Affairs},
+  LOCATION             = {114th Cong.},
+  NOTE                 = {testimony of Norman Dong},
+  URL                  = {http://www.gsa.gov/portal/content/233107},
+  DATE                 = {2016}
+}
+
+% (APA 11.6 Example 15)
+% Note the use of SHORTTITLE to use a shortened title in citations
+@LEGMATERIAL{11.6:15,
+  TITLE                = {Strengthening the Federal Student Loan Program
+                          for Borrowers},
+  SUBTITLE             = {Hearing before the U.S. Senate Committee on
+                          Health, Education, Labor \& Pensions},
+  SHORTTITLE           = {Strengthening the Federal Student Loan Program},
+  LOCATION             = {113th Cong.},
+  URL                  = {https://www.help.senate.gov/hearings/strengthening-the-federal-student-load-program-for-borrowers},
+  DATE                 = {2014}
+}
+
+% (APA 11.6 Example 16)
+@LEGISLATION{11.6:16,
+  TITLE                = {Mental Health on Campus Improvement Act},
+  LOCATION             = {H.R 1100, 113th Cong.},
+  URL                  = {https://www.congress.gov/bill/113th-congress/house-bill/1100},
+  DATE                 = {2013}
+}
+
+% (APA 11.6 Example 17)
+@LEGMATERIAL{11.6:17,
+  SOURCE               = {senate},
+  TYPE                 = {resolution},
+  NUMBER               = {438},
+  LOCATION             = {114th Cong. and 162 Cong. Rec. 2394},
+  NOTE                 = {enacted},
+  URL                  = {https://www.congress.gov/congressional-record/2016/04/21/senate-section/article/S2394-2},
+  DATE                 = {2016}
+}
+
+% (APA 11.6 Example 18)
+@LEGMATERIAL{11.6:18,
+  SOURCE               = {houseofrepresentatives},
+  TYPE                 = {report},
+  NUMBER               = {114-358},
+  URL                  = {https://www.gpo.gov/fdsys/pkg/CRPT-114rpt358/pdf/CRPT-114hrpt358.pdf},
+  DATE                 = {2015}
+}
+
+% (APA 11.7 Example 19)
+@LEGADMINMATERIAL{11.7:19,
+  TITLE                = {Protection of Human Subjects},
+  CITATION             = {45 C.F.R. § 46},
+  URL                  = {https://www.hhs.gov/ohrp/sites/default/files/ohrp/policy/ohrpregulations.pdf},
+  DATE                 = {2009}
+}
+
+% (APA 11.7 Example 20)
+% Note the use of SHORTTITLE to use a shortened title in citations
+@LEGADMINMATERIAL{11.7:20,
+  TITLE                = {Defining and Delimiting the Exemptions for
+                          Executive, Administrative, Professional, Outside
+                          Sales and Computer Employees},
+  SHORTTITLE           = {Defining and Delimiting},
+  CITATION             = {81 F.R. 32391},
+  URL                  = {https://www.federalregister.gov/articles/2016/05/23/2016-11754/defining-and-delimiting-the-exemptions-for-executive-administrative-professional-outside-sales-and},
+  NOTE                 = {to be codified at 29 C.F.R. § 541},
+  KEYWORDS             = {proposed},
+  DATE                 = {2016-05-23}
+}
+
+% (APA 11.7 Example 21)
+@LEGADMINMATERIAL{11.7:21,
+  TYPE                 = {execorder},
+  NUMBER               = {13,676},
+  CITATION             = {3 C.F.R. 294},
+  URL                  = {https://www.govinfo.gov/content/pkg/CFR-2015-title3-vol1/pdf/CFR-2015-title3-vol1-eo13676.pdf},
+  DATE                 = {2014}
+}
+
 % (APA 11.8 Example 22)
 @PATENT{11.8:22,
   AUTHOR        = {S. C. Hiremath and S. Kumar and F. Lu and A Salehi},
@@ -2428,3 +2643,59 @@
   DATE          = {2016}
 }
 
+% (APA 11.9 Example 23)
+@CONSTITUTION{11.9:23,
+  SOURCE        = {us},
+  TYPE          = {constitution},
+  ARTICLE       = {I},
+  SECTION       = {3}
+}
+
+% (APA 11.9 Example 24)
+@CONSTITUTION{11.9:24,
+  SOURCE        = {southcarolina},
+  TYPE          = {constitution},
+  ARTICLE       = {IX},
+  SECTION       = {3}
+}
+
+% (APA 11.9 Example 25)
+@CONSTITUTION{11.9:25,
+  SOURCE        = {us},
+  TYPE          = {constitution},
+  AMENDMENT     = {XIX}
+}
+
+% (APA 11.9 Example 26)
+% Use KEYWORD "repealed" (which is a localised string) and EVENTDATE for the date of repeal
+@CONSTITUTION{11.9:26,
+  SOURCE        = {us},
+  TYPE          = {constitution},
+  AMENDMENT     = {XIX},
+  KEYWORDS      = {repealed},
+  EVENTDATE     = {1933}
+}
+
+% (APA 11.9 Example 27)
+@CONSTITUTION{11.9:27,
+  SOURCE        = {us},
+  TYPE          = {constitution},
+  AMENDMENT     = {I--X}
+}
+
+% (APA 11.9 Example 28)
+% Use PART for paragraph
+@CONSTITUTION{11.9:28,
+  SOURCE        = {unitednations},
+  TYPE          = {charter},
+  ARTICLE       = {1},
+  PART          = {3}
+}
+
+% (APA 11.10 Example 29)
+@LEGAL{11.10:29,
+  TITLE         = {United Nations Convention on the Rights of the Child},
+  DATE          = {1989-11-20},
+  URL           = {https://www.ohchr.org/en/professionalinterest/pages/crc.aspx}
+}
+
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 0ec0090acfb..92de9ef4908 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 0f9e33c0c97..47255082d82 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
@@ -994,7 +994,119 @@ the help of lower-level commands:\\\\
 
 \printbibliography[title={APA 10.16 References}]
 \end{refsection}
+\newpage
+\subsection{APA 11.4--Cases or Court Decisions}
+
+\begin{refsection}
+
+\noindent\apa{11.4 Example 1}\\
+\apaex{\parencite{11.4:1}}\\
+\apaex{\textcite{11.4:1}}
+
+\noindent\apa{11.4 Example 2}\\
+\apaex{\parencite{11.4:2}}\\
+\apaex{\textcite{11.4:2}}
+
+\noindent\apa{11.4 Example 3}\\
+\apaex{\parencite{11.4:3}}\\
+\apaex{\textcite{11.4:3}}
+
+\noindent\apa{11.4 Example 4}\\
+\apaex{\parencite{11.4:4}}\\
+\apaex{\textcite{11.4:4}}
+
+\noindent\apa{11.4 Example 5}\\
+\apaex{\parencite{11.4:5}}\\
+\apaex{\textcite{11.4:5}}
+
+\noindent\apa{11.4 Example 6}\\
+\apaex{\parencite{11.4:6}}\\
+\apaex{\textcite{11.4:6}}
+
+\noindent\apa{11.4 Example 7}\\
+\apaex{\parencite{11.4:7}}\\
+\apaex{\textcite{11.4:7}}
+
+\printbibliography[title={APA 11.4 References}]
+\end{refsection}
+\newpage
+\subsection{APA 11.5--Statues (Laws and Acts)}
+
+\begin{refsection}
+
+\noindent\apa{11.5 Example 8}\\
+\apaex{\parencite{11.5:8}}\\
+\apaex{\textcite{11.5:8}}
+
+\noindent\apa{11.5 Example 9}\\
+\apaex{\parencite{11.5:9}}\\
+\apaex{\textcite{11.5:9}}
+
+\noindent\apa{11.5 Example 10}\\
+\apaex{\parencite{11.5:10}}\\
+\apaex{\textcite{11.5:10}}
+
+\noindent\apa{11.5 Example 11}\\
+\apaex{\parencite{11.5:11}}\\
+\apaex{\textcite{11.5:11}}
+
+\noindent\apa{11.5 Example 12}\\
+\apaex{\parencite{11.5:12}}\\
+\apaex{\textcite{11.5:12}}
+
+\noindent\apa{11.5 Example 13}\\
+\apaex{\parencite{11.5:13}}\\
+\apaex{\textcite{11.5:13}}
+
+\printbibliography[title={APA 11.5 References}]
+\end{refsection}
+\newpage
+\subsection{APA 11.6--Legislative Materials}
+
+\begin{refsection}
+
+\noindent\apa{11.6 Example 14}\\
+\apaex{\parencite{11.6:14}}\\
+\apaex{\textcite{11.6:14}}
+
+\noindent\apa{11.6 Example 15}\\
+\apaex{\parencite{11.6:15}}\\
+\apaex{\textcite{11.6:15}}
+
+\noindent\apa{11.6 Example 16}\\
+\apaex{\parencite{11.6:16}}\\
+\apaex{\textcite{11.6:16}}
 
+\noindent\apa{11.6 Example 17}\\
+\apaex{\parencite{11.6:17}}\\
+\apaex{\textcite{11.6:17}}
+
+\noindent\apa{11.6 Example 18}\\
+\apaex{\parencite{11.6:18}}\\
+\apaex{\textcite{11.6:18}}
+
+\printbibliography[title={APA 11.6 References}]
+\end{refsection}
+\newpage
+\subsection{APA 11.7--Administrative and Executive Materials}
+
+\begin{refsection}
+
+\noindent\apa{11.7 Example 19}\\
+\apaex{\parencite{11.7:19}}\\
+\apaex{\textcite{11.7:19}}
+
+\noindent\apa{11.7 Example 20}\\
+\apaex{\parencite{11.7:20}}\\
+\apaex{\textcite{11.7:20}}
+
+\noindent\apa{11.7 Example 21}\\
+\apaex{\parencite{11.7:21}}\\
+\apaex{\textcite{11.7:21}}
+
+
+\printbibliography[title={APA 11.7 References}]
+\end{refsection}
 \newpage
 \subsection{APA 11.8--Patents}
 
@@ -1006,6 +1118,48 @@ the help of lower-level commands:\\\\
 
 \printbibliography[title={APA 11.8 References}]
 \end{refsection}
+\newpage
+\subsection{APA 11.9--Constitutions and Charters}
+
+\begin{refsection}
+
+\noindent\apa{11.9 Example 23}\\
+\apaex{\parencite{11.9:23}}\\
+\apaex{\textcite{11.9:23}}
+
+\noindent\apa{11.9 Example 24}\\
+\apaex{\parencite{11.9:24}}\\
+\apaex{\textcite{11.9:24}}
+
+\noindent\apa{11.9 Example 25}\\
+\apaex{\parencite{11.9:25}}\\
+\apaex{\textcite{11.9:25}}
+
+\noindent\apa{11.9 Example 26}\\
+\apaex{\parencite{11.9:26}}\\
+\apaex{\textcite{11.9:26}}
+
+\noindent\apa{11.9 Example 27}\\
+\apaex{\parencite{11.9:27}}\\
+\apaex{\textcite{11.9:27}}
+
+\noindent\apa{11.9 Example 28}\\
+\apaex{\parencite{11.9:28}}\\
+\apaex{\textcite{11.9:28}}
+
+\printbibliography[title={APA 11.9 References}]
+\end{refsection}
+\newpage
+\subsection{APA 11.10--Treaties and International Conventions}
+
+\begin{refsection}
+
+\noindent\apa{11.10 Example 29}\\
+\apaex{\parencite{11.10:29}}\\
+\apaex{\textcite{11.10:29}}
+
+\printbibliography[title={APA 11.9 References}]
+\end{refsection}
 
 \end{document}
 
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 0fd4f1aa8ab..1ea1b804621 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 5202c2f914c..eb9b13c1153 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
@@ -24,7 +24,7 @@
   url={http://mirror.ctan.org/macros/latex/exptl/biblatex-contrib/biblatex-apa/},
   author={Philip Kime},
   email={Philip@kime.org.uk},
-  revision={9.0},
+  revision={9.1},
   date={\today}}
 
 \hypersetup{%
@@ -67,14 +67,17 @@ your language, they are generally marked with ``\texttt{\%FIXME}``.
 \subsection{About}
 
 This package is a Bib\LaTeX\ style for APA (American Psychological
-Association) style compliant documents typeset in \latex. It implements a
-citation style (\file{apa.cbx}), a references section style
+Association) 7th Edition style compliant documents typeset in \latex. It
+implements a citation style (\file{apa.cbx}), a references section style
 (\file{apa.bbx}), some data model enhancements (\file{apa.dbx}) and string
 localisation files (\path{<language>-apa.lbx}). The style is loaded just
 like any other Bib\LaTeX\ styles but don't try to use the citation and
 references styles separately as they rely on each other, macro-wise, in
 places.
 
+Please see the package |biblatex-apa6| on CTAN for the APA 6th edition
+conformant version of this style.
+
 In general, there is no attempt to generalise this style for non-APA
 requirements--it is written for APA compliance only. Having said that,
 there are a few options which allow users to change the APA defaults.
@@ -179,18 +182,6 @@ 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}%|
-
-\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}
@@ -198,7 +189,7 @@ apamaxprtauth=<num>
 \noindent This option controls the number of author/editor names which are
 printed in the References. APA style defaults to 20. 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 21 \ldots)
+contexts (for example in a CV where you are an author in position 21 \ldots).
 
 \subsection{Localisation}
 
@@ -237,17 +228,6 @@ A customisable macro \cmd{urldatecomma} determines what comes between the
 date of a URL and the URL itself. This defaults to the standard comma and
 space as per APA style but just a space in germanic localisations.
 
-\subsection{Limitations}
-\label{use:limit}
-There are certain limitations you need to bear in mind when using these
-styles. The APA manual is written without much regard for automation of
-citation and references processing---it just tells you how it wants things to
-look and the implicit assumption is that you would type out everything by
-hand if necessary. Having said that, the majority of the APA citation
-and references style is implemented, there are just a few exceptions which
-are hardly worth the coding pain since they are ambiguous and easily worked
-around.
-
 \section{Details}
 
 The detailed information for this style is contained in the example document and
@@ -257,7 +237,7 @@ accompanying \path{.bib} files:
 \item[\path{biblatex-apa-test.tex}]\footnote{\path{biblatex-apa-test.pdf}
     is also provided and is the typeset version of this \latex source
     file.} This document typesets every useful example from
-  \apa{8}--\apa{10}. The examples in it aim to look as much like the APA
+  \apa{8--10}. The examples in it aim to look as much like the APA
   manual examples as possible. All citation examples in the document are
   real examples using a \path{.bib} file.
 \item[\path{biblatex-apa-test-citations.bib}] This contains the \path{.bib}
@@ -265,10 +245,10 @@ accompanying \path{.bib} files:
   in this file---it's just used to provide real data for the citation
   examples.
 \item[\path{biblatex-apa-test-references.bib}] This contains the
-  \path{.bib} entries for all of the examples in \apa{9} and \apa{10}. This
+  \path{.bib} entries for all of the examples in \apa{9--11}. This
   file is the main documentation for the |biblatex-apa| implementation of
   the APA References section style. To see how the style deals with a
-  particular example from \apa{9} or \apa{10}, look it up in here. Every
+  particular example from \apa{9--11}, look it up in here. Every
   example is marked with the APA example number and has explanatory notes
   where necessary.
 \item[\path{apa.cbx}] The |biblatex-apa| citations style. It is
@@ -388,11 +368,37 @@ because date formatting differs in the style between academic and
 non-academic articles. This is a more general solution than introducing new
 entry types which are not supported by other software.
 
+\subsubsection{Legal Entry Types}
+
+\apa{11} contains the format guidelines for legal references. This is fully
+implemented and the |biblatex-apa-test-references.bib| demonstrates which
+entry types and fields are used to produce the \apa{11} examples. There are
+some custom entry types and fields used to manage this, as you will see in
+the |.bib| file. Considerable use is made of localisation strings in legal
+entries due to the requirements that certain strings change their
+abbreviation status between citations and references (and even between
+parenthetical and narrative citations).
+
+The localisation strings for the U.S. specific elements of this section
+(most of it) are not provided in other languages as there is not much
+point. Feel free to copy them from |american-apa.lbx| if you really need
+to. Localisation strings for all 50 U.S. States are provided to support
+state constitution references.
+
+Pay attention to the |JURISDICTION| entries in the example |.bib| which use
+|biber|'s data annotation feature in order to match the required style
+elements. The names of the data annotations are not optional and must match
+the examples.
+
 \section{Revision history}\label{rev}
 
 \begin{changelog}
 
-\begin{release}{9.0}{2019-}
+\begin{release}{9.1}{2019-11-27}
+\item Bug fixes, internal improvements and implementation of \apa{11}.
+\end{release}
+
+\begin{release}{9.0}{2019-11-23}
 \item First release (of APA 7th edition style)
 \end{release}