1 files changed, 90 insertions, 78 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
index b0d74ad50e0..1ca60d94f03 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
@@ -6,13 +6,10 @@
 \usepackage[german,french,american]{babel}
 \usepackage[autostyle]{csquotes}
 %\usepackage[document]{ragged2e}
-\usepackage[authordate,backend=biber,babel=hyphen,%
+\usepackage[authordate,backend=biber,autolang=hyphen,booklongxref=false,%
 bibencoding=latin1,strict]{biblatex-chicago}
 % \usepackage[style=chicago-authordate,backend=biber,usecompiler=true,%
 % babel=hyphen,bibencoding=auto,sorting=nyt,cmslos,autocite=inline]{biblatex}
-%\DeclareLanguageMapping{german}{cms-german}
-%\DeclareLanguageMapping{american}{cms-american}
-%\DeclareLanguageMapping{french}{cms-french}
 %\renewcommand*{\rmdefault}{fgn}% The font (gentium) used for pdf
 \usepackage{ifthen}
 \usepackage{setspace}
@@ -41,7 +38,7 @@ bibencoding=latin1,strict]{biblatex-chicago}
 \usepackage{url}
 \urlstyle{rm}
 \appto\bibsetup{\sloppy}
-\hyphenation{evans-ton clem-ens}
+\hyphenation{evans-ton clem-ens mc-hugh}
 \setlength{\dimen\footins}{9.5in}
 \setlength{\parindent}{0pt}
 \setlength{\parskip}{5pt}
@@ -66,17 +63,16 @@ plainpages=false,breaklinks=true]{hyperref}
 Starting with \textsf{biblatex} version 1.5, in order to adhere to the
 author-date specification you will need to use \textsf{Biber} to
 process your .bib files, as \textsc{Bib}\TeX\ (and its more recent
-variants) will no longer provide all the features you need.  I highly
-recommend, therefore, that you upgrade either to \textsf{Biber} 0.9.9
-and to \textsf{biblatex} 1.7, which are designed to work together, or
-to \textsf{Biber} 1.5 and \textsf{biblatex} 2.5, which latter two are
-the newest releases and are likewise designed to work as a matched
-pair.  The advice that follows in this document assumes that you are
-using \textsf{Biber}; if you wish to continue using \textsc{Bib}\TeX\
-then you need \textsf{biblatex} version 1.4c and
-\textsf{biblatex-chicago} 0.9.7a.  (Please contact me at the email
-address in \textsf{biblatex-chicago.pdf} if you have any difficulty
-obtaining a copy of this earlier release.)
+variants) will no longer provide all the features the style requires.
+For this release, you really need the latest versions of
+\textsf{Biber} (1.8) and \textsf{biblatex} (2.8), which contain
+features and bug-fixes on which my own code relies.  The advice that
+follows in this document assumes that you are using \textsf{Biber}; if
+you wish to continue using \textsc{Bib}\TeX\ then you need
+\textsf{biblatex} version 1.4c and \textsf{biblatex-chicago} 0.9.7a.
+(Please contact me at the email address in
+\textsf{biblatex-chicago.pdf} if you have any difficulty obtaining a
+copy of this earlier release.)
 
 \subsection*{Editions}
 \label{editions}
@@ -92,13 +88,13 @@ envisaged by the \emph{Manual} \autocite*[15.45]{chicago:manual},
 grafts the traditional Chicago author-date title formatting onto the
 current recommendations for the remainder of the reference apparatus.
 Please consult \textsf{cms-trad-sample.pdf} to see how this looks in
-practice.  You can also still use the 15th-edition style files from
+practice.  You can also still use the 15th-edition styles from
 \textsf{biblatex-chicago}, which have been updated with some
 improvements borrowed from the 16th edition, but which are now
