summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-07-11 23:30:43 +0000
committerKarl Berry <karl@freefriends.org>2012-07-11 23:30:43 +0000
commit562ae685591240b0ea768aa3de044339bcaee64e (patch)
treefe67bf362ccf70a9434b3a4ed2760af84eaa42ab /Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
parent6d1e02f252c44d2e43c13d9d0608e628812a8a90 (diff)
biblatex-chicago 16th (6jul12)
git-svn-id: svn://tug.org/texlive/trunk@27002 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE373
1 files changed, 373 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
index 57a0235ddeb..353550ed501 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
+++ b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
@@ -1,3 +1,376 @@
+Release notes for version 0.9.9 [2012-07-05]:
+
+This release contains, for the first time, the style files for the
+16th edition of the Chicago Manual of Style. If you wish to begin
+using the newest specification, then there are some changes you'll
+have to make to your .bib files, which I summarize here. First, I
+consider the notes & bibliography style, then author-date. After
+that, you can find a listing of more general changes to the package,
+followed by the changes I've made to the 15th-edition styles.
+
+Notes & Bibliography:
+
+ - The specification for Music entries has been significantly altered
+ for the new edition. You no longer need to worry about the
+ \textcircledP and \textcopyright signs in the "howpublished" field,
+ which will be silently ignored, and the "pubstate" field now
+ reverts to its usual function of identifying reprints or, in this
+ case, reissues. The spec really only requires a record label
+ ("series") and catalog number ("number"), though "publisher" is
+ still available if you need it. There is a new emphasis, finally,
+ on the dating of musical recordings, so that the "eventdate" gives
+ the recording date of a particular song or other portion of a
+ recording, the "origdate" the recording date of an entire album,
+ and the "date" the publishing date of that album. Please see the
+ full documentation in biblatex.pdf.
+
+ - The specification for Video entries has also been clarified. For
+ television series, the episode and series numbers go in
+ "booktitleaddon" instead of "titleaddon" and, as with Music
+ entries, the "eventdate" will hold the original broadcast date of
+ such an episode, or perhaps the recording/performance date of,
+ e.g., an opera on DVD. The "origdate" will still hold the original
+ release date of a film, and the "date" the publishing or copyright
+ date of the medium you are referencing. Please see the full
+ documentation in biblatex.pdf.
+
+ - You should add CustomC entries to provide bibliographical
+ cross-references from multiple pseudonyms back to the author's
+ name.
+
+ - In SuppBook entries, the Manual now requires you to provide the
+ page range (in the "pages" field) for the specific part you are
+ citing, e.g., an introduction, foreword, or afterword.
+
+ - In Patent entries, the Manual now prefers sentence-style
+ capitalization for titles, which you'll need to provide yourself by
+ hand.
+
+ - When a descriptive phrase is used as an "author," you can now omit
+ an initial definite or indefinite article, which will help with
+ alphabetization in the bibliography.
+
+ - A DOI is now preferred to a URL, if both are available.
+
+ - On the same subject, a revision date (or similar) is preferred to
+ an access date for online material. You can use the new "userd"
+ field to change the string introducing the "urldate," which
+ defaults to being an access date.
+
+ - Special imprints are now separated from their parent press by a
+ forward slash rather than a comma, so can just be added to the
+ "publisher" field with the usual keyword "and".
+
+ - I have implemented a reasonable, less-flexible facsimile of the
+ Biber-only command \DeclareLabelname which should work for those
+ using any backend. It allows biblatex to find a name for short
+ notes outside the standard name fields, including, notably, in the
+ "name[a-c]" fields. This should reduce the instances where you
+ need a "shortauthor" field to provide such a name.
+
+ - The Chicago-specific setting of another Biber-only command,
+ \DeclareSortingScheme=cms, allows non-standard fields to be
+ considered by biblatex's sorting algorithms, which should reduce
+ the instances where you need a "sortkey" or the like in your
+ entries. If you aren't using Biber, the package reverts to the
+ standard "nty" sorting scheme.
+
+Author-Date:
+
+ - All title fields now follow the rules for the notes & bibliography
+ style as far as punctuation, formatting, and capitalization are
+ concerned. Biblatex-chicago-authordate will deal with most of this
+ automatically, but if you have any hand formatting of lowercase
+ letters within curly braces in your .bib file, you will need to
+ restore the headline-style capitalization there. Also, you'll need
+ to be more careful when you provide quotation marks inside titles,
+ remembering to use \mkbibquote so that punctuation can be brought
+ inside nested quotation marks. These revisions will apply
+ particularly to "title," "booktitle," and "maintitle" fields.
+
+ - The one exception to these rules is in Patent entries, where
+ sentence-style capitalization of the "title" is now specified.
+ You'll have to provide this by hand yourself, as in the notes &
+ bibliography style.
+
+ - Because of these changes to title formatting, you'll need to
+ observe the difference between Article and Review entries, where
+ the latter contain generic, "Review of ..." titles and the former
+ standard, specific titles.
+
+ - The presentation of "shorthand" fields has changed. You no longer
+ need to use the CustomC entry type to include cross-references from
+ shorthands to expansions in the list of references. Now, simply
+ using a "shorthand" field in an entry places that "shorthand" in
+ citations and at the head of the entry in the list of references,
+ where it will be followed by its expansion within parentheses. The
+ new system will require help with sorting in the reference list --
+ placing the "shorthand" also in a "sortkey" should do the trick.
+
+ - On the subject of CustomC entries, the Manual now recommends using
+ cross-references in several contexts, particularly when a single
+ author uses more than one pseudonym. Adding CustomC entries makes
+ this happen.
+
+ - There have been significant changes when presenting book-like
+ entries with more than one date. If you are using the "cmsdate=on"
+ option, or indeed simply placing the earlier date in the "date"
+ field and the later one in "origdate," the presentation will be the
+ same as before, but you should understand that the Manual no longer
+ recommends this "origdate"-only style. It prefers, instead, to
+ present either the "date" alone or both dates in citations and at
+ the head of reference list entries. When presenting both dates,
+ there is now no longer a choice between the "old" and "new" options
+ for "cmsdate," but only the "both" option. If you have "old" or
+ "new" in your .bib files, they will be treated as synonyms of
+ "both".
+
+ - The specification for Music entries has been significantly altered
+ for the new edition. You no longer need to worry about the
+ \textcircledP and \textcopyright signs in the "howpublished" field,
+ which will be silently ignored, and the "pubstate" field reverts to
+ its more usual function of identifying reprints or, in this case,
+ reissues. The spec really only requires a record label ("series")
+ and catalog number ("number"), though "publisher" is still
+ available if you need it. There is a new emphasis, finally, on the
+ dating of musical recordings, which means that such entries will
+ fit better with the author-date style. It also means that I have
+ had to redefine the various date fields. The "eventdate" gives the
+ recording date of a particular song or other portion of a
+ recording, the "origdate" the recording date of an entire album,
+ and the "date" the publishing date of that album. The earlier date
+ is the one that will appear in citations and at the head of
+ reference list entries. Please see the full documentation in
+ biblatex-chicago.pdf.
+
+ - The specification for Video entries has also been clarified. For
+ television series, the episode and series numbers go in
+ "booktitleaddon" instead of "titleaddon" and, as with Music
+ entries, the "eventdate" will hold the original broadcast date of
+ such an episode, or perhaps the recording/performance date of,
+ e.g., an opera on DVD. The "origdate" will still hold the original
+ release date of a film, and the "date" the publishing or copyright
+ date of the medium you are referencing. The earlier date, once
+ again, is the one that will appear in citations and at the head of
+ reference list entries. Please see the full documentation in
+ biblatex-chicago.pdf.
+
+ - In SuppBook entries, the Manual now requires you to provide the
+ page range (in the "pages" field) for the specific part you are
+ citing, e.g., an introduction, foreword, or afterword.
+
+ - The author-date style now prefers longer bibstrings in the list of
+ references, bringing it into line with the notes & bibliography
+ style. Generally, the package will take care of this for you, but
+ if you've been using abbreviated strings in "note" fields, for
+ example, you may want to change them so that they conform with the
+ strings the package provides. In some circumstances the \partedit
+ macro, and its relatives, may help.
+
+ - When a descriptive phrase is used as an "author," you can now omit
+ an initial definite or indefinite article, which will help with
+ alphabetization in the bibliography.
+
+ - A DOI is now preferred to a URL, if both are available.
+
+ - On the same subject, a revision date (or similar) is preferred to
+ an access date for online material. You can use the new "userd"
+ field to change the string introducing the "urldate," which
+ defaults to being an access date.
+
+ - Special imprints are now separated from their parent press by a
+ forward slash rather than a comma, so can just be added to the
+ "publisher" field with the usual keyword "and".
+
+ - The 16th edition of the Manual is less than enthusiastic about the
+ use of "Anon." as the "author," preferring instead that the "title"
+ or the "journaltitle" take its place. If you do decide to get rid
+ of "Anon.," new facilities provided by Biber -- see next entry --
+ should mean that biblatex no longer requires assistance when
+ alphabetizing such author-less entries.
+
+ - The Chicago-specific setting of the Biber-only command,
+ \DeclareSortingScheme=cms, allows non-standard fields to be
+ considered by biblatex's sorting algorithms, which should reduce
+ the instances where you need a "sortkey" or the like in your
+ entries.
+
+ - The Chicago-specific setting of the Biber-only command
+ \DeclareLabelname allows biblatex to find a name ("label") for
+ citations outside the standard name fields, including, notably, in
+ the "name[a-c]" fields. This should reduce the instances where you
+ need a "shortauthor" field to provide such a name.
+
+Other New Features:
+
+ - For reprinted books, you can now present more detailed publishing
+ information about the original edition using the new "origlocation"
+ and "origpublisher" fields. You can also use the "origlocation" in
+ Letter or Misc (with "entrysubtype") entries to identify where a
+ published or unpublished letter was written. These uses apply to
+ both Chicago styles.
+
+ - Thanks to a patch sent by Kazuo Teramoto, you can now take
+ advantage of biblatex's facilities for citing "eprint" resources.
+ There is also a new "eprint" option, set to "true" by default,
+ which controls the printing of this field in both Chicago styles.
+ You can set the option both in the preamble and in the "options"
+ field of individual entries. The field will always print in Online
+ entries.
+
+ - I have added a new citation command, \citejournal, to the notes &
+ bibliography style to allow you to present journal articles using
+ an alternative short note form, which may be a clearer form of
+ reference in certain circumstances. Such short notes will present
+ the name of the "author," the "journaltitle," and the "volume"
+ information.
+
+ - I have included a very slightly modified version of the standard
+ biblatex \citeauthor command, which may be useful for references to
+ works from classical antiquity.
+
+ - I have added a new "cmsdate=full" switch to the author-date style,
+ which only affects citations in the text, and means that a full
+ date specification will appear there, rather than just the year.
+ If you follow the Manual's recommendations concerning newspaper and
+ magazine articles only appearing in running text and not in the
+ reference list, this option will help.
+
+ - I have added a new "avdate" option to the author-date style, set to
+ "true" by default in biblatex-chicago.sty. This changes the
+ default setting of \DeclareLabelyear in Music, Review, and Video
+ entries to take account of specialized instructions in the Manual
+ for finding dates to appear in citations and at the head of
+ reference list entries. Setting "avdate=false" in the options when
+ you load biblatex-chicago restores the default settings for all
+ entry types.
+
+ - The Manual has added recommendations for citing blogs, which
+ generally will need an Article entry with "magazine"
+ "entrysubtype." You can identify a blog as such by placing "blog"
+ in the "location" field. If you want to cite a comment to a blog
+ or to other online material, the Review entry type, "entrysubtype"
+ "magazine" will serve. The "eventdate" dates the comment, and any
+ timestamp that is required can go in "nameaddon." These
+ instructions work in both styles.
+
+ - Photographs are no longer presented differently from other sorts of
+ artworks so, in effect, in both styles, the Image type is now a
+ clone of Artwork, though retained for backward compatibility.
+
+ - Following a request by Kenneth Pearce, I have added new facilities
+ for presenting "shorthands" in both Chicago styles. In both, there
+ are two new "bibenvironments" which you can set using the "env"
+ option to the \printshorthands command: "losnotes" formats the list
+ of shorthands so that it can be presented in a footnote, while
+ "losendnotes" does the same for endnotes. In both styles, there is
+ a new preamble option, "shorthandfull", which prints the full
+ bibliographical information of each entry inside the list of
+ shorthands, allowing such a list effectively to replace a
+ bibliography or list of references. In the author-date style, you
+ need to set the "cmslos=false" option as well, in order for this to
+ work. In the notes & bibliography style, I have added a new
+ citation command, \shorthandcite, which prints the "shorthand" even
+ for the first citation of a given work.
+
+ - Following suggestions by Roger Hart, I have implemented three new
+ field-exclusion options in the notes & bibliography style. In all
+ three cases, the field in question will always appear in the
+ bibliography, but not in long notes, which may help to save space.
+ The fields at stake are "addendum," "note," and "series,"
+ controlled respectively by the new "addendum", "notefield", and
+ "bookseries" options. All of these are set to "true" using the new
+ "completenotes" option in chicago-notes.cbx, but you can change the
+ settings either in the preamble or in the "options" field of
+ individual entries. Please see the documentation of these options
+ in biblatex-chicago.pdf for details on which entry types are
+ excluded from their scope.
+
+ - Thanks to a coding suggestion from Gildas Hamel, I have redefined
+ the \bibnamedash in biblatex-chicago.sty, which should now by
+ default look a little better in a wider variety of fonts.
+
+ - At the request of Baldur Kristinsson, I have added
+ \DeclareLanguageMapping commands to biblatex-chicago.sty for all
+ the languages biblatex-chicago provides. If you load the style in
+ the standard way, you no longer need to provide these mappings
+ manually yourself.
+
+ - I have improved the date handling in both styles, particularly with
+ regard to date ranges.
+
+Changes to the 15th-edition styles:
+
+ - To continue using the 15th-edition styles, for whatever reason,
+ please remember to specify either "notes15" or "authordate15" when
+ loading biblatex-chicago in your preamble.
+
+ - For reprinted books, you can now present more detailed information
+ about the original edition using the new "origlocation" and
+ "origpublisher" fields. You can also use this field in Letter or
+ Misc (with "entrysubtype") entries to give the place where a
+ published or unpublished letter was written. These uses apply to
+ both styles.
+
+ - Thanks to a patch sent by Kazuo Teramoto, you can now take
+ advantage of biblatex's facilities for citing "eprint" resources,
+ but only in the author-date style. There is also a new "eprint"
+ option, set to "true" by default, which controls the printing of
+ this field. You can set the option both in the preamble and in the
+ "options" field of individual entries. The field will always print
+ in Online entries.
+
+ - I have added a new citation command, \citejournal, to the notes &
+ bibliography style to allow you to present journal articles using
+ an alternative short note form, which may be a clearer form of
+ reference in certain circumstances. Such short notes will present
+ the name of the "author," the "journaltitle," and the "volume"
+ information.
+
+ - I have included a very slightly modified version of the standard
+ biblatex \citeauthor command, which may be useful for references to
+ works from classical antiquity.
+
+ - I have added a new "cmsdate=full" switch to the author-date style,
+ which only affects citations in the text, and means that a full
+ date specification will appear there, rather than just the year.
+ If you follow the Manual's recommendations concerning newspaper and
+ magazine articles only appearing in running text and not in the
+ reference list, this option will help.
+
+ - I have provided a new option, "headline", which turns off the
+ automatic transformations that produce sentence-style
+ capitalization in the title fields of the author-date style. If
+ you set this option, the word case in your title fields will not be
+ changed in any way, that is, this doesn't automatically transform
+ your titles into headline-style, but rather allows the .bib file to
+ determine capitalization.
+
+ - Following a request by Kenneth Pearce, I have added new facilities
+ for presenting "shorthands" in the author-date style. There are
+ two new "bibenvironments" which you can set using the "env" option
+ to the \printshorthands command: "losnotes" formats the list of
+ shorthands so that it can be presented in a footnote, while
+ "losendnotes" does the same for endnotes. There is also a new
+ preamble option, "shorthandfull", which prints the full
+ bibliographical information of each entry inside the list of
+ shorthands, allowing such a list effectively to replace a list of
+ references. You need to set the "cmslos=false" option as well in
+ order for this to work.
+
+ - Thanks to a coding suggestion from Gildas Hamel, I have redefined
+ the \bibnamedash in biblatex-chicago.sty, which should now by
+ default look a little better in a wider variety of fonts.
+
+ - At the request of Baldur Kristinsson, I have added
+ \DeclareLanguageMapping commands to biblatex-chicago.sty for all
+ the languages biblatex-chicago provides. If you load the style in
+ the standard way, you no longer need to provide these mappings
+ manually yourself.
+
+ - I have improved the date handling in both styles, particularly with
+ regard to date ranges.
+
Release notes for version 0.9.8d [2011-11-15]:
- Some minor fixes to both styles for compatibility with biblatex