path: root/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE

Release notes for version 0.9.8 [2011-08-31]:

 - Starting with biblatex version 1.5, in order to adhere to the
   author-date specification you will need to use Biber to process
   your .bib files, as BibTeX (and its more recent variants) will no
   longer provide all the required features.  Unfortunately, however,
   the current release of Biber (0.9.5) contains bugs that make it
   tricky to use with biblatex-chicago.  These bugs have been
   addressed in 0.9.6 beta, which is available for various operating
   systems in the development subdirectory of your SourceForge mirror,
   e.g., ... b/project/bi/biblatex-biber/biblatex-biber/development.
   (If, by the time you read this, Biber 0.9.6 has already been
   released, then so much the better.)  Please see the start of
   cms-dates-sample.pdf for more details.

 - The switch to Biber for the author-date specification means that
   biblatex now provides considerably enhanced handling of the various
   date fields.  I have attempted to document the relevant changes in
   cms-dates-sample.pdf and in the "date" discussion in
   biblatex-chicago.pdf, but in my testing the only alterations I've
   so far had to make to my .bib files involve adhering more closely
   to the instructions for specifying date ranges.  Biber doesn't like
   {1968/75}, and will ignore it.  Either use {1968/1975} or put
   {1968--75} in the "year" field.

 - In the notes & bibliography style, and mainly in Article, Letter,
   Misc, and Review entries, previous releases of biblatex-chicago
   recommended using the \isdot macro when you needed both to define a
   field and not have it appear in the printed output.  This mechanism
   no longer works in biblatex 1.6, and while addressing the problem I
   realized that relying on it covered over some inconsistencies and
   bugs in my code, so from this release forward you will need to
   modify your .bib and .tex files to use other, more standard
   mechanisms to achieve the same ends, in particular the
   \headlesscite commands and declaring "useauthor=false" in the
   "options" field.  Please consult the documentation in
   biblatex-chicago.pdf section 4.3.1, s.v. "isdot," for a list of
   example entries where you can see these changes at work.

 - The 16th-edition files are well under way, but still a work in
   progress.

Other changes in 0.9.8:

 - Fixed the \smartcite citation command in, and added a \smartcites
   command to, chicago-notes.cbx, so that the notes & bibliography
   style no longer prints parentheses around citations produced using
   \autocite(s) commands inside \footnote commands.  Many thanks to
   Louis-Dominique Dubeau for pointing out this error.

 - Fixed a problem with the \lbx@fromlang command, which biblatex 1.6
   no longer defines.  Many thanks to Rembrandt Wolpert and Aaron
   Lambert for pointing this out, and to Charles Schaum for posting a
   temporary workaround in a newsgroup post.

 - Version 1.6 of biblatex no longer allows you to redefine the
   "minnames" and "maxnames" options in the \printbibliography
   command, so I've defined "minbibnames" and "maxbibnames" in
   biblatex-chicago.sty, instead.  These parameters have been
   available since version 1.1, so this is now the earliest version of
   biblatex that will work with the Chicago styles.  Of course, if the
   (Chicago-recommended) values of these options don't suit your
   needs, you can redefine them in your document preamble.

Release notes for version 0.9.7a [2011-03-17]:

 - Added the \smartcite citation command to chicago-notes.cbx so that
   the notes & bibliography style will work with biblatex 1.3.

 - Added bibstrings "byconductor" and "cbyconductor" to the .lbx
   files, mistakenly omitted in version 0.9.7.

 - Minor fixes to the docs.

Release notes for version 0.9.7 [2011-02-15]:

 - The CustomA and CustomB entry types are now obsolete.  Any such
   entry in your .bib files will be ignored.  Please use Letter and
   BookInBook, respectively.

 - If you still have any CustomC entries containing introductions,
   afterwords, or the like, please change them to SuppBook, as I have
   reclaimed CustomC in order to provide alphabetized cross-references
   to other, separate entries in a bibliography or list of references.

 - The directory structure of the package archive has changed.  I've
   copied that used by the biblatex package, so now you will find a
   latex/ directory with further bbx/, cbx/, and lbx/ subdirectories,
   and a doc/ directory with an examples/ subdirectory.  The files are
   the same as in the previous release, merely organized differently.