-deprecated.  (See \textsf{biblatex-chicago15.pdf} and
+strongly deprecated.  (See \textsf{biblatex-chicago15.pdf} and
 \textsf{cms15-dates-sample.pdf}.)  I would encourage all users to
 switch to one of the 16th-edition styles as soon as possible, as I am
-concentrating nearly all of my development time there.
+concentrating all of my development time there.
 
 \subsection*{Usage}
 \label{usage}
@@ -190,22 +186,34 @@ known or can be guessed: \autocite{horsley:prosodies};
 edition is less than enthusiastic about the use of
 \enquote{\texttt{Anon.}}\ as author.
 
-With \textsf{Biber}, in most entry types, an absent \textsf{date} will
-automatically provoke it into searching for other sorts of dates in
-the entry, in the order \textsf{year, eventyear, origyear, urlyear}:
-e.g., \autocite{evanston:library}, which only has a \textsf{urlyear}.
-In three entry types --- \textsf{Music}, \textsf{Review}, and
-\textsf{Video} --- this search order is \textsf{eventyear, origyear,
-  year, urlyear}, as in these types the earliest year should take
-precedence (cf.\ page~\pageref{sec:audiovisual}, below).  You can
+By default, in most entry types, an absent \textsf{date} will
+automatically provoke \textsf{Biber} into searching for other sorts of
+dates in the entry, in the order \textsf{year, eventyear, origyear,
+  urlyear}: e.g., \autocite{evanston:library}, which only has a
+\textsf{urlyear}.  In three entry types --- \textsf{Music},
+\textsf{Review}, and \textsf{Video} --- this search order is
+\textsf{eventyear, origyear, year, urlyear}, as in these types the
+earliest year should take precedence (cf.\
+page~\pageref{sec:audiovisual}, below).  Beginning with this release,
+you can change the default search order, for all but the three types
+just mentioned, by using the \texttt{cmsdate} option in the preamble
+of your document, instead of (or in addition to) using it in the
+\textsf{options} field of individual entries.  Setting that option in
+the preamble either to \enquote{\texttt{both}} or
+\enquote{\texttt{on}} makes the document-wide search order:
+\textsf{origyear, year, eventyear, urlyear}.  This may be useful for
+documents that contain many entries with multiple dates, and where you
+want \emph{always} to present the earlier (i.e., \textsf{orig}) dates
+at the head of reference list entries and in citations.  You can
 eliminate some of these dates from the running, or change the search
-order, using the \cmd{DeclareLabelyear} command in your preamble, but
-please be aware that I have hard-coded this order into the author-date
-style in order to cope with some tricky corners of the specification.
-If you reorder these dates, and your references enter these tricky
-corners, the results might be surprising.  (Cf.\ section~4.5.2 in
-\textsf{biblatex.pdf} and section~5.2, s.v.\ \enquote{date} in
-\textsf{biblatex-chicago.pdf} for the details.)
+order, using the \cmd{DeclareLabeldate} command in your preamble, but
+please be aware that I have hard-coded the possibilities above into
+the author-date style in order to cope with some tricky corners of the
+specification.  If you reorder these dates, and your references enter
+these tricky corners, the results might be surprising.  (Cf.\
+section~4.5.8 in \textsf{biblatex.pdf} and especially section~5.2,
+s.v.\ \enquote{\textsf{date}} in \textsf{biblatex-chicago.pdf} for the
+gory details.)
 
 In most entry types, the absence of all four possible dates will
 automatically produce \mbox{\enquote{\texttt{n.d.}\hspace{-2pt}}}
@@ -214,30 +222,31 @@ yourself in the form \cmd{bibstring\{nodate\}}:
 \autocite{ross:thesis}.  A date that can be guessed should appear
 within square brackets: \autocite{clark:mesopot}.  Forthcoming works
 are straightforward, assuming you remember to use the \cmd{autocap}
-macro so that the word appears correctly in both citations and the
-list of references: \autocite{author:forthcoming};
-\autocite{contrib:contrib}.
+macro and the \textsf{year} (instead of the \textsf{date}) field, so
+that the word appears correctly in both citations and the list of
+references: \autocite{author:forthcoming}; \autocite{contrib:contrib}.
 
 The 16th edition of the \emph{Manual} has changed the rules for
 entries with more than one date \autocite[15.38]{chicago:manual}.
-First, \textsf{Music} and \textsf{Video} entries have their own rules,
-which are applied automatically.  (Once again, see
-page~\pageref{sec:audiovisual}, below.)  For other entry types, there
-are two options, corresponding to two different states of the
-\texttt{cmsdate} entry option.  The default is \texttt{cmsdate=off}:
-\autocite{maitland:equity}.  Here, setting the \textsf{pubstate} field
-to \texttt{reprint} ensures that a notice of the original publication
-date will be printed at the end of the reference list entry.
-Alternatively, you can use \texttt{cmsdate=both}:
-\autocite{emerson:nature}; \autocite{maitland:canon}.
-\texttt{cmsdate=new} and \texttt{cmsdate=old} are both now synonyms of
-\texttt{both}, while \texttt{cmsdate=on} is still available even
-though it falls outside the specification:
-\autocite{james:ambassadors}.  These options, in combination with
-others available in your .bib files, can cover a wide range of
-difficult cases.  Please see the next section below, the documentation
-in \textsf{biblatex-chicago.pdf}, and also the following entries in
-\textsf{dates-test.bib}:
+First, \textsf{Music}, \textsf{Review}, and \textsf{Video} entries
+have their own rules, which are applied automatically.  (Once again,
+see page~\pageref{sec:audiovisual}, below.)  For other entry types,
+there are two options, corresponding to two different states of the
+\texttt{cmsdate} entry (or preamble) option.  The default is
+\texttt{cmsdate=off}: \autocite{maitland:equity}.  Here, setting the
+\textsf{pubstate} field to \texttt{reprint} ensures that a notice of
+the original publication date will be printed at the end of the
+reference list entry.  Alternatively, you can use
+\texttt{cmsdate=both}: \autocite{emerson:nature};
+\autocite{maitland:canon}.  \texttt{cmsdate=new} and
+\texttt{cmsdate=old} are both now synonyms of \texttt{both}, while
+\texttt{cmsdate=on} is still available even though it falls outside
+the specification: \autocite{james:ambassadors}.  These options, in
+combination with others available in your .bib files, can cover a wide
+range of difficult cases.  Please see the next section below, the
+documentation in \textsf{biblatex-chicago.pdf}, particularly in
+section~5.2, s.v.\ \enquote{\textsf{date},} and also the following
+entries in \textsf{dates-test.bib}:
 \autocites{schweitzer:bach}{white:russ}{white:ross:memo}.
 
 \subsection*{Corners of the specification}
@@ -309,6 +318,8 @@ in standard author-date format.)  A \cmd{cite*} or \cmd{autocite*}
 command will, in such a case, produce the title rather than the year.
 Some examples should make this clearer:
 
+\enlargethispage{-\baselineskip}
+
 Classical works: without abbreviation:
 \autocite{aristotle:metaphy:trans}; with abbreviation:
 \autocite{aristotle:metaphy:gr}; \autocite{plato:republic:gr}; using
@@ -433,29 +444,30 @@ Book: \autocite{barrows:reading}; \autocite{churchill:letters};
 \autocite{creasey:ashe:blast}; \autocite{creasey:morton:hide};
 \autocite{creasey:york:death}; \autocite{davenport:attention};
 \autocite{feydeau:farces}; \autocite{furet:passing:eng};
-\autocite{furet:passing:fr}; \autocite{harley:cartography};
-\autocite{hopp:attalid}; \autocite{howell:marriage};
-\autocite{lach:asia}; \autocite{lecarre:quest};
-\autocite{levistrauss:savage}; \autocite{lynch:webstyle};
-\autocite{maisonneuve:relations}; \autocite{mchugh:wake};
-\autocite{menchu:crossing}; \autocite{meredith:letters};
-\autocite{michelangelo:poems}; \autocite{mla:style};
-\autocite{natrecoff:camera}; \autocite{palmatary:pottery};
-\autocite{pelikan:christian}; \autocite{rodman:walk};
-\autocite{schellinger:novel}; \autocite{sechzer:women};
-\autocite{sereny:cries}; \autocite{soltes:georgia};
-\autocite{stendhal:parma}; \autocite{suangtho:tectona};
-\autocite{thompson:making}; \autocite{tillich:system};
-\autocite{times:guide}; \autocite{turabian:manual};
-\autocite{walker:columbia}; \autocite{wauchope:ceramics};
-\autocite{weber:saugetiere}; \autocite{weresz};
-\autocite{white:total}; \autocite{wright:evolution};
-\autocite{wright:theory}.
-
-BookInBook: \autocite{bernard:boris}.
-
-Collection: \autocite{brush:ornithology}; \autocite{kamrany:economic};
-\autocite{prairie:state}; \autocite{zukowsky:chicago}.
+\autocite{furet:passing:fr}; \autocite{hopp:attalid};
+\autocite{howell:marriage}; \autocite{lach:asia};
+\autocite{lecarre:quest}; \autocite{levistrauss:savage};
+\autocite{lynch:webstyle}; \autocite{maisonneuve:relations};
+\autocite{mchugh:wake}; \autocite{menchu:crossing};
+\autocite{meredith:letters}; \autocite{michelangelo:poems};
+\autocite{mla:style}; \autocite{natrecoff:camera};
+\autocite{palmatary:pottery}; \autocite{pelikan:christian};
+\autocite{rodman:walk}; \autocite{schellinger:novel};
+\autocite{sechzer:women}; \autocite{sereny:cries};
+\autocite{soltes:georgia}; \autocite{stendhal:parma};
+\autocite{suangtho:tectona}; \autocite{thompson:making};
+\autocite{tillich:system}; \autocite{times:guide};
+\autocite{turabian:manual}; \autocite{walker:columbia};
+\autocite{wauchope:ceramics}; \autocite{weber:saugetiere};
+\autocite{weresz}; \autocite{white:total};
+\autocite{wright:evolution}; \autocite{wright:theory}.
+
+BookInBook: \autocite{bernhard:boris}; \autocite{bernhard:ritter}.
+
+Collection: \autocite{brush:ornithology};
+\autocite{harley:cartography}; \autocite{harley:ancient:cart};
+\autocite{kamrany:economic}; \autocite{prairie:state};
+\autocite{zukowsky:chicago}.
 
 Image: \autocite{bedford:photo}.