From af02a622c9b2c5226fb7d8f28c1443f6bbb0c48b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 15 Apr 2024 20:03:54 +0000 Subject: biblatex-chicago (15apr24) git-svn-id: svn://tug.org/texlive/trunk@70955 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/biblatex-chicago/README | 8 +-- .../texmf-dist/doc/latex/biblatex-chicago/RELEASE | 26 ++++++- .../latex/biblatex-chicago/biblatex-chicago.pdf | Bin 1245018 -> 1247496 bytes .../latex/biblatex-chicago/biblatex-chicago.tex | 75 +++++++++++++++------ .../doc/latex/biblatex-chicago/cms-dates-intro.pdf | Bin 233089 -> 233075 bytes .../doc/latex/biblatex-chicago/cms-dates-intro.tex | 2 +- .../latex/biblatex-chicago/cms-dates-sample.pdf | Bin 182889 -> 182891 bytes .../latex/biblatex-chicago/cms-legal-sample.pdf | Bin 64860 -> 64859 bytes .../latex/biblatex-chicago/cms-noteref-demo.pdf | Bin 87995 -> 87997 bytes .../doc/latex/biblatex-chicago/cms-notes-intro.pdf | Bin 280404 -> 280489 bytes .../latex/biblatex-chicago/cms-notes-sample.pdf | Bin 158653 -> 158659 bytes .../latex/biblatex-chicago/cms-trad-appendix.pdf | Bin 68316 -> 68320 bytes .../latex/biblatex-chicago/cms-trad-appendix.tex | 2 +- .../doc/latex/biblatex-chicago/cms-trad-sample.pdf | Bin 157473 -> 157473 bytes .../doc/latex/biblatex-chicago/dates-test.bib | 69 ++++++++++--------- 15 files changed, 122 insertions(+), 60 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/README b/Master/texmf-dist/doc/latex/biblatex-chicago/README index 1c8ed3d79a4..92d9894febc 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/README +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/README @@ -1,7 +1,7 @@ IMPORTANT NOTE: This is the package formerly known as biblatex-chicago-notes-df. It -is designed for use with the latest version (3.18b) of biblatex. The +is designed for use with the latest version (3.20) of biblatex. The package contains the 17th-edition Chicago style files, and I am also maintaining the 16th-edition files for those for whom they remain a necessity, though I have deprecated these older files and will remove @@ -12,10 +12,10 @@ If you have used the package before, then you should be sure to consult the RELEASE file to find out what alterations you may need to make to your .bib files and document preambles to bring them up to date. Most particularly please note that biber is now the required -backend for all the included styles (version 2.18 is designed for use +backend for all the included styles (version 2.20 is designed for use with the latest biblatex). -README (version 2.3a, 2022-11-17): +README (version 2.3b, 2024-04-15): Biblatex-chicago contains three biblatex styles implementing the specifications of the Chicago Manual of Style, 17th edition. The @@ -107,7 +107,7 @@ familiar from other packages: Changelog: See the RELEASE file, and also the end of biblatex-chicago.pdf. -Copyright (c) 2008-2022 David Fussner. This package is +Copyright (c) 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 diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE index 6710cdb5cd7..7000790ede3 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE @@ -1,3 +1,27 @@ +Release notes for version 2.3b [2024-04-15]: + +This is an interim bug-fix release, mainly to address the following +breaking change: + + - The most recent biblatex (3.20) has added a new name template + (\DeclareNamehashTemplate) for users requiring non-Western name + handling in their reference apparatus, so if you use + biblatex-chicago's "cmsnameparts" option then running biber will + fail and LaTeX will not process your documents. This update should + rectify that, while still being compatible with earlier versions of + biblatex. Thanks to Philipp Immel for alerting me. + + - I have also added a package-specific definition of the standard + citation command \citetitle to the author-date styles, as the + standard definition sometimes fails there. Thanks to Geoffery + Zheng for reporting this. + + - Users of the "authordate-trad" style may need to remove some + \bibstring commands from the start of "title" fields in their .bib + files, or else set the biblatex option "casechanger=latex2e". + Please see section 10 or section 5.2, s.v. "title" in + biblatex-chicago.pdf. + Release notes for version 2.3a [2022-11-17]: This release backports a bug-fix from the most recent LaTeX3 @@ -2314,7 +2338,7 @@ Changelog for version 0.7 [2008-08-18]: - First public release -Copyright (c) 2008-2022 David Fussner. This package is +Copyright (c) 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 diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf index 360c89392c1..b76f21b7ce2 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf differ 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[]{} \DeclareUniquenameTemplate[]{} +\DeclareNamehashTemplate[]{} \newbibmacro*{name:}[]{} \csdef{cmssort:}{\usebibmacro{name:}...} \csdef{cmslabel:}{...\usebibmacro{name:}...} @@ -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}[]{} \cms@template@wrapper{\DeclareUniquenameTemplate}[]{} +\cms@template@wrapper{\DeclareNamehashTemplate}[]{} \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 diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.pdf index 9bec0f838a3..4c29a4e7aae 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.tex index ce731879279..9ec5628d075 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-intro.tex @@ -102,7 +102,7 @@ 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 the style requires. For this release, you really need the current versions of -\textsf{biber} (2.18) and \textsf{biblatex} (3.18b), which contain +\textsf{biber} (2.20) and \textsf{biblatex} (3.20), 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 diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf index 320fd9992d3..91b56ea09a7 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-legal-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-legal-sample.pdf index 74207ffb426..d2ad5aeb431 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-legal-sample.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-legal-sample.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-noteref-demo.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-noteref-demo.pdf index e4afcb084a2..60e3b310258 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-noteref-demo.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-noteref-demo.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-intro.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-intro.pdf index 4d3ee06024b..de77e00d035 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-intro.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-intro.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf index 9d07d47fee9..8634c2040d0 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.pdf index 26f5668cba7..7928a46d104 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.tex index 9a19f2a0107..e59f4757bfe 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-appendix.tex @@ -76,7 +76,7 @@ HyphenChar={-}] author = {Barcott, Bruce}, date = {2000-04-16}, entrysubtype = {magazine}, - title = {\bibstring{reviewof} \mkbibemph{The last marlin: The story of a family at sea}, \bibstring{by} {Fred Waitzkin}}, + title = {review of \mkbibemph{The last marlin: The story of a family at sea}, by {Fred Waitzkin}}, pages = 7 } \end{lstlisting} diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.pdf index f82bc3416ac..5be01f087fe 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.pdf and b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib b/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib index f6f0a1b980f..f5ba90f5a38 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib @@ -371,28 +371,30 @@ author = {Barcott, Bruce}, date = {2000-04-16}, entrysubtype = {magazine}, - title = {\bibstring{reviewof} \mkbibemph{The last marlin: The - story of a family at sea}, \bibstring{by} {Fred Waitzkin}}, + title = {review of \mkbibemph{The last marlin: The story of a + family at sea}, by {Fred Waitzkin}}, pages = 7, annotation = {Because of the absence of quotation marks around the \textsf{title} in the \texttt{trad} style, the \textsf{Article} and \textsf{Review} entry types are more or less interchangeable. This entry presents a review from a newspaper, with keyword - \texttt{magazine} in \textsf{entrysubtype}, and with - \cmd{bibstring\{reviewof\}} in the \textsf{title} - field. You could just write \enquote{review of} - instead, but the \cmd{bibstring} makes the entry - portable across languages. Note the formatting of - the reviewed book's title using \cmd{mkbibemph}, and - the sentence-style capitalization you have to - provide by hand for the \texttt{trad} style, because - the curly braces of \cmd{mkbibemph} protect the text - from the automatic sentence-style capitalization - provided by the package. \textsf{Biblatex-chicago} - never modifies the capitalization of the - \textsf{journaltitle}, so that field should always - work properly across styles.} + \texttt{magazine} in \textsf{entrysubtype}. A + \cmd{bibstring\{reviewof\}} at the start of the + \textsf{title} field won't work anymore in the + \textsf{trad} style unless you change the setting of + the \texttt{casechanger} option to \texttt{latex2e}. + Instead of that you can just write \enquote{review + of.} Note the formatting of the reviewed book's + title using \cmd{mkbibemph}, and the sentence-style + capitalization you have to provide by hand for the + \texttt{trad} style, because the curly braces of + \cmd{mkbibemph} protect the text from the automatic + sentence-style capitalization provided by the + package. \textsf{Biblatex-chicago} never modifies + the capitalization of the \textsf{journaltitle}, so + that field should always work properly across + styles.} } @Book{barrows:reading, @@ -3223,29 +3225,30 @@ @Article{ratliff:review:15, author = {Ratliff, Ben}, - title = {\bibstring{reviewof} \mkbibemph{The mystery of - samba: Popular music and national identity in - Brazil}, \bibstring{by} {Hermano Vianna}, - \parteditandtrans {John Charles Chasteen}}, + title = {review of \mkbibemph{The mystery of samba: Popular + music and national identity in Brazil}, by {Hermano + Vianna}, \parteditandtrans {John Charles Chasteen}}, journaltitle = {Lingua Franca}, date = {1999-04}, volume = 9, pages = {B13--B14}, annotation = {An Article entry presenting a review from a scholarly journaltitle, hence no entrysubtype - needed. Note the bibstrings in the title of the - review, and the formatting of the title of the book - reviewed there, for the trad style. Also note the - use of parteditandtrans. The author-date system - doesn't absolutely require the use of these - mechanisms, which were invented to cope with the - differences between notes and bibliography in the - other Chicago style. Still, although simply writing - "ed. and trans." yourself will suffice, using these - mechanisms will make your .bib file work across - multiple languages, and will also allow it to work, - with fewer modifications, in the notes \& - bibliography style, should that be needed.} + needed. A bibstring at the start of the title no + longer works in the trad style, unless you set the + casechanger option to "latex2e" in your + preamble. Note the formatting of the title of the + book reviewed, and also the use of + parteditandtrans. The author-date system doesn't + absolutely require the use of this latter mechanism, + which was invented to cope with the differences + between notes and bibliography in the other Chicago + style. Still, although simply writing "ed. and + trans." yourself will suffice, using the mechanism + will make your .bib file work across multiple + languages, and will also allow it to work, with + fewer modifications, in the notes \& bibliography + style, should that be needed.} } @Article{reaves:rosen, -- cgit v1.2.3