Other changes in 0.9.7:

 - I have added three new audiovisual entry types to both styles,
   Audio, Music, and Video.  The documentation of Audio in sections
   4.1 and 5.1 of biblatex-chicago.pdf contains an overview of the
   three, and the details for each type are to be found under their
   individual headings.

 - I have added several new bibstrings to the cms-*.lbx files for
   these new audiovisual entry types.  This means that the
   "editortype" fields can now be set to "director," "producer," or
   "conductor," depending on your needs.  You can also set the fields
   to "none," which eliminates all identifying strings, and which is
   useful for identifying performers of various sorts.

 - I have transformed the CustomC entry type to enable alphabetized
   cross-references -- the "c" is meant to be mnemonic -- to other,
   separate entries in a reference list or bibliography.  In
   particular, this facilitates cross-references to other names in a
   list, rather than to other works.  In author-date, in a procedure
   recommended by the Manual, this now allows you to expand shorthands
   inside the reference list rather than in a list of shorthands.  In
   both styles, you can now provide a pointer to the main entry if a
   reader is looking an author up under, e.g., a pseudonym or other
   alternative name.

 - I have introduced the "userc" field, intended to simplify the
   printing of the cross-references provided by CustomC entries.  The
   standard \nocite command works as well, but the additional
   mechanism may be more convenient in some circumstances.

 - You can now provide an "eventdate" field in Music entries to
   identify, e.g., a particular recording session.  It will be printed
   just after the "title."

 - In the notes & bibliography style, I have now implemented the
   "shorthandintro" field, which allows you to change the string
   introducing a shorthand in the first, long note.  It works just as
   it does in the standard biblatex styles.

 - I have added six new field-exclusion options to both styles, all of
   which can be set both in the document preamble and/or in the
   "options" field of individual .bib entries.  Three of these --
   "doi," "isbn," and "url" -- are standard biblatex options, the
   others -- "bookpages," "includeall," and "numbermonth" -- are
   chicago-specific.

 - I've added the "juniorcomma" option to both styles, which can be
   set in the document preamble and/or in the "options" field of
   individual entries.  It allows you get the traditional comma
   between a surname and "Jr." or "Sr."

 - I fixed some old inaccuracies in the syntax of shortened notes and
   bibliography entries presenting multiple contributions to one
   multi-author (or single-author) volume.  For the most part the
   changes won't affect your .bib files, but there may be cases where
   you need to choose your entry types carefully in order to get the
   results you want.  For the details, please consult the "crossref"
   docs in section 4.2 of biblatex-chicago.pdf.

 - Several other bug fixes -- see biblatex-chicago.pdf for details.

Release notes for version 0.9.5a [2010-09-07]:

 - This fixes an elementary and show-stopping mistake in
   biblatex-chicago.sty, a mistake disguised if you use the csquotes
   package, which I do in all my test files.  Many thanks to Israel
   Jacques and Emil Salim for pointing this out to me.

 - These files have now been tested with biblatex 0.9c and 0.9d, which
   both work fine.

Release notes for version 0.9.5 [2010-09-03]:

Users upgrading from biblatex-chicago-notes-df may need to alter a few
things in their .bib files and in their document preambles.

 - If you used \usepackage{biblatex-chicago} to load the package, now
   you need \usepackage[notes]{biblatex-chicago} instead.  (The
   default if you don't choose between "notes" and "authordate" is, in
   fact, "notes," so even if you don't make this change it should all
   still work.)

 - If you used \usepackage[style=chicago-notes-df]{biblatex} to load
   the package, then be aware that you now need style=chicago-notes
   (or style=chicago-authordate) instead.

 - If you are still, for some reason, using the \custpunctc macro in
   your .bib files, it is now obsolete.  Its function has been taken
   by the punctuation-tracking code present in biblatex for a long
   while now.

 - I have slightly improved the Misc entry type that uses an
   "entrysubtype."  If you are citing archival letters or other
   letter-like sources (memoranda, reports, telegrams), then you're
   already using the "origdate" field, and that's still correct.  If
   you're citing non-letter-like sources (interviews, wills,
   contracts, personal communications received by yourself), then
   putting the date into the "date" field will slightly improve
   compliance with the specification, at least as I interpret it.
   Nothing untoward will happen if you don't make this change, and the
   distinction can be difficult to draw, but it needed mentioning
   nonetheless.

 - I've improved the "number" field in Article, Periodical, and Review
   entries.  You can now put a series or range of numbers into the
   field and the style will print them prefixed by the appropriate
   bibstring, singular or plural.

 - I've improved author-less Manual, Article, and Review entries (the
   latter two with magazine "entrysubtype").  In previous releases of
   biblatex-chicago-notes-df you needed a "shortauthor" field to make
   sure either the "organization" (in Manual entries) or the
   "journaltitle" (in Article and Review entries) appeared in short
   notes.  The style now automatically takes a name for short notes
   from those fields, though you can still use "shortauthor" if you
   wish to present it differently, e.g., in an abbreviated form.
   Again, you probably needn't change anything in your .bib files, but
   being aware of this may make entries simpler to construct in the
   future.

 - I've marked the Custom[A-C] entry types as deprecated, in
   preparation for reusing them for other purposes in the next major
   release.  Please change CustomA to Letter, CustomB to BookInBook,
   and CustomC to SuppBook in your .bib files.

Other changes in 0.9.5:

 - The Chicago author-date style is now implemented in the package,
   and therefore the package name has changed to biblatex-chicago.  A
   number of the files inside the package also have altered names --
   the README file and biblatex-chicago.pdf contain the complete list.

 - I've now implemented the biblatex field "pubstate" in both styles.
   In the author-date style, it is strongly recommended you use it to
   identify reprints by putting the string "reprint" there.  The
   requirements for formatting such entries are relatively complex,
   and the style does the right thing automatically.  In the notes &
   bibliography style, you can also use the field in the same way to
   identify reprints, though placing the \reprint macro in the
   "location" field still works as it always has.  Don't, please, use
   both methods in the same entry.

 - I've improved the functioning of Patent entries to make them more
   compliant with the specification.

 - Entries with a classical "entrysubtype" may behave slightly
   differently now, as I've improved the provision of punctuation
   before certain kinds of page or location specifiers even when
   citing works by their traditional divisions.  This should, once
   again, make the package more compliant.

Release notes for version 0.9a [2010-03-20]:

 - Small, quick fixes for immediate compatibility with biblatex 0.9a.

Release notes for version 0.9 [2010-03-18]:

As I noted in the README file, users will have to modify their .bib
files somewhat to work properly with this release of biblatex-chicago.
Some of these changes result from the disappearance of certain fields
in biblatex itself -- particularly the "day" and "origyear" fields --
so you should at least skim through Lehman's RELEASE file first to
familiarize yourself with what it means for your setup.  The changes
required for Chicago are as follows:

 - In CustomA (Letter) entries, the counter-intuitive reversal of
   roles between "year" and "origyear" has been eliminated.  In common
   with other entry types, the "year" (or "date") field now refers to
   the publication date of the collection.  The new "origdate" field
   now holds the date the letter was written.  In short, change the
   "date" (or "year," "month," and "day") to "origdate," and change
   "origyear" to "year" (or "date").

 - In Misc entries with an "entrysubtype," used to cite unpublished
   sources from a named archive, exactly the same reversal of roles
   was in place, and is now eliminated.  The new "origdate" field now
   holds the date the letter was written or the interview conducted,
   so change the "date" (or "year," "month," and "day") to "origdate."
   (Under most circumstances, therefore, such entries won't have a
   "date" field defined.)  Also, the use of the exact string "letter"
   in the "entrysubtype" field is no longer required.  Using
   "origdate" prints the date where you want it, so anything at all in
   "entrysubtype" will do the trick, with "letter" being as good as
   anything else, meaning you don't actually have to modify this
   field.

 - In Patent entries, you need to make similar changes.  The
   "origdate" field now holds the date the patent was filed, and the
   "date" field identifies when the patent was granted, if it was
   granted.  You no longer need a specially-formatted "addendum" field
   for these entries.  In short, change the "date" (or "year,"
   "month," and "day") to "origdate," and put the date from the
   "addendum" field into "date."  Any supplemental information you
   want printed after the dates of the patent can still be given in
   the "addendum" field, but most such entries won't require this.

 - The "userd" field is now obsolete.  If by some chance you are still
   using it, please move any information found there into the
   "edition" field.

