summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex75
1 files changed, 55 insertions, 20 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
index 03f2413a321..4d5632861e1 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
@@ -117,7 +117,7 @@ HyphenChar={-}]
Style files for biblatex
\vspace{.3\baselineskip}
-\sffamily\normalsize\bfseries David Fussner\qquad Version 2.3a\\
+\sffamily\normalsize\bfseries David Fussner\qquad Version 2.3b\\
\href{mailto:djf027@googlemail.com}{djf027@googlemail.com}\\ \today
\end{center}
@@ -217,15 +217,16 @@ clickable link to an external document.
\begin{itemize}{}{}
\item The \textsf{biblatex} package, of course! The current version
- --- 3.18b at the time of writing --- has received extensive testing,
+ --- 3.20 at the time of writing --- has received extensive testing,
and contains features and bug fixes upon which my code relies.
- Please don't use any earlier version. \textsf{Biblatex} requires
- several packages, and it strongly recommends several more:
+ Earlier versions may work, but I recommend the latest.
+ \textsf{Biblatex} requires several packages, and it strongly
+ recommends several more:
\begin{itemize}{}{}
\item \textsf{biber} --- the next-generation \textsc{Bib}\TeX\
replacement by Philip Kime and Fran\c{c}ois Charette, available
from SourceForge (required). You should use the latest version,
- 2.18, to work with \textsf{biblatex} 3.18b and
+ 2.20, to work with \textsf{biblatex} 3.20 and
\textsf{biblatex-chicago}; please note that any other backend will
not produce accurate results.
\item e-\TeX\ (required)
@@ -240,7 +241,7 @@ clickable link to an external document.
\item \textsf{babel} --- a standard package (\emph{strongly}
recommended)
\item \textsf{csquotes} --- available from CTAN (recommended).
- Please upgrade to the latest version of \textsf{csquotes} (5.2n).
+ Please upgrade to the latest version of \textsf{csquotes} (5.2o).
\end{itemize}
\item The standard \textsf{expl3} and \textsf{xparse} packages are
loaded automatically for most users, and if they aren't
@@ -436,7 +437,7 @@ clickable link to an external document.
\subsection{License}
\label{sec:lppl}
-Copyright \copyright\ 2008--2022 David Fussner. This package is
+Copyright \copyright\ 2008--2024 David Fussner. This package is
author-maintained. This work may be copied, distributed and/or
modified under the conditions of the \LaTeX\ Project Public License,
either version 1.3 of this license or (at your option) any later
@@ -13147,19 +13148,18 @@ formatted in italics will cause the capitalization algorithm to stop
and leave all of that material as it is, so your .bib entry would need
to have a field something like this:
-\mylittlespace\hspace*{1em}\texttt{title = \{}\cmd{bibstring\{reviewof\}}
+\mylittlespace\hspace*{1em}\texttt{title = \{review of}
\cmd{mkbibemph\{The Chicago manual of style\}\}}
-\mylittlespace (As an aside, the use of the \texttt{reviewof}
-bibstring isn't strictly necessary here, but it helps with portability
-across languages and across the two Chicago styles. If you've noticed
-a lot of lowercase letters starting fields in \textsf{dates-test.bib},
-they're present because in the notes \&\ bibliography style
-capitalization is complicated by notes using commas where the
-bibliography uses periods, and words like \enquote{review} start in
-uppercase only if the context demands it. There's considerably less
-of this in the author-date styles [note the \textsf{*titleaddon}
-fields], but it still pays to be aware of the issue.)
+\mylittlespace (As\colmarginpar{\textsf{biblatex} 3.20} an aside, a
+\cmd{bibstring} at the start of a title field no longer works as it
+used to in the \textsf{trad} style, due to changes in the handling of
+the \cmd{MakeSentenceCase} command. You can still use them if you set
+the \texttt{casechanger} option to \texttt{latex2e}, but otherwise you
+can just provide the actual string, as here. The lowercase letter at
+the start isn't strictly necessary unless you're going to cite the
+work by title instead of by author-date. [Compare the notes \&\
+bibliography style, and also the \textsf{*titleaddon} fields.])
\mylittlespace With regard to italics, the rules of
\textsf{biblatex-chicago-authordate-trad} are as follows:
@@ -16525,6 +16525,7 @@ to a specific naming scheme. You'll need at least:
\begin{verbatim}
\DeclareSortingNamekeyTemplate[<templatename>]{<specification>}
\DeclareUniquenameTemplate[<templatename>]{<specification>}
+\DeclareNamehashTemplate[<templatename>]{<specification>}
\newbibmacro*{name:<templatename>}[<no. of nameparts as digit>]{<code>}
\csdef{cmssort:<templatename>}{\usebibmacro{name:<templatename>}...}
\csdef{cmslabel:<templatename>}{...\usebibmacro{name:<templatename>}...}
@@ -16541,13 +16542,14 @@ then you'll also need:
\end{verbatim}}
If you want to be able to use the your new template name as the
-default template, you'll need to wrap the first two declarations like
+default template, you'll need to wrap the first three declarations like
so:
{\small
\begin{verbatim}
\cms@template@wrapper{\DeclareSortingNamekeyTemplate}[<templatename>]{<spec>}
\cms@template@wrapper{\DeclareUniquenameTemplate}[<templatename>]{<spec>}
+\cms@template@wrapper{\DeclareNamehashTemplate}[<templatename>]{<spec>}
\end{verbatim}}
If your specification requires new name parts, you can copy
@@ -16752,6 +16754,13 @@ title, particularly Unicode ones. If you are using
set of curly braces \{\}\ at the start of the field, but I shall look
into this further.
+\mylittlespace Please\colmarginpar{\textsf{biblatex} 3.20} note, also,
+that in the \textsf{authordate-trad} style you can no longer by
+default use a \cmd{bibstring} at the start of a \textsf{title} field,
+due to the case-changing code in \cmd{MakeSentenceCase}. You can
+either set \texttt{casechanger=latex2e} in the preamble or just write
+the string you need in the\ .bib file.
+
\mylittlespace Patrick Danilevici's Romanian localization
(\textsf{cms-romanian.lbx}) required some fairly extensive changes to
the basic package code, so it's possible that I could improve the
@@ -16770,7 +16779,33 @@ do my best to fix them.
\section{Revision History}
\label{sec:history}
-\textbf{2.3a: Released \today}
+\textbf{2.3b: Released \today}
+
+\mylittlespace This is an interim bug-fix release, mainly to address
+the following breaking change:
+
+\begin{itemize}
+\item The most recent \textsf{biblatex} (3.20) has added a new name
+ template (\mycolor{\cmd{DeclareNamehashTemplate}}) for users
+ requiring non-Western name handling in their reference apparatus, so
+ if you use \textsf{biblatex-chicago's} \texttt{cmsnameparts} option
+ then running \textsf{biber} will fail and \LaTeX\ will not process
+ your documents. This update should rectify that, while still being
+ compatible with earlier versions of \textsf{biblatex}. Thanks to
+ Philipp Immel for alerting me.
+\item I have also added a package-specific definition of the standard
+ citation command \cmd{citetitle} to the author-date styles, as the
+ standard definition sometimes fails there. Thanks to Geoffery Zheng
+ for reporting this.
+\item Users of the \textsf{authordate-trad} style may need to remove
+ some \cmd{bibstring} commands from the start of \textsf{title}
+ fields in their\ .bib files, or else set the \textsf{biblatex}
+ option \texttt{casechanger=latex2e}. Please see
+ section~\ref{sec:bugs} or section~\ref{sec:fields:authdate}, s.v.\
+ \textsf{title}.
+\end{itemize}
+
+\textbf{2.3a: Released November 11, 2022}
\mylittlespace This release backports a bug-fix from the most recent
\LaTeX 3 programming layer. If you are using \textsf{biblatex} 3.18b