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.tex132
1 files changed, 112 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 30aa780e2e2..cbe226392cd 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
@@ -64,7 +64,7 @@
Style files for biblatex
\vspace{.3\baselineskip}
-\sffamily\normalsize\bfseries David Fussner\qquad Version 1.0rc1 (beta) \\
+\sffamily\normalsize\bfseries David Fussner\qquad Version 1.0rc2 (beta) \\
\href{mailto:djf027@googlemail.com}{djf027@googlemail.com}\\ \today
\end{center}
@@ -169,7 +169,7 @@ release.
\begin{itemize}{}{}
\item The \textsf{biblatex} package, of course! The current version
- --- 3.4 at the time of writing --- has received extensive testing,
+ --- 3.7 at the time of writing --- has received extensive testing,
and contains features and bug fixes upon which my code relies.
\textsf{Biblatex} requires several packages, and it strongly
recommends several more:
@@ -195,8 +195,8 @@ release.
use the following:
\item \textsf{Biber} --- the next-generation \textsc{Bib}\TeX\
replacement by Philip Kime and François Charette, available from
- SourceForge. You should use the latest version, 2.5, to work with
- \textsf{biblatex} 3.4 and \textsf{biblatex-chicago}, and it is
+ SourceForge. You should use the latest version, 2.7, to work with
+ \textsf{biblatex} 3.7 and \textsf{biblatex-chicago}, and it is
required for users who are either using the author-date styles or
processing a .bib file in Unicode. See
\mycolor{\textsf{cms-dates-intro.pdf}} and, for example, the
@@ -362,7 +362,7 @@ release.
\subsection{License}
\label{sec:lppl}
-Copyright © 2008--2016 David Fussner. This package is
+Copyright © 2008--2017 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
@@ -4580,13 +4580,13 @@ identify a compiler when \textsf{namec} won't do, e.g., in a
\textsf{biblatex-chicago-notes} will print the appropriate string in
your references.
-\mybigspace Use \mymarginpar{\textbf{\textbackslash partedit}} this
+\mybigspace Use \colmarginpar{\textbf{\textbackslash partedit}} this
macro when identifying an editor whose name doesn't conveniently fit
into the usual fields (\textsf{editor} or \textsf{namea}). (N.B.: If
-you are writing in French and using \textsf{cms-french.lbx}, then
-currently you'll need to add either \texttt{de} or \texttt{d'} after
-this command in your .bib files to make the references come out right.
-I'm working on this.) See chaucer:liferecords.
+you are writing in French then you no longer need to add either
+\texttt{de} or \texttt{d'} after this command in your .bib files. The
+new version of the command should take care of this automatically for
+you.) See chaucer:liferecords.
%\enlargethispage{-\baselineskip}
@@ -5457,6 +5457,14 @@ or in the \textsf{options} field of individual entries. Cf.\
harley:ancient:cart, harley:cartography, and harley:hoc; and
\textsf{crossref} in section~\ref{sec:entryfields}, above.
+\mylittlespace This \colmarginpar{\texttt{ordinalgb}} option, which
+only affects users of the \texttt{british} language, restores the
+previous package defaults, printing the \textsf{day} part of a
+\textsf{date} specification as an ordinal number: 26th March 2017.
+The new package default prints 26 March 2017, which is more in keeping
+both with standard British usage and with the recommendations of the
+\emph{Manual} (9.36). The option is available only in the preamble.
+
\mylittlespace Several
\mymarginpar{\texttt{postnotepunct}\\(experimental)} users, most
recently David Gohlke, have requested a way to alter the punctuation
@@ -5476,7 +5484,7 @@ haven't extensively tested, so I'm labeling this option experimental.
Note also that the option only affects the \textsf{postnote} field of
citation commands, not the \textsf{pages} field in your .bib file.
-% %\enlargethispage{\baselineskip}
+\enlargethispage{\baselineskip}
\mylittlespace This \mymarginpar{\texttt{short}} option means that
your text will only use the short note form, even in the first
@@ -5489,6 +5497,12 @@ citation commands which allow you to present the full reference in
specific cases (see section \ref{sec:citecommands}). If your
bibliography is not complete, then you should not use this option.
+\mylittlespace User \colmarginpar{\texttt{shorthand-\\first}} laudecir
+requested a simpler way to print the \textsf{shorthand} even in the
+first citation of a source, simpler, that is, than remembering to use
+the \cmd{shorthandcite} command. You can set this option to
+\texttt{true} either in the preamble or in individual entries.
+
\mylittlespace Kenneth Pearce \mymarginpar{\texttt{shorthandfull}} has
suggested that, in some fields of study, a list of shorthands
providing full bibliographical information may replace the
@@ -5522,6 +5536,14 @@ rule intervenes to emphasize this continuation. I haven't tested this
code very thoroughly, and it's possible that frequent use of floats
might interfere with it. Let me know if it causes problems.
+\mylittlespace Stefan \colmarginpar{\texttt{urlnotes}} Björk, for
+specialized reasons, requested a way to turn off the printing of
+\textsf{url}, \textsf{doi}, and \textsf{eprint} information in notes
+but not in the bibliography. As it's possible this might be of more
+general usefulness, I've provided a new option. You can set it to
+\texttt{false} either in the preamble or in individual entries, but
+please note that it does not apply to \textsf{online} entries.
+
\mylittlespace Stefan \colmarginpar{\texttt{xrefurl}} Björk pointed
out that when, using the \texttt{longcrossref} or
\texttt{booklongxref} options, you turn on the automatic abbreviation
@@ -6816,6 +6838,8 @@ preamble or in the \textsf{options} field using the
section~\ref{sec:fields:authdate} and \texttt{booklongxref} in
section~\ref{sec:authpreset}, below.
+\enlargethispage{-\baselineskip}
+
\mybigspace This \mymarginpar{\textbf{reference}} entry type is
aliased to \textsf{collection} by the standard \textsf{biblatex}
styles, but I intend it to be used in cases where you need to cite a
@@ -7163,7 +7187,7 @@ undefined, and \textsf{biblatex-chicago} will do the rest. Cf.\
\textsf{foreword} and \textsf{introduction}. (See \emph{Manual} 14.91,
14.116; polakow:afterw.)
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace At \mymarginpar{\textbf{annotation}} the request of Emil
Salim, \textsf{biblatex-chicago} has, as of version 0.9, added a
@@ -7734,6 +7758,8 @@ in the same year then the alphabetical suffix would appear attached to
the \textsf{date} --- (Author [1898] 1974a) and (Author [1898] 1974b)
--- again avoiding ambiguity.
+\enlargethispage{-\baselineskip}
+
\mylittlespace The \emph{Manual} doesn't give clear instructions for
how to cope with these situations, but
\textsf{biblatex-chicago-authordate} provides help. You can't
@@ -10183,13 +10209,13 @@ do, e.g., in a \textsf{note} field or the like. In such a case,
\textsf{biblatex-chicago} will print the appropriate string in your
references.
-\mybigspace Use \mymarginpar{\textbf{\textbackslash partedit}} this
+\mybigspace Use \colmarginpar{\textbf{\textbackslash partedit}} this
macro when identifying an editor whose name doesn't conveniently fit
into the usual fields (\textsf{editor} or \textsf{namea}). (N.B.: If
-you are writing in French and using \textsf{cms-french.lbx}, then
-currently you'll need to add either \texttt{de} or \texttt{d'} after
-this command in your .bib files to make the references come out right.
-I'm working on this.) See howell:marriage.
+you are writing in French then you no longer need to add either
+\texttt{de} or \texttt{d'} after this command in your .bib files. The
+new version of the command should take care of this automatically for
+you.) See howell:marriage.
\mybigspace As \mymarginpar{\textbf{\textbackslash
partedit-\\andcomp}} before, but for use when an editor is also a
@@ -10998,6 +11024,14 @@ use the \cmd{citereset} command, allied possibly with the
\textsf{biblatex}\ \texttt{citereset} option, on which see
\textsf{biblatex.pdf} §3.1.2.1.
+\mylittlespace This \colmarginpar{\texttt{ordinalgb}} option, which
+only affects users of the \texttt{british} language, restores the
+previous package defaults, printing the \textsf{day} part of a
+\textsf{date} specification as an ordinal number: 26th March 2017.
+The new package default prints 26 March 2017, which is more in keeping
+both with standard British usage and with the recommendations of the
+\emph{Manual} (9.36). The option is available only in the preamble.
+
\mylittlespace Originally
\mymarginpar{\texttt{postnotepunct}\\(experimental)} designed for the
notes \&\ bibliography style, this option may in fact be more useful in
@@ -11538,7 +11572,7 @@ quotation marks in some situations, and also failures in the automatic
capitalization routines. Some of these problems disappeared when I
switched to using \textsf{biblatex's} punctuation-tracking code for
\enquote{American} styles, but some remained. A bug report from
-J. P. E.~Harper-Scott suggested a new way of addressing the issue, and
+J.~P.~E.~Harper-Scott suggested a new way of addressing the issue, and
newer versions of Lehman's \textsf{csquotes} package incorporate a
full fix. This, thankfully, doesn't require turning off any of
Xe\LaTeX 's features, and indeed merely involves upgrading to the
@@ -11605,7 +11639,7 @@ 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.
-\enlargethispage{-4\baselineskip}
+%\enlargethispage{-4\baselineskip}
\mylittlespace This release fixes the formatting errors of which I am
aware, though users writing in French should be aware of problems with
@@ -11629,7 +11663,60 @@ code for it, let me know, and I'll look into it.
\section{Revision History}
\label{sec:history}
-\textbf{1.0rc1: Released \today}
+\textbf{1.0rc2: Released \today}
+
+\mylittlespace This is an interim release designed mainly to fix a
+number of subtle issues, pointed out by several users, that appear
+when you use the newest version of \textsf{biblatex} (3.7). These
+were mostly concentrated in the date-handling code, which I believe
+now behaves correctly, and should do both with the newest
+\textsf{biblatex} and with somewhat older releases. A much larger set
+of new features is still pending, but I have fixed some other bugs and
+added a few new options:
+
+\begin{itemize}
+\item J.~P.~E.~Harper-Scott pointed out that, in ordinary British
+ usage, day numbers are presented as plain cardinals rather than
+ ordinals. The \emph{Manual} itself also prefers this format, not
+ only for American-style dates but also for British ones, so I think
+ the previous behavior of the package was a bug. I have in both
+ styles set the default presentation of British day numerals to be
+ plain cardinals, providing a new preamble option
+ \mycolor{\texttt{ordinalgb}} restoring the previous default and
+ printing ordinal dates when using the \texttt{british} language with
+ \textsf{Babel}.
+\item I have, in both styles, attempted to provide an improved
+ \cmd{partedit} macro, the old one being inconvenient for users
+ writing in French. The new macro should work now without manual
+ intervention to provide the correct form of the preposition (de or
+ d'). If you are using the \texttt{french} option to \textsf{Babel},
+ please take care to remove any hand-formatting you might have
+ provided in these contexts.
+\item Jan David Hauck has both reported a bug in the \cmd{gentextcite}
+ code in the author-date styles and also pointed me to its solution,
+ as provided by moewe on
+ \href{http://tex.stackexchange.com/questions/326472/gentextcites-multiple-books-same-author-biblatex-chicago/326628#326628}{Stackexchange}.
+ It turned out there were other bugs in that code, now also fixed.
+\item User laudecir requested a way to present a \textsf{shorthand}
+ even in the first citation of a given work. The new
+ \mycolor{\texttt{shorthandfirst}} option in the notes \&\
+ bibliography style can be set to \texttt{true} either in the
+ preamble or in individual entries, and should make this
+ functionality simpler to activate than the \cmd{shorthandcite}
+ command.
+\item Also in the notes \&\ bibliography style, Stefan Björk requested
+ a way to turn off the printing of \textsf{url}, \textsf{doi}, and
+ \textsf{eprint} information in notes but not in the bibliography.
+ The new \mycolor{\texttt{urlnotes}} option, which you can set to
+ \texttt{false} in the preamble or in individual entries, provides
+ this. Please note that it does not apply to \textsf{online}
+ entries.
+\item Several users pointed out the presence of warnings in .log files
+ caused by deprecated grammar in the default Sorting Schemes of both
+ styles. These should now be fixed.
+\end{itemize}
+
+\textbf{1.0rc1: Released June 7, 2016}
\mylittlespace Obsolete and Deprecated Features:\label{deprec:obsol}
\begin{itemize}
@@ -13233,3 +13320,8 @@ To Do:
\textbf{0.7: First public release, September 18, 2008}
\end{document}
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: t
+%%% End: