diff options
author | Karl Berry <karl@freefriends.org> | 2012-07-11 23:30:43 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-07-11 23:30:43 +0000 |
commit | 562ae685591240b0ea768aa3de044339bcaee64e (patch) | |
tree | fe67bf362ccf70a9434b3a4ed2760af84eaa42ab /Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE | |
parent | 6d1e02f252c44d2e43c13d9d0608e628812a8a90 (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/RELEASE | 373 |
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 |