biblatex-chicago (7jun16)

git-svn-id: svn://tug.org/texlive/trunk@41351 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 149 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
index 24205eacfb2..1be42fb3ba6 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
+++ b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE
@@ -1,3 +1,152 @@
+Release notes for version 1.0rc1 [2016-06-07]:
+
+ - The 15th-edition styles are now obsolete, and have been moved to a
+   new obsolete/ subdirectory.  You can still use them as they stand,
+   but they won't compile against the newest biblatex, so you'll have
+   to make sure that you have an older version (2.9a, perhaps).  If
+   you are still using them, I strongly urge you to consider switching
+   to the the 16th-edition styles, which contain many new features and
+   bug-fixes.
+
+ - The old Chicago-specific option "usecompiler" is deprecated, and
+   has been replaced by the standard biblatex "usenamec".  If you have
+   been using the former in your preamble or in your .bib entries,
+   please replace it with the latter, which works better across the
+   board.  "Usecompiler" still "works," just not very well.
+
+ - Stefan Björk has very generously provided a Swedish localization
+   file for the package -- cms-swedish.lbx -- which can be loaded and
+   used with babel just like the other localizations.
+
+ - I have added support for "related" functionality to all the Chicago
+   styles, including all the standard biblatex "relatedtypes".  It is
+   turned on by default in all styles, but you can turn it off, or
+   alter where the information is printed, using the "related" option
+   in the preamble or in individual entries.  In the notes &
+   bibliography style, "related" information is printed by default
+   only in the bibliography, but you can change that by setting the
+   option.  In the author-date styles, it will only ever print in the
+   list of references, depending on the option's setting.  Please see
+   sections 4.2.1 and 5.2.1 of biblatex-chicago.pdf for the details.
+
+ - I have improved the name-handling code in all styles, regularizing
+   the functioning of the "namea", "nameb", and "namec" fields with
+   respect to the other, standard biblatex names.  The former two in
+   particular are newly available in the Collection and Periodical
+   entry types, and biblatex-chicago now recognizes the standard
+   "usenamea", "usenameb", and "usenamec" toggles, the last replacing
+   the deprecated "usecompiler" (as above).  You can also now use the
+   "nameatype" field just as you would an "editortype", extending the
+   possibilities for identifying certain roles attached specifically
+   to "titles" as opposed to "booktitles" or "maintitles".
+
+ - After a request by user BenVB, I have added support for the
+   biblatex "shortjournal" field, which allows you to present
+   abbreviated "journaltitles" in all the styles.  You can use the
+   "journalabbrev" option to control where in your document these
+   abbreviated forms will appear.  By default, the field is ignored in
+   the notes & bibliography style, and appears only in citations in
+   the author-date styles.  You can also print a list of journal
+   abbreviations, rather in the manner of a list of shorthands, using
+   a command like: \printbiblist{shortjournal}.  Even though the
+   Periodical entry type uses the "title" and "shorttitle" fields in
+   place of "journaltitle" and "shortjournal", these entries are
+   included in this functionality, and controlled by the same
+   "journalabbrev" option.  Please see s.v. "shortjournal" in sections
+   4.2 and 5.2 of biblatex-chicago.pdf.
+
+ - Following a request by Arne Skjærholt, and his generous provision
+   of some code to get me started, I have implemented a new
+   \gentextcite citation command in all styles.  The "gen" part of the
+   name refers to the genitive case, and it adds a possessive ending
+   -- 's by default -- to the author's name in what is otherwise an
+   ordinary \textcite.  You can change the added ending however you
+   want, using a third optional field to the citation command, and you
+   can control to which names the ending is added in a \gentextcites
+   multicite command by using the "genallnames" preamble and entry
+   option.  Please see sections 4.3.2 and 5.3.2 for the details.
+
+ - Stefan Björk pointed out that "url", "doi", and "eprint"
+   information could be totally ignored in some entries when you used
+   the abbreviated cross-referencing functionality accessed through
+   the "crossref" and "xref" fields.  At his request, I have provided
+   a new "xrefurl" entry and preamble option for all the styles to
+   control the printing of this information in abbreviated notes or
+   bibliography (reference list) entries.  Please see sections 4.4.3
+   and 5.4.3 for the details.
+
+ - In a related change, I have stopped child entries inheriting "url",
+   "doi", and "eprint" fields from their cross-ref'd parents, so if
+   your documents rely on this behavior please note that you'll have
+   to provide such fields manually in the child entries.
+
+ - Roger Hart long ago requested a way to control the punctuation
+   before "book-", "main-", or plain "titleaddon" fields, and I have
+   finally added it in this release in the form of two entry and
+   preamble options, "ptitleaddon" and "ctitleaddon", available in all
+   styles.  By default, the former prints \addperiod\addspace, hence
+   its name, and the latter \addcomma\addspace, but you can change
+   either or both depending on which field you are using and which
+   sort of entry it appears in -- the default output can be your guide
+   to which option(s) to change.  Please see the available valid
+   option keys in sections 4.4.2 and 5.4.2.
+
+ - The same user also long ago requested that the notes & bibliography
+   style make it possible to use "Idem" when two consecutive notes
+   cite different works by the same author.  You can now use the
+   standard biblatex option "idemtracker=constrict" in your preamble
+   to activate this in your documents, but please be aware, first,
+   that the Manual doesn't exactly approve of this and, second, that
+   you'll only see "Idem" in short notes, never in full ones, which
+   seems to be the standard biblatex way of implementing this.
+
+ - Also only in the notes & bibliography style, I have added a
+   "shorthandpunct" option to control the punctuation that appears
+   before the first appearance of a "shorthand" and/or a
+   "shorthandintro" in a long note.  The default is \addspace, but you
+   can change it in your preamble or in individual entries.  Please
+   see the available valid option keys in section 4.4.2 of
+   biblatex-chicago.pdf.
+
+ - After reading a discussion started by Ryo Furue at github, I have
+   added, in the author-date styles only, a test to some spacing
+   commands to prevent line breaks immediately after abbreviation
+   dots.  These tests apply only in running text, never in the list of
+   references, where good line breaks are already hard enough to find.
+
+ - In addition to moving the 15th-edition styles into an obsolete/
+   subdirectory, I have also reorganized the author-date style files,
+   adding chicago-dates-common.cbx, which contains the code that is
+   common to the "trad" and the standard "authordate" styles.  Nothing
+   has changed in terms of loading the styles, the changes being
+   designed primarily to ease maintenance.
+
+ - I have created two new documentation files (and an appendix) to
+   provide short introductions to the Chicago styles, introductions
+   which attempt to fill the gap between the Quickstart section of
+   biblatex-chicago.pdf and the fuller documentation contained in
+   sections 4 and 5 of that file.  Both cms-notes-intro.pdf and
+   cms-dates-intro.pdf are fully hyperlinked so you can move easily
+   from formatted citations and (annotated) references to .bib entries
+   and back, with marginal references to the fuller discussions in
+   biblatex-chicago.pdf.  There is also a short cms-trad-appendix.pdf
+   file to discuss a few entries that would need special treatment for
+   the "trad" style.  The sample files for each style still exist, but
+   I intend them mainly for testing purposes, while many more
+   (annotated) entries are still available for consultation in
+   notes-test.bib and dates-test.bib.
+
+ - I have made a number of other small enhancements to and fixed
+   numerous bugs in all the styles, including some subtle inaccuracies
+   in author-date citations spotted by Arne Skjærholt and some macros
+   in InProceedings entries that had been missing for years.  I have
+   provided some default values for counters in biblatex-chicago.sty
+   that aid in breaking long urls across lines, but I make no pretense
+   that these fully adhere to the Manual's specifications.  I have
+   added a few \bibstrings, currently missing in standard biblatex, to
+   cms-german.lbx for use with the "related" functionality.
+   Recommendations for better ones would be gratefully received.
+
 Release notes for version 0.9.9i [2016-05-16]:
 
  - This is another interim release, allowing the use of biblatex 3.4