diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex/RELEASE')
| -rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/RELEASE | 208 |
1 files changed, 206 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex/RELEASE b/Master/texmf-dist/doc/latex/biblatex/RELEASE index f38fbf589b2..398f4911f33 100644 --- a/Master/texmf-dist/doc/latex/biblatex/RELEASE +++ b/Master/texmf-dist/doc/latex/biblatex/RELEASE @@ -1,4 +1,208 @@ -$Id: RELEASE,v 0.9 2010/02/14 15:42:33 lehman beta $ +$Id: RELEASE,v 0.9a 2010/03/19 19:52:15 lehman beta $ + +RELEASE NOTES FOR VERSION 0.9a + +This release adds a few changes and improvements which were +originally scheduled for biblatex 0.9 but somehow got lost in the +release process or didn't make it in time. Pay attention to all +changes tagged as "CAVEAT". + +* [CAVEAT] Prenote placement with \cite, \textcite [numeric/alphabetic] + + The placement of the prenote in all numeric and alphabetic styles + has been modified. + + Old format: + + \cite[see][15]{key} -> see [1, p. 15] + \parencite[see][15]{key} -> [see 1, p. 15] + \textcite[see][15]{key} -> see Doe [1, p. 15] + + New format: + + \cite[see][15]{key} -> [see 1, p. 15] + \parencite[see][15]{key} -> [see 1, p. 15] + \textcite[see][15]{key} -> Doe [see 1, p. 15] + + As seen in the above examples, the new format places the prenote + inside the brackets. If you want the prenote outside of the + brackets, you can simply use: + + see \cite[15]{key} -> see [1, p. 15] + see \textcite[15]{key} -> see Doe [1, p. 15] + + which is similar to the old format. + +* [CAVEAT] Prenote placement with \textcite [authoryear/authortitle] + + The placement of the prenote in all authoryear and authortitle + styles has also been modified. + + Old format: + + \cite[see][15]{key} -> see Doe 2010, p. 15 + \parencite[see][15]{key} -> (see Doe 2010, p. 15) + \textcite[see][15]{key} -> see Doe (2010, p. 15) + + New format: + + \cite[see][15]{key} -> see Doe 2010, p. 15 + \parencite[see][15]{key} -> (see Doe 2010, p. 15) + \textcite[see][15]{key} -> Doe (see 2010, p. 15) + + The new format places the prenote inside the brackets. If you + want the prenote outside of the brackets, you can simply use: + + see \textcite[15]{key} -> see Doe (2010, p. 15) + + which is similar to the old format. + +* [CAVEAT] Introducing \defbibenvironment + + I'm phasing out the thebibliography/theshorthands environments + and the corresponding commands \thebibitem and \thelositem. + Essentially, the old way of controlling the (high-level) layout + of the bibliography and the list of shorthands is replaced by a + new mechanism based on \defbibenvironment. It's not radically + different. For example, where a style has code like this: + + \renewenvironment*{thebibliography} + {\list{}{...}} + {\endlist} + \renewcommand*{\thebibitem}{\item} + + \renewenvironment*{theshorthands} + {\list{}{...}} + {\endlist} + \renewcommand*{\thelositem}{\item} + + replace it with: + + \defbibenvironment{bibliography} + {\list{}{...}} + {\endlist} + {\item} + + \defbibenvironment{shorthands} + {\list{}{...}} + {\endlist} + {\item} + + The new system is similar to \defbibheading: you use + \defbibenvironment to define the environment and the new 'env' + option of \printbibliography and \printshorthands to select it. + The point of the new system is that you can have different styles + for different (partial) bibliographies in a document. It's also + conceptually in line with \defbibheading now. + + I've added some compatibility code to biblatex. Older styles + using thebibliography/thebibitem and theshorthands/thelositem + will continue to work until you use \defbibenvironment for the + first time to modify the default definition. From that point on, + the old environment will be ignored. + + Updating old styles is of course highly recommended. The + compatibility code may be removed from biblatex after 1.0. The + standard styles have been updated to use the new syntax. They + will ignore any changes based on the old definitions. + +* Added \printbibheading + + \printbibheading is the heading part of \printbibliography. This + is useful for subdivided bibliographies. E.g., instead of + + \chapter{\bibname} + \printbibliography[heading=subbibliography,type={...},...] + \printbibliography[heading=subbibliography,type={...},...] + ... + + you use: + + \printbibheading % = \printbibheading[heading=bibliography] + \printbibliography[heading=subbibliography,type={...},...] + \printbibliography[heading=subbibliography,type={...},...] + ... + + The point is that the overall heading is in sync with the + subheadings. + +* Smart parentheses and brackets + + This release adds a new 'parenthesis tracker', i.e., if + parentheses and/or brackets are nested, biblatex alternates + between parentheses and brackets, depending on the nesting level. + E.g.: + + \mkbibparens{text \mkbibparens{text} text} + \mkbibbrackets{text \mkbibbrackets{text} text} + + yields + + (text [text] text) + [text (text) text] + + This also works with \bibopenparen + \bibcloseparen and + \bibopenbracket + \bibclosebracket as well as the new citation + commands \parentext and \brackettexts. + +* Open ended date ranges + + There's one thing I forgot to mention when introducing the new + date fields in the previous release. It is possible to specify an + open ended range by leaving the end date blank: + + 1988/1992 = 1988-1992 + 1988/ = 1988-today + 1988 = 1988 + + Open ended ranges are represented by a defined but empty + "endyear" component on the level of the style interface: + + date = {1988} -> day = undefined + month = undefined + year = "1988" + endday = undefined + endmonth = undefined + endyear = undefined + + date = {1988/} -> day = undefined + month = undefined + year = "1988" + endday = undefined + endmonth = undefined + endyear = EMPTY + + date = {1988/1992} -> day = undefined + month = undefined + year = "1988" + endday = undefined + endmonth = undefined + endyear = "1992" + + All high-level date commands like \printdate detect and handle + open ended ranges autoamtically. Use + + \iffieldequalstr{endyear}{} + {true} + {false} + + if you want to test for open ended ranges explicitly. + +* Extended language support: Finnish + + This release comes with a finnish.lbx file. The translations + have been contributed by Hannu V\"ais\"anen. + +* Updated language support: Greek + + This release comes with an updated greek.lbx file contributed + by biblatex user Prokopis. + +* Updated examples, some updates in the manual + + Some of the examples which ship with biblatex were not completely + up to date in the 0.9 release. They have been updated now. I've + also corrected/added a few minor points in the manual. RELEASE NOTES FOR VERSION 0.9 @@ -12,7 +216,7 @@ styles once. This release finally takes that step. In other words: Style authors will most likely need to update their styles to make them work with this release. You will find detailed hints about what needs to be updated in the release notes below. Changes which raise -backwards compatibility issues are tagged as "caveat". Users who +backwards compatibility issues are tagged as "CAVEAT". Users who rely on styles found in: macros/latex/exptl/biblatex-contrib/ |