Other changes in 0.9:

 - Added the files cms-german.lbx (with its clone cms-ngerman.lbx) and
   cms-french.lbx, which allow the creation of Chicago-like references
   in those languages.

 - Added the package option "annotation" to allow the creation of
   annotated bibliographies.

 - Added the new biblatex BookInBook entry type, which functions as an
   alias to CustomB.

 - Following biblatex's example, using the editortype field now turns
   off the package's usual string concatenation mechanisms.

 - Added support for the new editor[a-c] and editor[a-c]type fields,
   which function as they do in the standard biblatex styles.

 - My modified csquotes.cfg file is now obsolete, and has been removed
   from the package.  Please upgrade to the latest version of
   csquotes.

 - Added bibstrings to help with internationalization.  The new ones
   you might use in a .bib file are: pseudonym, nodate,
   revisededition, numbers, and reviewof.

Changelog for version 0.8.9d [2010-02-16]:

 - Bug fix release, the last in the 0.8.9 series, intended for use
   with biblatex 0.8i, _not_ with 0.9.  See note above.

Changelog for version 0.8.9c [2009-11-04]:

 - Bug fix release.  The details are in biblatex-chicago-notes-df.pdf.

Changelog for version 0.8.9b [2009-09-09]:

 - Fixed several bugs, both recent and venerable.  Please upgrade to
   the latest version of biblatex (0.8h at time of writing), though I
   have attempted to maintain backward compatibility at least with
   0.8e.

 - Experimental version of the "reprinttitle" field, which allows you
   to provide original publication details of essays or chapters you
   are citing from a later reprint.  See the pdf file for all the
   details.

Changelog for version 0.8.9a [2009-07-05]:

 - Minor fixes to allow compatibility with biblatex 0.8e.  The package
   still works with 0.8d and 0.8c, as well.

Changelog for version 0.8.9 [2009-07-02]:

 - The default way of loading the package has changed.  Please see the
   documentation for all the details, but in short, if you used to
   load it with a command like:

   	\usepackage[style=chicago-notes-df,further-options]{biblatex}

   you should now load it like so:

        \usepackage[further-options]{biblatex-chicago}

 - All single-letter bibstrings are now obsolete.  Please use \autocap
   instead

 - You should be using at least biblatex version 0.8c.  0.8d would be
   even better.

 - The package-specific bibstrings have been removed from the .cbx and
   .bbx files and gathered in a new file, cms-american.lbx.  This
   changes somewhat the way the package interacts with babel, making
   it simpler if you want the defaults, but more complicated if you
   require non-standard features.  In short, assuming you use the
   default loading option I've just described, then babel's main text
   language can be american or english, or alternately you can turn
   off babel altogether, and the strings should be available
   automatically.

 - Added two new entry types, Artwork and Image.

 - Added a new bibliography and entry option usecompiler, set to true
   by default in biblatex-chicago.sty.

 - Added the new bibliography option footmarkoff to
   biblatex-chicago.sty.  This turns off the optional formatting of
   marks (in-line instead of superscript) on foot- or endnotes,
   returning you to the LaTeX defaults.

 - Added the new citation command \headlesscite, which works like
   \headlessfullcite but allows biblatex to decide whether to print
   the full or the short version of the reference.

 - Adopted biblatex's end-of-entry punctuation system, which fixes
   issues several users have been seeing with the solution I offered
   in previous releases.

 - Added a modified csquotes.cfg file (in the XeLaTeX subdirectory) to
   address issues users were having when using XeLaTeX with
   biblatex-chicago.  Please see the docs for the details.

 - Added a new shorthandibid option that allows you to print "Ibid."
   after repeated references to an entry which contains a shorthand
   field.  Previously, the shorthand itself would always be printed,
   and this behavior remains the default if you don't set this option.

 - Added a clone of biblatex's natbib option, so that users who use
   \usepackage{biblatex-chicago} instead of \usepackage{biblatex} can
   still have access to the biblatex's natbib compatibility code in
   bibnatex.def.

Changelog for version 0.8.5a [2009-06-14]:

 - Quick and dirty fix to allow compatibility with biblatex 0.8d.

Changelog for version 0.8.5 [2009-01-10]:

 - At least version 0.8b of biblatex now required -- even better, get
   the latest (0.8c).

 - Adopted the "American" punctuation tracker provided by biblatex,
   which fixes many small formatting errors and eliminates the need
   for \custpunct commands, but requires that you use \mkbibquote when
   quoted material appears inside a bibliography field.

 - Loading babel with "American" as the main text language now
   _strongly_ recommended.

 - The CustomC entry type now allows referencing any sort of post- or
   pre-matter via the type field, though the old mechanism remains in
   place for backward compatibility.  The new SuppBook and
   SuppCollection entry types are aliased to CustomC, and therefore
   work in exactly the same way.

 - The new SuppPeriodical entry type is aliased to Review, and Letter
   to CustomA.

 - For InReference entries the postnote field of a citation command is
   now automatically treated as an alphabetized encyclopedia entry,
   that is, it will be placed in quotation marks and prefaced with the
   string "s.v."  This may allow multiple citations of the same
   reference work without multiplying .bib entries.

 - The biblatex option "usetranslator" is now set to "true" by
   default, which means entries will automatically be alphabetized by
   their translator in the absence of an author or an editor.

 - I've added some color-coding to biblatex-chicago-notes-df.pdf to
   highlight new or significantly revised sections.

Changelog for version 0.8.2.2 [2008-11-24]:

 - Fixed spurious commas in some bibliography entries.

Changelog for version 0.8.2 [2008-11-03]:

 - Fixed several formatting glitches between citations in multicite
   commands and also after some prenotes.

Changelog for version 0.8.1 [2008-10-22]:

 - Updated the .bbx and .cbx files to work with biblatex 0.8.  This
  most recent version of biblatex is now required for
  biblatex-chicago-notes-df to work.

 - The origlocation field is now obsolete, and has been replaced by
  lista.  Please update your .bib files accordingly.

 - The single-letter \bibstring commands I provided in version 0.7 are
  now deprecated.  In most cases, you'll be able to take advantage of
  the automatic contextual capitalization facilities introduced in
  this release, but if you still need the single-letter \bibstring
  functionality then you should switch to \autocap, as I shall be
  removing the single-letter bibstrings in a future release.  See the
  \autocap docs for all the details.

 - The userd field is now deprecated, as biblatex 0.8 allows all forms
  of data to be included in the edition field.  I shall be removing
  userd in a future release, so please update your .bib files as soon
  as is convenient.

 - Added the usera field, which holds supplemental information about a
  journaltitle in article and review entries.  See the documentation
  of the field for details.

 - Other minor fixes and additions.  See the full changelog for more.

Changelog for version 0.7 [2008-08-18]:

 - First public release 

Copyright (c) 2008-2011 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
version.  The latest version of this license is in
http://www.latex-project.org/lppl.txt and version 1.3 or later is part
of all distributions of LaTeX version 2005/12/01 or later.  This
software is provided "as is," without warranty of any kind, either
expressed or implied, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose.