texlive[66481] branches/branch2022.final/Master/texmf-dist:
commits+karl at tug.org
commits+karl at tug.org
Wed Mar 8 22:39:33 CET 2023
Revision: 66481
http://tug.org/svn/texlive?view=revision&revision=66481
Author: karl
Date: 2023-03-08 22:39:33 +0100 (Wed, 08 Mar 2023)
Log Message:
-----------
biblatex-ms (8mar23) (branch)
Modified Paths:
--------------
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/biblatex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/biblatex-ms.tex
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/02-annotations-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/02-annotations-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/03-localization-keys-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/03-localization-keys-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/16-numeric-prefixed-1-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/16-numeric-prefixed-1-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/17-numeric-prefixed-2-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/17-numeric-prefixed-2-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/19-alphabetic-prefixed-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/19-alphabetic-prefixed-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/20-indexing-single-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/20-indexing-single-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/21-indexing-multiple-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/21-indexing-multiple-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/40-style-alphabetic-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/40-style-alphabetic-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/50-style-authoryear-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/50-style-authoryear-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/60-style-authortitle-biber-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/60-style-authortitle-bibtex-ms.pdf
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/91-sorting-schemes-ms.tex
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/98-multiscript-ms.tex
branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/biblatex-ms.sty
branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/lbx/lithuanian-ms.lbx
Added Paths:
-----------
branches/branch2022.final/Master/texmf-dist/bibtex/bib/biblatex-ms/
branches/branch2022.final/Master/texmf-dist/bibtex/bib/biblatex-ms/biblatex/
branches/branch2022.final/Master/texmf-dist/bibtex/bib/biblatex-ms/biblatex/biblatex-examples-ms.bib
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES.md
Removed Paths:
-------------
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES-ms.md
branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/bibtex/bib/biblatex/
Added: branches/branch2022.final/Master/texmf-dist/bibtex/bib/biblatex-ms/biblatex/biblatex-examples-ms.bib
===================================================================
--- branches/branch2022.final/Master/texmf-dist/bibtex/bib/biblatex-ms/biblatex/biblatex-examples-ms.bib (rev 0)
+++ branches/branch2022.final/Master/texmf-dist/bibtex/bib/biblatex-ms/biblatex/biblatex-examples-ms.bib 2023-03-08 21:39:33 UTC (rev 66481)
@@ -0,0 +1,1661 @@
+ at string{anch-ie = {Angew.~Chem. Int.~Ed.}}
+ at string{cup = {Cambridge University Press}}
+ at string{dtv = {Deutscher Taschenbuch-Verlag}}
+ at string{hup = {Harvard University Press}}
+ at string{jams = {J.~Amer. Math. Soc.}}
+ at string{jchph = {J.~Chem. Phys.}}
+ at string{jomch = {J.~Organomet. Chem.}}
+ at string{pup = {Princeton University Press}}
+
+ at incollection{westfahl:space,
+ author = {Westfahl, Gary},
+ title = {The True Frontier},
+ subtitle = {Confronting and Avoiding the Realities of Space in {American}
+ Science Fiction Films},
+ pages = {55-65},
+ crossref = {westfahl:frontier},
+ langid = {english},
+ langidopts = {variant=american},
+ indextitle = {True Frontier, The},
+ annotation = {A cross-referenced article from a \texttt{collection}. This is
+ an \texttt{incollection} entry with a \texttt{crossref}
+ field. Note the \texttt{subtitle} and \texttt{indextitle}
+ fields},
+}
+
+ at set{set,
+ entryset = {herrmann,aksin,yoon},
+ annotation = {A \texttt{set} with three members.},
+}
+
+ at set{stdmodel,
+ entryset = {glashow,weinberg,salam},
+ annotation = {A \texttt{set} with three members discussing the standard
+ model of particle physics.},
+}
+
+ at article{aksin,
+ author = {Aks{\i}n, {\"O}zge and T{\"u}rkmen, Hayati and Artok, Levent
+ and {\c{C}}etinkaya, Bekir and Ni, Chaoying and
+ B{\"u}y{\"u}kg{\"u}ng{\"o}r, Orhan and {\"O}zkal, Erhan},
+ title = {Effect of immobilization on catalytic characteristics of
+ saturated {Pd-N}-heterocyclic carbenes in {Mizoroki-Heck}
+ reactions},
+ journaltitle = jomch,
+ date = 2006,
+ volume = 691,
+ number = 13,
+ pages = {3027-3036},
+ indextitle = {Effect of immobilization on catalytic characteristics},
+}
+
+ at article{angenendt,
+ author = {Angenendt, Arnold},
+ title = {In Honore Salvatoris~-- Vom Sinn und Unsinn der
+ Patrozinienkunde},
+ journaltitle = {Revue d'Histoire Eccl{\'e}siastique},
+ date = 2002,
+ volume = 97,
+ pages = {431--456, 791--823},
+ langid = {german},
+ indextitle = {In Honore Salvatoris},
+ shorttitle = {In Honore Salvatoris},
+ annotation = {A German article in a French journal. Apart from that, a
+ typical \texttt{article} entry. Note the \texttt{indextitle}
+ field},
+}
+
+ at article{baez/article,
+ author = {Baez, John C. and Lauda, Aaron D.},
+ title = {Higher-Dimensional Algebra {V}: 2-Groups},
+ journaltitle = {Theory and Applications of Categories},
+ date = 2004,
+ volume = 12,
+ pages = {423-491},
+ version = 3,
+ eprint = {math/0307200v3},
+ eprinttype = {arxiv},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {An \texttt{article} with \texttt{eprint} and
+ \texttt{eprinttype} fields. Note that the arXiv reference is
+ transformed into a clickable link if \texttt{hyperref} support
+ has been enabled. Compare \texttt{baez\slash online}, which
+ is the same item given as an \texttt{online} entry},
+}
+
+ at article{bertram,
+ author = {Bertram, Aaron and Wentworth, Richard},
+ title = {Gromov invariants for holomorphic maps on {Riemann} surfaces},
+ journaltitle = jams,
+ date = 1996,
+ volume = 9,
+ number = 2,
+ pages = {529-571},
+ langid = {english},
+ langidopts = {variant=american},
+ shorttitle = {Gromov invariants},
+ annotation = {An \texttt{article} entry with a \texttt{volume} and a
+ \texttt{number} field},
+}
+
+ at article{doody,
+ author = {Doody, Terrence},
+ title = {Hemingway's Style and {Jake's} Narration},
+ year = 1974,
+ volume = 4,
+ number = 3,
+ pages = {212-225},
+ langid = {english},
+ langidopts = {variant=american},
+ related = {matuz:doody},
+ relatedstring= {\autocap{e}xcerpt in},
+ journal = {The Journal of Narrative Technique},
+ annotation = {An \texttt{article} entry cited as an excerpt from a
+ \texttt{collection} entry. Note the format of the
+ \texttt{related} and \texttt{relatedstring} fields},
+}
+
+ at collection{matuz:doody,
+ editor = {Matuz, Roger},
+ title = {Contemporary Literary Criticism},
+ year = 1990,
+ volume = 61,
+ publisher = {Gale},
+ location = {Detroit},
+ pages = {204-208},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {A \texttt{collection} entry providing the excerpt information
+ for the \texttt{doody} entry. Note the format of the
+ \texttt{pages} field},
+}
+
+ at article{gillies,
+ author = {Gillies, Alexander},
+ title = {Herder and the Preparation of {Goethe's} Idea of World
+ Literature},
+ journaltitle = {Publications of the English Goethe Society},
+ date = 1933,
+ series = {newseries},
+ volume = 9,
+ pages = {46-67},
+ langid = {english},
+ langidopts = {variant=british},
+ annotation = {An \texttt{article} entry with a \texttt{series} and a
+ \texttt{volume} field. Note that format of the \texttt{series}
+ field in the database file},
+}
+
+ at article{glashow,
+ author = {Glashow, Sheldon},
+ title = {Partial Symmetries of Weak Interactions},
+ journaltitle = {Nucl.~Phys.},
+ date = 1961,
+ volume = 22,
+ pages = {579-588},
+}
+
+ at article{herrmann,
+ author = {Herrmann, Wolfgang A. and {\"O}fele, Karl and Schneider,
+ Sabine K. and Herdtweck, Eberhardt and Hoffmann, Stephan D.},
+ title = {A carbocyclic carbene as an efficient catalyst ligand for {C--C}
+ coupling reactions},
+ journaltitle = anch-ie,
+ date = 2006,
+ volume = 45,
+ number = 23,
+ pages = {3859-3862},
+ indextitle = {Carbocyclic carbene as an efficient catalyst, A},
+}
+
+ at article{kastenholz,
+ author = {Kastenholz, M. A. and H{\"u}nenberger, Philippe H.},
+ title = {Computation of methodology\hyphen independent ionic solvation
+ free energies from molecular simulations},
+ journaltitle = jchph,
+ date = 2006,
+ subtitle = {{I}. {The} electrostatic potential in molecular liquids},
+ volume = 124,
+ eid = 124106,
+ doi = {10.1063/1.2172593},
+ langid = {english},
+ langidopts = {variant=american},
+ indextitle = {Computation of ionic solvation free energies},
+ annotation = {An \texttt{article} entry with an \texttt{eid} and a
+ \texttt{doi} field. Note that the \textsc{doi} is transformed
+ into a clickable link if \texttt{hyperref} support has been
+ enabled},
+ abstract = {The computation of ionic solvation free energies from
+ atomistic simulations is a surprisingly difficult problem that
+ has found no satisfactory solution for more than 15 years. The
+ reason is that the charging free energies evaluated from such
+ simulations are affected by very large errors. One of these is
+ related to the choice of a specific convention for summing up
+ the contributions of solvent charges to the electrostatic
+ potential in the ionic cavity, namely, on the basis of point
+ charges within entire solvent molecules (M scheme) or on the
+ basis of individual point charges (P scheme). The use of an
+ inappropriate convention may lead to a charge-independent
+ offset in the calculated potential, which depends on the
+ details of the summation scheme, on the quadrupole-moment
+ trace of the solvent molecule, and on the approximate form
+ used to represent electrostatic interactions in the
+ system. However, whether the M or P scheme (if any) represents
+ the appropriate convention is still a matter of on-going
+ debate. The goal of the present article is to settle this
+ long-standing controversy by carefully analyzing (both
+ analytically and numerically) the properties of the
+ electrostatic potential in molecular liquids (and inside
+ cavities within them).},
+}
+
+ at article{murray,
+ author = {Hostetler, Michael J. and Wingate, Julia E. and Zhong,
+ Chuan-Jian and Harris, Jay E. and Vachet, Richard W. and
+ Clark, Michael R. and Londono, J. David and Green, Stephen
+ J. and Stokes, Jennifer J. and Wignall, George D. and Glish,
+ Gary L. and Porter, Marc D. and Evans, Neal D. and Murray,
+ Royce W.},
+ title = {Alkanethiolate gold cluster molecules with core diameters from
+ 1.5 to 5.2~{nm}},
+ journaltitle = {Langmuir},
+ date = 1998,
+ subtitle = {Core and monolayer properties as a function of core size},
+ volume = 14,
+ number = 1,
+ pages = {17-30},
+ langid = {english},
+ langidopts = {variant=american},
+ indextitle = {Alkanethiolate gold cluster molecules},
+ shorttitle = {Alkanethiolate gold cluster molecules},
+ annotation = {An \texttt{article} entry with \arabic{author} authors. By
+ default, long author and editor lists are automatically
+ truncated. This is configurable},
+}
+
+ at article{reese,
+ author = {Reese, Trevor R.},
+ title = {Georgia in {Anglo-Spanish} Diplomacy, 1736--1739},
+ journaltitle = {William and Mary Quarterly},
+ date = 1958,
+ series = 3,
+ volume = 15,
+ pages = {168-190},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {An \texttt{article} entry with a \texttt{series} and a
+ \texttt{volume} field. Note the format of the series. If the
+ value of the \texttt{series} field is an integer, this number
+ is printed as an ordinal and the string \enquote*{series} is
+ appended automatically},
+}
+
+ at article{sarfraz,
+ author = {M. Sarfraz and M. F. A. Razzak},
+ title = {Technical section: {An} algorithm for automatic capturing of
+ the font outlines},
+ year = 2002,
+ volume = 26,
+ number = 5,
+ pages = {795-804},
+ issn = {0097-8493},
+ journal = {Computers and Graphics},
+ annotation = {An \texttt{article} entry with an \texttt{issn} field},
+}
+
+ at article{shore,
+ author = {Shore, Bradd},
+ title = {Twice-Born, Once Conceived},
+ journaltitle = {American Anthropologist},
+ date = {1991-03},
+ subtitle = {Meaning Construction and Cultural Cognition},
+ series = {newseries},
+ volume = 93,
+ number = 1,
+ pages = {9-27},
+ annotation = {An \texttt{article} entry with \texttt{series},
+ \texttt{volume}, and \texttt{number} fields. Note the format
+ of the \texttt{series} which is a localization key},
+}
+
+ at article{sigfridsson,
+ author = {Sigfridsson, Emma and Ryde, Ulf},
+ title = {Comparison of methods for deriving atomic charges from the
+ electrostatic potential and moments},
+ journaltitle = {Journal of Computational Chemistry},
+ date = 1998,
+ volume = 19,
+ number = 4,
+ pages = {377-395},
+ doi = {10.1002/(SICI)1096-987X(199803)19:4<377::AID-JCC1>3.0.CO;2-P},
+ langid = {english},
+ langidopts = {variant=american},
+ indextitle = {Methods for deriving atomic charges},
+ annotation = {An \texttt{article} entry with \texttt{volume},
+ \texttt{number}, and \texttt{doi} fields. Note that the
+ \textsc{doi} is transformed into a clickable link if
+ \texttt{hyperref} support has been enabled},
+ abstract = {Four methods for deriving partial atomic charges from the
+ quantum chemical electrostatic potential (CHELP, CHELPG,
+ Merz-Kollman, and RESP) have been compared and critically
+ evaluated. It is shown that charges strongly depend on how and
+ where the potential points are selected. Two alternative
+ methods are suggested to avoid the arbitrariness in the
+ point-selection schemes and van der Waals exclusion radii:
+ CHELP-BOW, which also estimates the charges from the
+ electrostatic potential, but with potential points that are
+ Boltzmann-weighted after their occurrence in actual
+ simulations using the energy function of the program in which
+ the charges will be used, and CHELMO, which estimates the
+ charges directly from the electrostatic multipole
+ moments. Different criteria for the quality of the charges are
+ discussed.},
+}
+
+ at article{spiegelberg,
+ author = {Spiegelberg, Herbert},
+ title = {\mkbibquote{Intention} und \mkbibquote{Intentionalit{\"a}t} in
+ der Scholastik, bei Brentano und Husserl},
+ journaltitle = {Studia Philosophica},
+ date = 1969,
+ volume = 29,
+ pages = {189-216},
+ langid = {german},
+ sorttitle = {Intention und Intentionalitat in der Scholastik, bei Brentano
+ und Husserl},
+ indexsorttitle= {Intention und Intentionalitat in der Scholastik, bei Brentano
+ und Husserl},
+ shorttitle = {Intention und Intentionalit{\"a}t},
+ annotation = {An \texttt{article} entry. Note the \texttt{sorttitle} and
+ \texttt{indexsorttitle} fields and the markup of the quotes in
+ the database file},
+}
+
+ at article{springer,
+ author = {Springer, Otto},
+ title = {Mediaeval Pilgrim Routes from {Scandinavia} to {Rome}},
+ journaltitle = {Mediaeval Studies},
+ date = 1950,
+ volume = 12,
+ pages = {92-122},
+ langid = {english},
+ langidopts = {variant=british},
+ shorttitle = {Mediaeval Pilgrim Routes},
+ annotation = {A plain \texttt{article} entry},
+}
+
+ at article{weinberg,
+ author = {Weinberg, Steven},
+ title = {A Model of Leptons},
+ journaltitle = {Phys.~Rev.~Lett.},
+ date = 1967,
+ volume = 19,
+ pages = {1264-1266},
+}
+
+ at article{yoon,
+ author = {Yoon, Myeong S. and Ryu, Dowook and Kim, Jeongryul and Ahn,
+ Kyo Han},
+ title = {Palladium pincer complexes with reduced bond angle strain:
+ efficient catalysts for the {Heck} reaction},
+ journaltitle = {Organometallics},
+ date = 2006,
+ volume = 25,
+ number = 10,
+ pages = {2409-2411},
+ indextitle = {Palladium pincer complexes},
+}
+
+ at book{aristotle:anima,
+ author = {Aristotle},
+ title = {De Anima},
+ date = 1907,
+ editor = {Hicks, Robert Drew},
+ publisher = cup,
+ location = {Cambridge},
+ keywords = {primary},
+ langid = {english},
+ langidopts = {variant=british},
+ annotation = {A \texttt{book} entry with an \texttt{author} and an
+ \texttt{editor}},
+}
+
+ at book{aristotle:physics,
+ author = {Aristotle},
+ title = {Physics},
+ date = 1929,
+ translator = {Wicksteed, P. H. and Cornford, F. M.},
+ publisher = {G. P. Putnam},
+ location = {New York},
+ keywords = {primary},
+ langid = {english},
+ langidopts = {variant=american},
+ shorttitle = {Physics},
+ annotation = {A \texttt{book} entry with a \texttt{translator} field},
+}
+
+ at book{aristotle:poetics,
+ author = {Aristotle},
+ title = {Poetics},
+ date = 1968,
+ editor = {Lucas, D. W.},
+ series = {Clarendon {Aristotle}},
+ publisher = {Clarendon Press},
+ location = {Oxford},
+ keywords = {primary},
+ langid = {english},
+ langidopts = {variant=british},
+ shorttitle = {Poetics},
+ annotation = {A \texttt{book} entry with an \texttt{author} and an
+ \texttt{editor} as well as a \texttt{series} field},
+}
+
+ at mvbook{aristotle:rhetoric,
+ author = {Aristotle},
+ title = {The Rhetoric of {Aristotle} with a commentary by the late {Edward
+ Meredith Cope}},
+ date = 1877,
+ editor = {Cope, Edward Meredith},
+ commentator = {Cope, Edward Meredith},
+ volumes = 3,
+ publisher = cup,
+ keywords = {primary},
+ langid = {english},
+ langidopts = {variant=british},
+ sorttitle = {Rhetoric of Aristotle},
+ indextitle = {Rhetoric of {Aristotle}, The},
+ shorttitle = {Rhetoric},
+ annotation = {A commented edition. Note the concatenation of the
+ \texttt{editor} and \texttt{commentator} fields as well as the
+ \texttt{volumes}, \texttt{sorttitle}, and \texttt{indextitle}
+ fields},
+}
+
+ at book{augustine,
+ author = {Augustine, Robert L.},
+ title = {Heterogeneous catalysis for the synthetic chemist},
+ date = 1995,
+ publisher = {Marcel Dekker},
+ location = {New York},
+ langid = {english},
+ langidopts = {variant=american},
+ shorttitle = {Heterogeneous catalysis},
+ annotation = {A plain \texttt{book} entry},
+}
+
+ at book{averroes/bland,
+ author = {Averroes},
+ title = {The Epistle on the Possibility of Conjunction with the Active
+ Intellect by {Ibn Rushd} with the Commentary of {Moses Narboni}},
+ date = 1982,
+ editor = {Bland, Kalman P.},
+ translator = {Bland, Kalman P.},
+ series = {Moreshet: Studies in {Jewish} History, Literature and Thought},
+ number = 7,
+ publisher = {Jewish Theological Seminary of America},
+ location = {New York},
+ keywords = {primary},
+ langid = {english},
+ langidopts = {variant=american},
+ indextitle = {Epistle on the Possibility of Conjunction, The},
+ shorttitle = {Possibility of Conjunction},
+ annotation = {A \texttt{book} entry with a \texttt{series} and a
+ \texttt{number}. Note the concatenation of the \texttt{editor}
+ and \texttt{translator} fields as well as the
+ \texttt{indextitle} field},
+}
+
+ at book{averroes/hannes,
+ author = {Averroes},
+ title = {Des Averro{\"e}s Abhandlung: \mkbibquote{{\"U}ber die
+ M{\"o}glichkeit der Conjunktion} oder \mkbibquote{{\"U}ber den
+ materiellen Intellekt}},
+ date = 1892,
+ editor = {Hannes, Ludwig},
+ translator = {Hannes, Ludwig},
+ annotator = {Hannes, Ludwig},
+ publisher = {C.~A. Kaemmerer},
+ location = {Halle an der Saale},
+ keywords = {primary},
+ langid = {german},
+ sorttitle = {Uber die Moglichkeit der Conjunktion},
+ indexsorttitle= {Uber die Moglichkeit der Conjunktion},
+ indextitle = {{\"U}ber die M{\"o}glichkeit der Conjunktion},
+ shorttitle = {{\"U}ber die M{\"o}glichkeit der Conjunktion},
+ annotation = {An annotated edition. Note the concatenation of the
+ \texttt{editor}, \texttt{translator}, and \texttt{annotator}
+ fields. Also note the \texttt{shorttitle},
+ \texttt{indextitle}, \texttt{sorttitle}, and
+ \texttt{indexsorttitle} fields},
+}
+
+ at book{averroes/hercz,
+ author = {Averroes},
+ title = {Drei Abhandlungen {\"u}ber die Conjunction des separaten
+ Intellects mit dem Menschen},
+ date = 1869,
+ editor = {Hercz, J.},
+ translator = {Hercz, J.},
+ publisher = {S.~Hermann},
+ location = {Berlin},
+ keywords = {primary},
+ langid = {german},
+ indexsorttitle= {Drei Abhandlungen uber die Conjunction},
+ indextitle = {Drei Abhandlungen {\"u}ber die Conjunction},
+ subtitle = {Von Averroes (Vater und Sohn), aus dem Arabischen
+ {\"u}bersetzt von Samuel Ibn Tibbon},
+ shorttitle = {Drei Abhandlungen},
+ annotation = {A \texttt{book} entry. Note the concatenation of the
+ \texttt{editor} and \texttt{translator} fields as well as the
+ \texttt{indextitle} and \texttt{indexsorttitle} fields},
+}
+
+ at book{cicero,
+ author = {Cicero, Marcus Tullius},
+ title = {De natura deorum. {\"U}ber das Wesen der G{\"o}tter},
+ date = 1995,
+ editor = {Blank-Sangmeister, Ursula},
+ translator = {Blank-Sangmeister, Ursula},
+ afterword = {Thraede, Klaus},
+ language = {langlatin and langgerman},
+ publisher = {Reclam},
+ location = {Stuttgart},
+ langid = {german},
+ indextitle = {De natura deorum},
+ shorttitle = {De natura deorum},
+ annotation = {A bilingual edition of Cicero's \emph{De natura deorum}, with
+ a German translation. Note the format of the \texttt{language}
+ field in the database file, the concatenation of the
+ \texttt{editor} and \texttt{translator} fields, and the
+ \texttt{afterword} field},
+}
+
+ at book{coleridge,
+ author = {Coleridge, Samuel Taylor},
+ title = {Biographia literaria, or {Biographical} sketches of my literary
+ life and opinions},
+ date = 1983,
+ editor = {Coburn, Kathleen and Engell, James and Bate, W. Jackson},
+ maintitle = {The collected works of {Samuel Taylor Coleridge}},
+ volume = 7,
+ part = 2,
+ series = {Bollingen Series},
+ number = 75,
+ publisher = {Routledge {and} Kegan Paul},
+ location = {London},
+ langid = {english},
+ langidopts = {variant=british},
+ indextitle = {Biographia literaria},
+ shorttitle = {Biographia literaria},
+ annotation = {One (partial) volume of a multivolume book. This is a
+ \texttt{book} entry with a \texttt{volume} and a \texttt{part}
+ field which explicitly refers to the second (physical) part of
+ the seventh (logical) volume. Also note the \texttt{series}
+ and \texttt{number} fields},
+}
+
+ at book{companion,
+ author = {Goossens, Michel and Mittelbach, Frank and Samarin, Alexander},
+ title = {The {LaTeX} Companion},
+ date = 1994,
+ edition = 1,
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ pagetotal = 528,
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {LaTeX Companion},
+ indextitle = {LaTeX Companion, The},
+ shorttitle = {LaTeX Companion},
+ annotation = {A book with three authors. Note the formatting of the author
+ list. By default, only the first name is reversed in the
+ bibliography},
+}
+
+ at book{cotton,
+ author = {Cotton, Frank Albert and Wilkinson, Geoffrey and Murillio,
+ Carlos A. and Bochmann, Manfred},
+ title = {Advanced inorganic chemistry},
+ date = 1999,
+ edition = 6,
+ publisher = {Wiley},
+ location = {Chichester},
+ langid = {english},
+ langidopts = {variant=british},
+ annotation = {A \texttt{book} entry with \arabic{author} authors and an
+ \texttt{edition} field. By default, long \texttt{author} and
+ \texttt{editor} lists are automatically truncated. This is
+ configurable},
+}
+
+ at book{gerhardt,
+ author = {Gerhardt, Michael J.},
+ title = {The Federal Appointments Process},
+ date = 2000,
+ publisher = {Duke University Press},
+ location = {Durham and London},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Federal Appointments Process},
+ indextitle = {Federal Appointments Process, The},
+ subtitle = {A Constitutional and Historical Analysis},
+ shorttitle = {Federal Appointments Process},
+ annotation = {This is a \texttt{book} entry. Note the format of the
+ \texttt{location} field as well as the \texttt{sorttitle} and
+ \texttt{indextitle} fields},
+}
+
+ at book{gonzalez,
+ author = {Gonzalez, Ray},
+ title = {The Ghost of {John Wayne} and Other Stories},
+ date = 2001,
+ publisher = {The University of Arizona Press},
+ location = {Tucson},
+ isbn = {0-816-52066-6},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Ghost of John Wayne and Other Stories},
+ indextitle = {Ghost of {John Wayne} and Other Stories, The},
+ shorttitle = {Ghost of {John Wayne}},
+ annotation = {A collection of short stories. This is a \texttt{book} entry.
+ Note the \texttt{sorttitle} and \texttt{indextitle} fields in
+ the database file. There's also an \texttt{isbn} field},
+}
+
+ at book{hammond,
+ author = {Hammond, Christopher},
+ title = {The basics of crystallography and diffraction},
+ date = 1997,
+ publisher = {International Union of Crystallography and Oxford University
+ Press},
+ location = {Oxford},
+ langid = {english},
+ langidopts = {variant=british},
+ sorttitle = {Basics of crystallography and diffraction},
+ indextitle = {Basics of crystallography and diffraction, The},
+ shorttitle = {Crystallography and diffraction},
+ annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and
+ \texttt{indextitle} fields as well as the format of the
+ \texttt{publisher} field},
+}
+
+ at book{iliad,
+ author = {Homer},
+ title = {Die Ilias},
+ date = 2004,
+ translator = {Schadewaldt, Wolfgang},
+ introduction = {Latacz, Joachim},
+ edition = 3,
+ publisher = {Artemis \& Winkler},
+ location = {D{\"u}sseldorf and Z{\"u}rich},
+ langid = {german},
+ sorttitle = {Ilias},
+ indextitle = {Ilias, Die},
+ shorttitle = {Ilias},
+ annotation = {A German translation of the \emph{Iliad}. Note the
+ \texttt{translator} and \texttt{introduction} fields and the
+ format of the \texttt{location} field in the database
+ file. Also note the \texttt{sorttitle} and \texttt{indextitle}
+ fields},
+}
+
+ at mvbook{knuth:ct,
+ author = {Knuth, Donald E.},
+ title = {Computers \& Typesetting},
+ date = {1984/1986},
+ volumes = 5,
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Computers & Typesetting},
+ indexsorttitle= {Computers & Typesetting},
+ annotation = {A five-volume book cited as a whole. This is a \texttt{mvbook}
+ entry, note the \texttt{volumes} field},
+}
+
+ at book{knuth:ct:a,
+ author = {Knuth, Donald E.},
+ title = {The {\TeX book}},
+ date = 1984,
+ maintitle = {Computers \& Typesetting},
+ volume = {A},
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Computers & Typesetting A},
+ indexsorttitle= {The TeXbook},
+ indextitle = {\protect\TeX book, The},
+ shorttitle = {\TeX book},
+ annotation = {The first volume of a five-volume book. Note the
+ \texttt{sorttitle} field. We want this
+ volume to be listed after the entry referring to the entire
+ five-volume set. Also note the \texttt{indextitle} and
+ \texttt{indexsorttitle} fields. Indexing packages that don't
+ generate robust index entries require some control sequences
+ to be protected from expansion},
+}
+
+ at book{knuth:ct:b,
+ author = {Knuth, Donald E.},
+ title = {{\TeX}: The Program},
+ date = 1986,
+ maintitle = {Computers \& Typesetting},
+ volume = {B},
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Computers & Typesetting B},
+ indexsorttitle= {TeX: The Program},
+ shorttitle = {\TeX},
+ annotation = {The second volume of a five-volume book. Note the
+ \texttt{sorttitle} field. Also note the
+ \texttt{indexsorttitle} field},
+}
+
+ at book{knuth:ct:c,
+ author = {Knuth, Donald E.},
+ title = {The {METAFONTbook}},
+ date = 1986,
+ maintitle = {Computers \& Typesetting},
+ volume = {C},
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Computers & Typesetting C},
+ indextitle = {METAFONTbook, The},
+ shorttitle = {METAFONTbook},
+ annotation = {The third volume of a five-volume book. Note the
+ \texttt{sorttitle} field as well as the
+ \texttt{indextitle} field},
+}
+
+ at book{knuth:ct:d,
+ author = {Knuth, Donald E.},
+ title = {{METAFONT}: The Program},
+ date = 1986,
+ maintitle = {Computers \& Typesetting},
+ volume = {D},
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Computers & Typesetting D},
+ shorttitle = {METAFONT},
+ annotation = {The fourth volume of a five-volume book. Note the
+ \texttt{sorttitle} field},
+}
+
+ at book{knuth:ct:e,
+ author = {Knuth, Donald E.},
+ title = {{Computer Modern} Typefaces},
+ date = 1986,
+ maintitle = {Computers \& Typesetting},
+ volume = {E},
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Computers & Typesetting E},
+ annotation = {The fifth volume of a five-volume book. Note the
+ \texttt{sorttitle} field},
+}
+
+ at mvbook{knuth:ct:related,
+ author = {Knuth, Donald E.},
+ title = {Computers \& Typesetting},
+ date = {1984/1986},
+ volumes = 5,
+ publisher = {Addison-Wesley},
+ location = {Reading, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Computers & Typesetting},
+ indexsorttitle= {Computers & Typesetting},
+ related = {knuth:ct:a,knuth:ct:b,knuth:ct:c,knuth:ct:d,knuth:ct:e},
+ relatedtype = {multivolume},
+ annotation = {A five-volume book cited as a whole and related to its
+ individual volumes. Note the \texttt{related} and
+ \texttt{relatedtype} fields},
+}
+
+ at book{kullback,
+ author = {Kullback, Solomon},
+ title = {Information Theory and Statistics},
+ year = 1959,
+ publisher = {John Wiley \& Sons},
+ location = {New York},
+ langid = {english},
+ langidopts = {variant=american},
+}
+
+ at book{kullback:reprint,
+ author = {Kullback, Solomon},
+ title = {Information Theory and Statistics},
+ year = 1997,
+ publisher = {Dover Publications},
+ location = {New York},
+ origyear = 1959,
+ origpublisher= {John Wiley \& Sons},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {A reprint of the \texttt{kullback} entry. Note the format of
+ \texttt{origyear} and \texttt{origpublisher}. These fields are
+ not used by the standard bibliography styles},
+}
+
+ at book{kullback:related,
+ author = {Kullback, Solomon},
+ title = {Information Theory and Statistics},
+ year = 1997,
+ publisher = {Dover Publications},
+ location = {New York},
+ langid = {english},
+ langidopts = {variant=american},
+ related = {kullback},
+ relatedtype = {origpubin},
+ annotation = {A reprint of the \texttt{kullback} entry. Note the format of
+ the \texttt{related} and \texttt{relatedtype} fields},
+}
+
+ at book{malinowski,
+ author = {Malinowski, Bronis{\l}aw},
+ title = {Argonauts of the {Western Pacific}},
+ date = 1972,
+ edition = 8,
+ publisher = {Routledge {and} Kegan Paul},
+ location = {London},
+ langid = {english},
+ langidopts = {variant=british},
+ subtitle = {An account of native enterprise and adventure in the
+ Archipelagoes of {Melanesian New Guinea}},
+ shorttitle = {Argonauts},
+ annotation = {This is a \texttt{book} entry. Note the format of the
+ \texttt{publisher} and \texttt{edition} fields as well as the
+ \texttt{subtitle} field},
+}
+
+ at book{maron,
+ author = {Maron, Monika},
+ title = {Animal Triste},
+ date = 2000,
+ translator = {Brigitte Goldstein},
+ origlanguage = {german},
+ publisher = {University of Nebraska Press},
+ location = {Lincoln},
+ langid = {english},
+ langidopts = {variant=american},
+ shorttitle = {Animal Triste},
+ annotation = {An English translation of a German novel with a French title.
+ In other words: a \texttt{book} entry with a
+ \texttt{translator} field. Note the \texttt{origlanguage}
+ field which is concatenated with the \texttt{translator}},
+}
+
+ at book{massa,
+ author = {Werner Massa},
+ title = {Crystal structure determination},
+ date = 2004,
+ edition = 2,
+ publisher = {Spinger},
+ location = {Berlin},
+ langid = {english},
+ langidopts = {variant=british},
+ annotation = {A \texttt{book} entry with an \texttt{edition} field},
+}
+
+ at article{moore,
+ author = {Moore, Gordon E.},
+ title = {Cramming more components onto integrated circuits},
+ journaltitle = {Electronics},
+ year = 1965,
+ volume = 38,
+ number = 8,
+ pages = {114-117},
+ langid = {english},
+ langidopts = {variant=american},
+}
+
+ at article{moore:related,
+ author = {Moore, Gordon E.},
+ title = {Cramming more components onto integrated circuits},
+ journaltitle = {Proceedings of the {IEEE}},
+ year = 1998,
+ volume = 86,
+ number = 1,
+ pages = {82-85},
+ langid = {english},
+ langidopts = {variant=american},
+ related = {moore},
+ relatedtype = {reprintfrom},
+ annotation = {A reprint of Moore's law. Note the \texttt{related} and
+ \texttt{relatedtype} fields},
+}
+
+ at mvbook{nietzsche:ksa,
+ author = {Nietzsche, Friedrich},
+ title = {S{\"a}mtliche Werke},
+ date = 1988,
+ editor = {Colli, Giorgio and Montinari, Mazzino},
+ edition = 2,
+ volumes = 15,
+ publisher = dtv # { and Walter de Gruyter},
+ location = {M{\"u}nchen and Berlin and New York},
+ langid = {german},
+ sorttitle = {Werke-00-000},
+ indexsorttitle= {Samtliche Werke},
+ subtitle = {Kritische Studienausgabe},
+ annotation = {The critical edition of Nietzsche's works. This is a
+ \texttt{mvbook} entry referring to a 15-volume work as a
+ whole. Note the \texttt{volumes} field and the format of the
+ \texttt{publisher} and \texttt{location} fields in the
+ database file. Also note the \texttt{sorttitle} and
+ field which is used to fine-tune the
+ sorting order of the bibliography. We want this item listed
+ first in the bibliography},
+}
+
+ at book{nietzsche:ksa1,
+ author = {Nietzsche, Friedrich},
+ title = {Die Geburt der Trag{\"o}die. Unzeitgem{\"a}{\ss}e
+ Betrachtungen I--IV. Nachgelassene Schriften 1870--1973},
+ date = 1988,
+ editor = {Colli, Giorgio and Montinari, Mazzino},
+ maintitle = {S{\"a}mtliche Werke},
+ mainsubtitle = {Kritische Studienausgabe},
+ volume = 1,
+ edition = 2,
+ publisher = dtv # { and Walter de Gruyter},
+ location = {M{\"u}nchen and Berlin and New York},
+ langid = {german},
+ sorttitle = {Werke-01-000},
+ indexsorttitle= {Samtliche Werke I},
+ bookauthor = {Nietzsche, Friedrich},
+ indextitle = {S{\"a}mtliche Werke I},
+ shorttitle = {S{\"a}mtliche Werke I},
+ annotation = {A single volume from the critical edition of Nietzsche's
+ works. This \texttt{book} entry explicitly refers to the first
+ volume only. Note the \texttt{title} and \texttt{maintitle}
+ fields. Also note the \texttt{sorttitle}
+ field. We want this entry to be listed after the entry
+ referring to the entire edition},
+}
+
+ at book{nussbaum,
+ author = {Nussbaum, Martha},
+ title = {Aristotle's \mkbibquote{De Motu Animalium}},
+ date = 1978,
+ publisher = pup,
+ location = {Princeton},
+ keywords = {secondary},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Aristotle's De Motu Animalium},
+ indexsorttitle= {Aristotle's De Motu Animalium},
+ annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and
+ \texttt{indexsorttitle} fields and the markup of the quotes in
+ the database file},
+}
+
+ at book{piccato,
+ author = {Piccato, Pablo},
+ title = {City of Suspects},
+ date = 2001,
+ publisher = {Duke University Press},
+ location = {Durham and London},
+ langid = {english},
+ langidopts = {variant=american},
+ subtitle = {Crime in {Mexico City}, 1900--1931},
+ shorttitle = {City of Suspects},
+ annotation = {This is a \texttt{book} entry. Note the format of the
+ \texttt{location} field in the database file},
+}
+
+ at book{vangennep,
+ author = {van Gennep, Arnold},
+ title = {Les rites de passage},
+ date = 1909,
+ publisher = {Nourry},
+ location = {Paris},
+ options = {useprefix},
+ langid = {french},
+ sorttitle = {Rites de passage},
+ indextitle = {Rites de passage, Les},
+ shorttitle = {Rites de passage},
+ annotation = {A \texttt{book} entry. Note the format of the printed name and
+ compare the \texttt{useprefix} option in the \texttt{options}
+ field as well as \texttt{brandt} and \texttt{geer}},
+}
+
+ at book{vangennep:trans,
+ author = {van Gennep, Arnold},
+ title = {The Rites of Passage},
+ year = 1960,
+ translator = {Vizedom, Monika B. and Caffee, Gabrielle L.},
+ language = {english},
+ origlanguage = {french},
+ publisher = {University of Chicago Press},
+ options = {useprefix},
+ indextitle = {Rites of Passage, The},
+ sorttitle = {Rites of Passage},
+ shorttitle = {Rites of Passage},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {A translation of the \texttt{vangennep} entry. Note the
+ \texttt{translator} and \texttt{origlanguage} fields. Compare
+ with the \texttt{vangennep:related} entry.},
+}
+
+ at book{vangennep:related,
+ author = {van Gennep, Arnold},
+ title = {Les rites de passage},
+ date = 1909,
+ publisher = {Nourry},
+ location = {Paris},
+ options = {useprefix},
+ langid = {french},
+ related = {vizedom:related},
+ relatedtype = {bytranslator},
+ sorttitle = {Rites de passage},
+ indextitle = {Rites de passage, Les},
+ shorttitle = {Rites de passage},
+ annotation = {A variant of the \texttt{vangennep} entry related to its
+ translation. Note the format of the \texttt{related} and
+ \texttt{relatedtype} fields},
+}
+
+ at book{vizedom:related,
+ title = {The Rites of Passage},
+ year = 1960,
+ translator = {Vizedom, Monika B. and Caffee, Gabrielle L.},
+ language = {english},
+ publisher = {University of Chicago Press},
+ langid = {english},
+ langidopts = {variant=american},
+ options = {usetranslator},
+ related = {vangennep},
+ relatedtype = {translationof},
+ indextitle = {Rites of Passage, The},
+ sorttitle = {Rites of Passage},
+ shorttitle = {Rites of Passage},
+ annotation = {A translated work from \texttt{vangennep}. Note the format of
+ the \texttt{related} and \texttt{relatedtype} fields},
+}
+
+ at mvbook{vazques-de-parga,
+ author = {V{\'a}zques{ de }Parga, Luis and Lacarra, Jos{\'e} Mar{\'i}a
+ and Ur{\'i}a R{\'i}u, Juan},
+ title = {Las Peregrinaciones a Santiago de Compostela},
+ date = 1993,
+ volumes = 3,
+ note = {Ed. facs. de la realizada en 1948--49},
+ publisher = {Iberdrola},
+ location = {Pamplona},
+ langid = {spanish},
+ sorttitle = {Peregrinaciones a Santiago de Compostela},
+ indextitle = {Peregrinaciones a Santiago de Compostela, Las},
+ shorttitle = {Peregrinaciones},
+ annotation = {A multivolume book cited as a whole. This is a \texttt{mvbook}
+ entry with \texttt{volumes}, \texttt{note},
+ \texttt{sorttitle}, and \texttt{indextitle} fields},
+}
+
+ at book{wilde,
+ author = {Wilde, Oscar},
+ title = {The Importance of Being Earnest: A Trivial Comedy for Serious
+ People},
+ year = 1899,
+ series = {English and {American} drama of the Nineteenth Century},
+ publisher = {Leonard Smithers {and} Company},
+ eprint = {4HIWAAAAYAAJ},
+ eprinttype = {googlebooks},
+ annotation = {A \texttt{book} with \texttt{eprint} and \texttt{eprinttype}
+ fields.},
+}
+
+ at book{worman,
+ author = {Worman, Nancy},
+ title = {The Cast of Character},
+ date = 2002,
+ publisher = {University of Texas Press},
+ location = {Austin},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Cast of Character},
+ indextitle = {Cast of Character, The},
+ subtitle = {Style in {Greek} Literature},
+ shorttitle = {Cast of Character},
+ annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and
+ \texttt{indextitle} fields},
+}
+
+ at mvcollection{britannica,
+ editor = {Preece, Warren E.},
+ title = {The {New Encyclop{\ae}dia Britannica}},
+ date = 2003,
+ edition = 15,
+ volumes = 32,
+ publisher = {Encyclop{\ae}dia Britannica},
+ location = {Chicago, Ill.},
+ options = {useeditor=false},
+ label = {EB},
+ langid = {english},
+ langidopts = {variant=british},
+ sorttitle = {Encyclop{\ae}dia Britannica},
+ indextitle = {{Encyclop{\ae}dia Britannica}, The {New}},
+ shorttitle = {{Encyclop{\ae}dia Britannica}},
+ annotation = {This is a \texttt{mvcollection} entry for an encyclopedia. Note
+ the \texttt{useeditor} option in the \texttt{options} field as
+ well as the \texttt{sorttitle} field. We want this entry to be
+ cited and alphabetized by title even though there is an
+ editor. In addition to that, we want the title to be
+ alphabetized under \enquote*{E} rather than \enquote*{T}. Also
+ note the \texttt{label} field which is provided for
+ author-year citation styles},
+}
+
+ at collection{gaonkar,
+ editor = {Gaonkar, Dilip Parameshwar},
+ title = {Alternative Modernities},
+ date = 2001,
+ publisher = {Duke University Press},
+ location = {Durham and London},
+ isbn = {0-822-32714-7},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {This is a \texttt{collection} entry. Note the format of the
+ \texttt{location} field in the database file as well as the
+ \texttt{isbn} field},
+}
+
+ at incollection{gaonkar:in,
+ author = {Gaonkar, Dilip Parameshwar},
+ editor = {Gaonkar, Dilip Parameshwar},
+ title = {On Alternative Modernities},
+ date = 2001,
+ booktitle = {Alternative Modernities},
+ publisher = {Duke University Press},
+ location = {Durham and London},
+ isbn = {0-822-32714-7},
+ pages = {1-23},
+}
+
+ at mvcollection{jaffe,
+ editor = {Jaff{\'e}, Philipp},
+ title = {Regesta Pontificum Romanorum ab condita ecclesia ad annum post
+ Christum natum \textsc{mcxcviii}},
+ date = {1885/1888},
+ editora = {Loewenfeld, Samuel and Kaltenbrunner, Ferdinand and Ewald,
+ Paul},
+ edition = 2,
+ volumes = 2,
+ location = {Leipzig},
+ langid = {latin},
+ editoratype = {redactor},
+ indextitle = {Regesta Pontificum Romanorum},
+ shorttitle = {Regesta Pontificum Romanorum},
+ annotation = {A \texttt{mvcollection} entry with \texttt{edition} and
+ \texttt{volumes} fields. Note the \texttt{editora} and
+ \texttt{editoratype} fields},
+}
+
+% booktitle and booksubtitle are only needed for BibTeX's less sophisticated
+% inheritance set-up to make sure westfahl:space shows correctly.
+% With Biber they are not needed.
+ at collection{westfahl:frontier,
+ editor = {Westfahl, Gary},
+ title = {Space and Beyond},
+ date = 2000,
+ subtitle = {The Frontier Theme in Science Fiction},
+ publisher = {Greenwood},
+ location = {Westport, Conn. and London},
+ langid = {english},
+ langidopts = {variant=american},
+ booktitle = {Space and Beyond},
+ booksubtitle = {The Frontier Theme in Science Fiction},
+ annotation = {This is a \texttt{collection} entry. Note the format of the
+ \texttt{location} field as well as the \texttt{subtitle}
+ field},
+}
+
+ at inbook{kant:kpv,
+ title = {Kritik der praktischen Vernunft},
+ date = 1968,
+ author = {Kant, Immanuel},
+ booktitle = {Kritik der praktischen Vernunft. Kritik der Urtheilskraft},
+ bookauthor = {Kant, Immanuel},
+ maintitle = {Kants Werke. Akademie Textausgabe},
+ volume = 5,
+ publisher = {Walter de Gruyter},
+ location = {Berlin},
+ pages = {1-163},
+ shorthand = {KpV},
+ langid = {german},
+ shorttitle = {Kritik der praktischen Vernunft},
+ annotation = {An edition of Kant's \emph{Collected Works}, volume five. This
+ is an \texttt{inbook} entry which explicitly refers to the
+ \emph{Critique of Practical Reason} only, not to the entire
+ fifth volume. Note the \texttt{author} and \texttt{bookauthor}
+ fields in the database file. By default, the
+ \texttt{bookauthor} is omitted if the values of the
+ \texttt{author} and \texttt{bookauthor} fields are identical},
+}
+
+ at inbook{kant:ku,
+ title = {Kritik der Urtheilskraft},
+ date = 1968,
+ author = {Kant, Immanuel},
+ booktitle = {Kritik der praktischen Vernunft. Kritik der Urtheilskraft},
+ bookauthor = {Kant, Immanuel},
+ maintitle = {Kants Werke. Akademie Textausgabe},
+ volume = 5,
+ publisher = {Walter de Gruyter},
+ location = {Berlin},
+ pages = {165-485},
+ shorthand = {KU},
+ langid = {german},
+ annotation = {An edition of Kant's \emph{Collected Works}, volume five. This
+ is an \texttt{inbook} entry which explicitly refers to the
+ \emph{Critique of Judgment} only, not to the entire fifth
+ volume},
+}
+
+ at inbook{nietzsche:historie,
+ title = {Unzeitgem{\"a}sse Betrachtungen. Zweites St{\"u}ck},
+ date = 1988,
+ author = {Nietzsche, Friedrich},
+ booktitle = {Die Geburt der Trag{\"o}die. Unzeitgem{\"a}{\ss}e
+ Betrachtungen I--IV. Nachgelassene Schriften 1870--1973},
+ bookauthor = {Nietzsche, Friedrich},
+ editor = {Colli, Giorgio and Montinari, Mazzino},
+ subtitle = {Vom Nutzen und Nachtheil der Historie f{\"u}r das Leben},
+ maintitle = {S{\"a}mtliche Werke},
+ mainsubtitle = {Kritische Studienausgabe},
+ volume = 1,
+ publisher = dtv # { and Walter de Gruyter},
+ location = {M{\"u}nchen and Berlin and New York},
+ pages = {243-334},
+ langid = {german},
+ sorttitle = {Werke-01-243},
+ indexsorttitle= {Vom Nutzen und Nachtheil der Historie fur das Leben},
+ indextitle = {Vom Nutzen und Nachtheil der Historie f{\"u}r das Leben},
+ shorttitle = {Vom Nutzen und Nachtheil der Historie},
+ annotation = {A single essay from the critical edition of Nietzsche's works.
+ This \texttt{inbook} entry explicitly refers to an essay found
+ in the first volume. Note the \texttt{title},
+ \texttt{booktitle}, and \texttt{maintitle} fields. Also note
+ the \texttt{sorttitle} field. We want
+ this entry to be listed after the entry referring to the
+ entire first volume},
+}
+
+ at incollection{brandt,
+ author = {von Brandt, Ahasver and Erich Hoffmann},
+ editor = {Ferdinand Seibt},
+ title = {Die nordischen L{\"a}nder von der Mitte des 11.~Jahrhunderts
+ bis 1448},
+ date = 1987,
+ booktitle = {Europa im Hoch- und Sp{\"a}tmittelalter},
+ series = {Handbuch der europ{\"a}ischen Geschichte},
+ number = 2,
+ publisher = {Klett-Cotta},
+ location = {Stuttgart},
+ pages = {884-917},
+ options = {useprefix=false},
+ langid = {german},
+ indexsorttitle= {Nordischen Lander von der Mitte des 11. Jahrhunderts bis
+ 1448},
+ indextitle = {Nordischen L{\"a}nder von der Mitte des 11.~Jahrhunderts bis
+ 1448, Die},
+ shorttitle = {Die nordischen L{\"a}nder},
+ annotation = {An \texttt{incollection} entry with a \texttt{series} and a
+ \texttt{number}. Note the format of the printed name and
+ compare the \texttt{useprefix} option in the \texttt{options}
+ field as well as \texttt{vangennep}. Also note the
+ \texttt{indextitle, and \texttt{indexsorttitle} fields}},
+}
+
+ at incollection{hyman,
+ author = {Arthur Hyman},
+ editor = {O'Meara, Dominic J.},
+ title = {Aristotle's Theory of the Intellect and its Interpretation by
+ {Averroes}},
+ date = 1981,
+ booktitle = {Studies in {Aristotle}},
+ series = {Studies in Philosophy and the History of Philosophy},
+ number = 9,
+ publisher = {The Catholic University of America Press},
+ location = {Washington, D.C.},
+ pages = {161-191},
+ keywords = {secondary},
+ langid = {english},
+ langidopts = {variant=american},
+ indextitle = {Aristotle's Theory of the Intellect},
+ shorttitle = {Aristotle's Theory of the Intellect},
+ annotation = {An \texttt{incollection} entry with a \texttt{series} and
+ \texttt{number} field},
+}
+
+ at incollection{pines,
+ author = {Pines, Shlomo},
+ editor = {Twersky, Isadore},
+ title = {The Limitations of Human Knowledge According to {Al-Farabi}, {ibn
+ Bajja}, and {Maimonides}},
+ date = 1979,
+ booktitle = {Studies in Medieval {Jewish} History and Literature},
+ publisher = hup,
+ location = {Cambridge, Mass.},
+ pages = {82-109},
+ keywords = {secondary},
+ langid = {english},
+ langidopts = {variant=american},
+ indextitle = {Limitations of Human Knowledge According to {Al-Farabi}, {ibn
+ Bajja}, and {Maimonides}, The},
+ shorttitle = {Limitations of Human Knowledge},
+ annotation = {A typical \texttt{incollection} entry. Note the
+ \texttt{indextitle} field},
+}
+
+ at inproceedings{moraux,
+ author = {Moraux, Paul},
+ editor = {Lloyd, G. E. R. and Owen, G. E. L.},
+ title = {Le \emph{De Anima} dans la tradition gr{\`e}cque},
+ date = 1979,
+ booktitle = {Aristotle on Mind and the Senses},
+ subtitle = {Quelques aspects de l'interpretation du trait{\'e}, de
+ Theophraste {\`a} Themistius},
+ booktitleaddon= {Proceedings of the Seventh Symposium Aristotelicum},
+ eventdate = 1975,
+ publisher = cup,
+ location = {Cambridge},
+ pages = {281-324},
+ keywords = {secondary},
+ langid = {french},
+ indexsorttitle= {De Anima dans la tradition grecque},
+ indextitle = {\emph{De Anima} dans la tradition gr{\`e}cque, Le},
+ shorttitle = {\emph{De Anima} dans la tradition gr{\`e}cque},
+ annotation = {This is a typical \texttt{inproceedings} entry. Note the
+ \texttt{booksubtitle}, \texttt{shorttitle},
+ \texttt{indextitle}, and \texttt{indexsorttitle} fields. Also
+ note the \texttt{eventdate} field.},
+}
+
+ at inproceedings{salam,
+ author = {Salam, Abdus},
+ editor = {Svartholm, Nils},
+ title = {Weak and Electromagnetic Interactions},
+ date = 1968,
+ booktitle = {Elementary particle theory},
+ booksubtitle = {Relativistic groups and analyticity},
+ booktitleaddon= {Proceedings of the {Eighth Nobel Symposium}},
+ eventdate = {1968-05-19/1968-05-25},
+ venue = {Aspen{\"a}sgarden, Lerum},
+ publisher = {Almquist \& Wiksell},
+ location = {Stockholm},
+ pages = {367-377},
+}
+
+ at manual{cms,
+ title = {The {Chicago} Manual of Style},
+ date = 2003,
+ subtitle = {The Essential Guide for Writers, Editors, and Publishers},
+ edition = 15,
+ publisher = {University of Chicago Press},
+ location = {Chicago, Ill.},
+ isbn = {0-226-10403-6},
+ label = {CMS},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Chicago Manual of Style},
+ indextitle = {Chicago Manual of Style, The},
+ shorttitle = {Chicago Manual of Style},
+ annotation = {This is a \texttt{manual} entry without an \texttt{author} or
+ \texttt{editor}. Note the \texttt{label} field in the database
+ file which is provided for author-year citation styles. Also
+ note the \texttt{sorttitle} and \texttt{indextitle} fields. By
+ default, all entries without an \texttt{author} or
+ \texttt{editor} are alphabetized by \texttt{title} but we want
+ this entry to be alphabetized under \enquote*{C} rather than
+ \enquote*{T}. There's also an \texttt{isbn} field},
+}
+
+ at online{baez/online,
+ author = {Baez, John C. and Lauda, Aaron D.},
+ title = {Higher-Dimensional Algebra {V}: 2-Groups},
+ date = {2004-10-27},
+ version = 3,
+ langid = {english},
+ langidopts = {variant=american},
+ eprinttype = {arxiv},
+ eprint = {math/0307200v3},
+ annotation = {An \texttt{online} reference from arXiv. Note the
+ \texttt{eprint} and \texttt{eprinttype} fields. Compare
+ \texttt{baez\slash article} which is the same item given as an
+ \texttt{article} entry with eprint information},
+}
+
+ at online{ctan,
+ title = {CTAN},
+ date = 2006,
+ url = {http://www.ctan.org},
+ subtitle = {The {Comprehensive TeX Archive Network}},
+ urldate = {2006-10-01},
+ label = {CTAN},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {This is an \texttt{online} entry. The \textsc{url}, which is
+ given in the \texttt{url} field, is transformed into a
+ clickable link if \texttt{hyperref} support has been
+ enabled. Note the format of the \texttt{urldate} field
+ (\texttt{yyyy-mm-dd}) in the database file. Also note the
+ \texttt{label} field which may be used as a fallback by
+ citation styles which need an \texttt{author} and\slash or a
+ \texttt{year}},
+}
+
+ at online{itzhaki,
+ author = {Itzhaki, Nissan},
+ title = {Some remarks on {'t Hooft's} {S}-matrix for black holes},
+ date = {1996-03-11},
+ version = 1,
+ langid = {english},
+ langidopts = {variant=american},
+ eprinttype = {arxiv},
+ eprint = {hep-th/9603067},
+ annotation = {An \texttt{online} reference from arXiv. Note the
+ \texttt{eprint} and \texttt{eprinttype} fields. Also note that
+ the arXiv reference is transformed into a clickable link if
+ \texttt{hyperref} support has been enabled},
+ abstract = {We discuss the limitations of 't Hooft's proposal for the
+ black hole S-matrix. We find that the validity of the S-matrix
+ implies violation of the semi-classical approximation at
+ scales large compared to the Planck scale. We also show that
+ the effect of the centrifugal barrier on the S-matrix is
+ crucial even for large transverse distances.},
+}
+
+ at online{markey,
+ author = {Markey, Nicolas},
+ title = {Tame the {BeaST}},
+ date = {2005-10-16},
+ url = {http://mirror.ctan.org/info/bibtex/tamethebeast/ttb_en.pdf},
+ subtitle = {The {B} to {X} of {BibTeX}},
+ version = {1.3},
+ urldate = {2006-10-01},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Tame the Beast},
+ annotation = {An \texttt{online} entry for a tutorial. Note the format of
+ the \texttt{date} field (\texttt{yyyy-mm-dd}) in the database
+ file.},
+}
+
+ at online{wassenberg,
+ author = {Wassenberg, Jan and Sanders, Peter},
+ title = {Faster Radix Sort via Virtual Memory and Write-Combining},
+ date = {2010-08-17},
+ version = 1,
+ langid = {english},
+ langidopts = {variant=american},
+ eprinttype = {arxiv},
+ eprintclass = {cs.DS},
+ eprint = {1008.2849v1},
+ annotation = {A recent \texttt{online} reference from arXiv using the new
+ (April 2007 onward) identifier format. Note the
+ \texttt{eprint}, \texttt{eprinttype}, and \texttt{eprintclass}
+ fields. Also note that the arXiv reference is transformed into
+ a clickable link if \texttt{hyperref} support has been
+ enabled},
+ abstract = {Sorting algorithms are the deciding factor for the performance
+ of common operations such as removal of duplicates or database
+ sort-merge joins. This work focuses on 32-bit integer keys,
+ optionally paired with a 32-bit value. We present a fast radix
+ sorting algorithm that builds upon a microarchitecture-aware
+ variant of counting sort},
+}
+
+ at patent{almendro,
+ author = {Almendro, Jos{\'e} L. and Mart{\'i}n, Jacinto and S{\'a}nchez,
+ Alberto and Nozal, Fernando},
+ title = {Elektromagnetisches Signalhorn},
+ number = {EU-29702195U},
+ date = 1998,
+ location = {countryfr and countryuk and countryde},
+ langid = {german},
+ annotation = {This is a \texttt{patent} entry with a \texttt{location}
+ field. The number is given in the \texttt{number} field. Note
+ the format of the \texttt{location} field in the database
+ file. Compare \texttt{laufenberg}, \texttt{sorace}, and
+ \texttt{kowalik}},
+}
+
+ at patent{kowalik,
+ author = {Kowalik, F. and Isard, M.},
+ title = {Estimateur d'un d{\'e}faut de fonctionnement d'un modulateur
+ en quadrature et {\'e}tage de modulation l'utilisant},
+ number = 9500261,
+ date = {1995-01-11},
+ type = {patreqfr},
+ langid = {french},
+ indextitle = {Estimateur d'un d{\'e}faut de fonctionnement},
+ annotation = {This is a \texttt{patent} entry for a French patent request
+ with a full date. The number is given in the \texttt{number}
+ field. Note the format of the \texttt{type} and \texttt{date}
+ fields in the database file. Compare \texttt{almendro},
+ \texttt{laufenberg}, and \texttt{sorace}},
+}
+
+ at patent{laufenberg,
+ author = {Laufenberg, Xaver and Eynius, Dominique and Suelzle, Helmut
+ and Usbeck, Stephan and Spaeth, Matthias and Neuser-Hoffmann,
+ Miriam and Myrzik, Christian and Schmid, Manfred and Nietfeld,
+ Franz and Thiel, Alexander and Braun, Harald and Ebner,
+ Norbert},
+ title = {Elektrische Einrichtung und Betriebsverfahren},
+ number = 1700367,
+ date = {2006-09-13},
+ holder = {{Robert Bosch GmbH} and {Daimler Chrysler AG} and {Bayerische
+ Motoren Werke AG}},
+ type = {patenteu},
+ langid = {german},
+ annotation = {This is a \texttt{patent} entry with a \texttt{holder} field.
+ Note the format of the \texttt{type} and \texttt{location}
+ fields in the database file. Compare \texttt{almendro},
+ \texttt{sorace}, and \texttt{kowalik}},
+ abstract = {The invention relates to an electric device comprising a
+ generator, in particular for use in the vehicle electric
+ system of a motor vehicle and a controller for controlling the
+ generator voltage. The device is equipped with a control zone,
+ in which the voltage is controlled and zones, in which the
+ torque is controlled. The invention also relates to methods
+ for operating a device of this type.},
+ file = {http://v3.espacenet.com/textdoc?IDX=EP1700367},
+}
+
+ at patent{sorace,
+ author = {Sorace, Ronald E. and Reinhardt, Victor S. and Vaughn, Steven
+ A.},
+ title = {High-Speed Digital-to-{RF} Converter},
+ number = 5668842,
+ date = {1997-09-16},
+ holder = {{Hughes Aircraft Company}},
+ type = {patentus},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {This is a \texttt{patent} entry with a \texttt{holder} field.
+ Note the format of the \texttt{type} and \texttt{date} fields
+ in the database file. Compare \texttt{almendro},
+ \texttt{laufenberg}, and \texttt{kowalik}},
+}
+
+ at periodical{jcg,
+ title = {Computers and Graphics},
+ year = 2011,
+ issuetitle = {Semantic {3D} Media and Content},
+ volume = 35,
+ number = 4,
+ issn = {0097-8493},
+ annotation = {This is a \texttt{periodical} entry with an \texttt{issn}
+ field.},
+}
+
+ at report{chiu,
+ author = {Chiu, Willy W. and Chow, We Min},
+ title = {A Hybrid Hierarchical Model of a {Multiple Virtual Storage}
+ ({MVS}) Operating System},
+ type = {resreport},
+ institution = {IBM},
+ date = 1978,
+ number = {RC-6947},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {Hybrid Hierarchical Model of a Multiple Virtual Storage (MVS)
+ Operating System},
+ indextitle = {Hybrid Hierarchical Model, A},
+ annotation = {This is a \texttt{report} entry for a research report. Note
+ the format of the \texttt{type} field in the database file
+ which uses a localization key. The number of the report is
+ given in the \texttt{number} field. Also note the
+ \texttt{sorttitle} and \texttt{indextitle} fields},
+}
+
+ at report{padhye,
+ author = {Padhye, Jitendra and Firoiu, Victor and Towsley, Don},
+ title = {A Stochastic Model of {TCP Reno} Congestion Avoidance and
+ Control},
+ type = {techreport},
+ institution = {University of Massachusetts},
+ date = 1999,
+ number = {99-02},
+ location = {Amherst, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ sorttitle = {A Stochastic Model of TCP Reno Congestion Avoidance and
+ Control},
+ indextitle = {Stochastic Model of {TCP Reno} Congestion Avoidance and Control,
+ A},
+ annotation = {This is a \texttt{report} entry for a technical report. Note
+ the format of the \texttt{type} field in the database file
+ which uses a localization key. The number of the report is
+ given in the \texttt{number} field. Also note the
+ \texttt{sorttitle} and \texttt{indextitle} fields},
+ abstract = {The steady state performance of a bulk transfer TCP flow
+ (i.e. a flow with a large amount of data to send, such as FTP
+ transfers) may be characterized by three quantities. The first
+ is the send rate, which is the amount of data sent by the
+ sender in unit time. The second is the throughput, which is
+ the amount of data received by the receiver in unit time. Note
+ that the throughput will always be less than or equal to the
+ send rate due to losses. Finally, the number of non-duplicate
+ packets received by the receiver in unit time gives us the
+ goodput of the connection. The goodput is always less than or
+ equal to the throughput, since the receiver may receive two
+ copies of the same packet due to retransmissions by the
+ sender. In a previous paper, we presented a simple model for
+ predicting the steady state send rate of a bulk transfer TCP
+ flow as a function of loss rate and round trip time. In this
+ paper, we extend that work in two ways. First, we analyze the
+ performance of bulk transfer TCP flows using more precise,
+ stochastic analysis. Second, we build upon the previous
+ analysis to provide both an approximate formula as well as a
+ more accurate stochastic model for the steady state throughput
+ of a bulk transfer TCP flow.},
+ file = {ftp://gaia.cs.umass.edu/pub/Padhey99-markov.ps},
+}
+
+ at thesis{geer,
+ author = {de Geer, Ingrid},
+ title = {Earl, Saint, Bishop, Skald~-- and Music},
+ type = {phdthesis},
+ institution = {Uppsala Universitet},
+ date = 1985,
+ subtitle = {The {Orkney Earldom} of the Twelfth Century. {A} Musicological
+ Study},
+ location = {Uppsala},
+ options = {useprefix=false},
+ langid = {english},
+ langidopts = {variant=british},
+ annotation = {This is a typical \texttt{thesis} entry for a PhD thesis. Note
+ the \texttt{type} field in the database file which uses a
+ localization key. Also note the format of the printed name and
+ compare the \texttt{useprefix} option in the \texttt{options}
+ field as well as \texttt{vangennep}},
+}
+
+ at thesis{loh,
+ author = {Loh, Nin C.},
+ title = {High-Resolution Micromachined Interferometric Accelerometer},
+ type = {mathesis},
+ institution = {Massachusetts Institute of Technology},
+ date = 1992,
+ location = {Cambridge, Mass.},
+ langid = {english},
+ langidopts = {variant=american},
+ annotation = {This is a typical \texttt{thesis} entry for an MA thesis. Note
+ the \texttt{type} field in the database file which uses a
+ localization key},
+}
Property changes on: branches/branch2022.final/Master/texmf-dist/bibtex/bib/biblatex-ms/biblatex/biblatex-examples-ms.bib
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Deleted: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES-ms.md
===================================================================
--- branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES-ms.md 2023-03-08 21:38:44 UTC (rev 66480)
+++ branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES-ms.md 2023-03-08 21:39:33 UTC (rev 66481)
@@ -1,983 +0,0 @@
-# RELEASE NOTES FOR VERSION 4.0
- - This is a major update with support for multiscript entryfields
- - **INCOMPATIBLE CHANGE** Default name list and plain list formats declared
- with \DeclareNameFormat and \DeclareListFormat respectively have been
- modified to support per-item language switching via the macros:
-
- name:langswitchon/name:langswitchoff
- list:langswitchon/list:langswitchoff
-
- If you use or provide custom name/list formats, you may want to look at
- the format definitions in biblatex.def to see where to place these in
- your custom formats in order to provide multiscript support for
- per-item automatic language switching. Nothing will break if you don't
- do this but there may be a loss of some aspects of multiscript
- functionality. In general, you should place the "on" macros *after*
- name:delim/list:delim and the "off" macros at the end of the format.
-- **INCOMPATIBLE CHANGE** Data annotation test macros \if*annotation,
- \has*annotation and \get*annotation now have multiscript form and
- language as optional arguments in position 1 and 2, therefore, if you
- are using these macros with any optional arguments, be sure to supply
- the first two arguments (as "[][]"). For example:
-
- \getitemannotation[somefield] -> \getitemannotation[][][somefield]
- \ifpartannotation[][someannotationname][2]{family}{someval} ->
- \ifpartannotation[][][][someannotationname][2]{family}{someval}
-- **INCOMPATIBLE CHANGE** Namelist-specific hashes of the form
- <namelist>namehash, <namelist>bibnamehash or <namelist>fullhash now must
- contain a multiscript form and language in order to differentiate
- between multiscript name alternates. The format is now
- <namelist><msform><mslang>namehash,
- <namelist><msform><mslang>bibnamehash or
- <namelist><msform><mslang>fullhash and biber 4.0+ always generates specific
- name hashes in this format.
-# RELEASE NOTES FOR VERSION 3.18b
-- Reenable `\MakeUppercase`/`\MakeLowercase` "patches" for `\bibstring`
- based on `\CaseSwitch`.
-
-# RELEASE NOTES FOR VERSION 3.18a
-- Disable `\MakeUppercase`/`\MakeLowercase` patches as emergency fix
- for LaTeX 2022-06-01-PL4 compatibility.
-
-# RELEASE NOTES FOR VERSION 3.18
-- New sorting name key generation macro `\visibility` which allows
- application of sorting name key generation to apply only to sorting
- within citati
- ons.
-- New sorting macro `\intciteorder` which allows sorting by order internal
- to a cite command like \cite{a,b,c}.
-- New option `pluralothers` to force "et al." to be plural (i.e. only
- replace two or more names). This is required for some styles (e.g. APA)
-- Added `\localrefcontext` as a local alternative
- to the global `\newrefcontext`.
- `\localrefcontext` can be nested and is only active in the current group.
-
-# RELEASE NOTES FOR VERSION 3.17
-- **INCOMPATIBLE CHANGE**
- The behaviour of index-less granular xdata references to list fields has
- changed. Before, a reference to an XDATA list field would select the
- first element in the XDATA field list if no index was given but now this
- will splice in all elements of the XDATA list field. To ensure the
- previous behaviour, simply add "-1" (assuming the default value of "-"
- for the biber 'xdatasep' option) to the end of all granaular list
- XDATA references.
-- Added helper macros to enable calculations with non-ASCII numerals.
- This is necessary to properly support languages like Marathi.
- At the moment the 'translation' is very basic and uses a one-to-one
- correspondence of US-ASCII (Arabic) digits and non-ASCII digits.
- The translation also needs additional post-processing steps.
- Use `\blx at defcomputableequivalent{<numeral digit>}{<ASCII digit>}` to
- make `<numeral digit>` an equivalent of `<ASCII digit>`
- (presumably this command will be used in `.lbx` files if the language
- requires it).
- `\hascomputableequivalent{<string>}` can be used to check if `<string>`
- is a number that can be converted to a number with ASCII digits.
- `\getcomputableequivalent{<string>}{<macro>}` does the conversion
- and saves the number in `<macro>`.
- There is `\ifiscomputable{<string>}` to check if a `<string>`
- is an ASCII number OR has a computable equivalent.
- There are analogous macros for fields instead of strings.
-- Added `\textouterlang` to select the last active language that
- was not selected by `biblatex` itself.
- This may help in multilingual setups where `biblatex` also changes the
- language quite heavily.
-- Added `\DeclareBibstringSet`, `\DeclareBibstringSetFormat` etc.
- to allow injecting additional formatting for a set of bibstrings.
- Sets can be defined arbitrarily. These commands are primarily
- intended for use in localisation modules.
-- Changed the definition of `\bibnamedelimi` to `\isdot\addnbspace`.
- Previously the definition was just `\addnbspace`, which meant the `.`
- would be treated as a period/full stop.
-- **BREAKING CHANGE**
- `\DeclareDelimFormat` no longer accepts a list of names as argument.
- It only accepts a single delimiter name.
- A list of contexts is still supported.
- Note that previously the optional argument would not work correctly
- with a list of names.
-- **CRITICAL CHANGE**
- `biblatex` no longer writes tracking and refsection initialisation code
- to aux files.
- Instead the `\...cite` commands are redefined locally to do that on demand.
- This should keep the auxiliary files much cleaner of `biblatex`
- intervention.
-- **CRITICAL CHANGE**
- Generalised `season` date part to `yeardivision`. It can now also
- hold quarter, quadrimester, semestral or seasons with hemisphere
- designation.
- Helper macros have been renamed accordingly. Limited backwards
- compatibility is in place.
-- **(Possibly) CRITICAL CHANGE**
- `\notecite` and friends no longer issue an explicit `\nocite`.
- Since the commands are defined with `\DeclareCiteCommand`, they
- already issue a normal cite request.
- The additional `\nocite` from the loop code was superfluous
- and would result in slightly instable `.bcf` files.
-
-
-# RELEASE NOTES FOR VERSION 3.16
-- Fixed an infinite loop caused by excessive aliasing of the `volcitepages`
- format.
- Reverted the alias `\DeclareFieldAlias{volcitepages}{postnote}`
- and again define
- ```
- \DeclareFieldFormat{volcitepages}{\mkpageprefix[pagination][\mknormrange]{#1}}
- ```
- explicitly.
-# RELEASE NOTES FOR VERSION 3.15b
-- Fixed `.lbx` file loading behaviour. All `.lbx` files are now loaded
- `\AtBeginDocument`. Languages that were not requested explicitly by packages
- are recorded in the `.aux` file and loaded on the next run.
- This may require a further LaTeX run in some situations, but now we can be
- sure when `.lbx` files are read.
-- Added `label` option to `\printbibliography`.
-- Added more name wrapper aliases to make name aliasing smoother.
-- Deprecate `\mainlang` switch in favour of the text macro `\textmainlang`.
-- Deprecate `\mkrelatedstring` (which is defined as `\mainlang`)
- in favour of `\mkrelatestringtext` (defined as `\textmainlang`).
-
-# RELEASE NOTES FOR VERSION 3.15a
-- Fixed bug with long argument for `\DeclareFieldFormat` and friends.
-
-# RELEASE NOTES FOR VERSION 3.15
-- Fixed a long-standing issue with `\intitlepunct`.
- The old definition
- ```
- \newbibmacro*{in:}{%
- \printtext{%
- \bibstring{in}\intitlepunct}}
- ```
- would print `\intitlepunct` directly and not via the punctuation
- buffer. Since the `\add...` punctuation macros guard against
- undesired double punctuation, this would usually not show as an
- issue (except in edge cases https://tex.stackexchange.com/q/175730/,
- https://github.com/plk/biblatex/issues/943).
- The new definition uses the punctuation tracker to print
- `\intitlepunct`.
- ```
- \newbibmacro*{in:}{%
- \bibstring{in}%
- \printunit{\intitlepunct}}
- ```
- `\printunit` is needed instead of `\setunit` to stop subsequent
- `\setunit`s from overriding `\intitlepunct` in case of missing
- fields.
-- Define `volcitepages` and `multipostnote` as a field alias of `postnote`
- and `multiprenote` as an alias of `prenote`.
- That should make it easier to change all post- and prenote formats at once.
- A change to `postnote` will automatically apply to `multipostnote`
- and `volcitepages` as well. Similarly for `multiprenote`.
- In case that is not desired, the original definitions can be restored with
- ```
- \DeclareFieldFormat{volcitepages}{\mkpageprefix[pagination][\mknormrange]{#1}}
- \DeclareFieldFormat{multiprenote}{#1\isdot}
- \DeclareFieldFormat{multipostnote}{\mkpageprefix[pagination][\mknormrange]{#1}}
- ```
-
- **NB** The definition of `volcitepages` caused an infinite loop and was
- reverted in v3.15b.
- This means that only `multiprenote` and `multipostnote` are aliased.
-- Unified DOI, eprint and URL printing across all entry types.
- The fields `doi`, `eprint`, `eprintclass`, `eprinttype` and `url`
- are now valid for all entry types.
- `@online` and `@unpublished` now also use the bibmacro
- `doi+eprint+url`.
- This means `@online` now responds to the `url` option.
- That does not mean, however, that a global `url=false,`
- suppresses URLs for `@online` entries, since `url=true,`
- is set on a per-type level to ensure backwards compatibility
- as far as possible.
- In case eprint information should be suppressed for `@online`
- and `@unpublished`, add
- ```
- \ExecuteBibliographyOptions[online,unpublished]{eprint=false}
- ```
-- Added `eid` to more entry types.
- To avoid issues with backwards compatibility of widely used bibmacros,
- the bibmacro `chapter+pages` was redefined from
- ```
- \newbibmacro*{chapter+pages}{%
- \printfield{chapter}%
- \setunit{\bibpagespunct}%
- \printfield{pages}%
- \newunit}
- ```
- to
- ```
- \newbibmacro*{chapter+pages}{%
- \printfield{chapter}%
- \setunit{\bibeidpunct}%
- \printfield{eid}%
- \setunit{\bibpagespunct}%
- \printfield{pages}%
- \newunit}
- ```
-- Added `\bibeidpunct` in analogy to `\bibpagespunct`.
-- Added `issuetitleaddon` and `journaltitleaddon` fields.
-- Added options `backreffloats` and `trackfloats` to enable/disable
- citation tracking and back references in floats.
- Note that citation tracking in floats can lead to undesirable
- results in case the float objects floats too far from its "natural"
- position.
-- **INCOMPATIBLE CHANGE** `numeric-comp` compresses subentry set
- references now.
- This behaviour can be disabled with `subentrycomp=false`.
-- Added `subentrycomp` option to `numeric-comp` citation style.
- The option is only relevant with `subentry=true`.
- With `subentrycomp=true` set citations will be compressed
- to "1a-c" instead of "1a; 1b; 1c".
- The option is mainly intended for backwards compatibility;
- the behaviour of previous `biblatex` versions can be restored
- with `subentrycomp=false`.
-- Added `\multiciterangedelim`, `\multicitesubentrydelim`,
- `\multicitesubentryrangedelim`, `\superciterangedelim`,
- `\supercitesubentrydelim`, and `\supercitesubentryrangedelim` for
- finer control over (compressed) subentry citations in `numeric-comp`.
-- **CRITICAL CHANGE**
- The structure of the bibmacros in `numeric-comp`
- has been reworked to make it easier to customise the printed output.
- Documents that relied on patching internal bibmacros or heavily
- redefined them may have to adapt.
-- **CRITICAL CHANGE**
- Implemented better `@set` support for BibTeX, `@set`s should now
- sort properly.
- This is achieved with a two-pass structure and (hidden) copies of
- the set entries.
- The two-pass structure means that the compilation sequence becomes
- LaTeX, BibTeX, LaTeX, BibTeX, LaTeX, LaTeX.
-- **CRITICAL CHANGE**
- The case change functions now make use of the `expl3` module `l3text`
- if the available `expl3` version is recent enough.
- If `expl3` is too old the old LaTeX2e implementation is used.
- If desired the implementation of the case changing functions
- can be selected at load-time with the `casechanger` option, which
- accepts the values `expl3`, `latex2e` and `auto` (which selects
- `expl3` if the `expl3` version not older than 2020-04-06, this
- is the default).
-
- The `expl3` implementation of the case changer is slightly more
- robust than the home-grown `latex2e` code.
-- The option `bibtexcaseprotection` can be used to turn off the
- case protection via curly braces. This allows for a saner approach
- to case protection where text is protected solely via a macro
- like `\NoCaseChange`, e.g.
- ```
- title = {The Story of \NoCaseChange{HMS \emph{Erebus}}
- in \emph{Really} Strong Wind},
- ```
- instead of
- ```
- title = {The Story of {HMS} \emph{Erebus}
- in {\emph{Really}} Strong Wind},
- ```
-- Added `\mautocite` and `\Mautocite`.
-- Added `\NumsCheckSetup` and `\PagesCheckSetup` for finer control
- of the `\ifnumerals` and `\ifpages` checks.
-- Deprecate the starred `\DeclareDelimAlias*` in favour of
- `\DeclareDelimAlias` with optional arguments.
-- **INCOMPATIBLE CHANGE**
- `biblatex` no longer falls back to English for unknown languages.
- Warnings will be triggered if undefined language strings or extras
- are used.
-- **INCOMPATIBLE CHANGE**
- Bibliography strings and bibliography extras can now be written
- either to `\captions<language>` or to `\extras<language>`
- (this is controlled with the `langhook` option).
- Previously, they were written to `\extras<language>`, but upon
- reflection `\captions<language>` appears to be a more sensible
- place for these definitions.
- The new default is to write to `\captions<language>`
- (i.e. `langhook=captions`).
- The previous behaviour can be restored with `langhook=extras`.
-- **INCOMPATIBLE CHANGE** Moved `\delimcontext{bib}` to `\AtUsedriver`,
- this makes it easier to override the delimiter context in `\usedriver`
- calls. `\AtUsedriver*` calls may have to be amended to include
- `\delimcontext{bib}`. The new default is
- ```
- \AtUsedriver{%
- \delimcontext{bib}%
- \let\finentry\blx at finentry@usedrv
- \let\newblock\relax
- \let\abx at macro@bibindex\@empty
- \let\abx at macro@pageref\@empty}
- ```
- Note that this definition is backwards compatible
- and can be used in older versions as well (down to v3.4 2016-05-10).
-- `biblatex` now tests if a requested backend (re)run happened by
- comparing the MD5 hashes of the new and old `.bbl` files.
-- Added file hooks `\blx at filehook@preload@<filename>`,
- `\blx at filehook@postload@<filename>`
- and `\blx at filehook@failure@<filename>`
- to execute hooks before or after a file is loaded
- or if the loading fails.
- `\blx at lbxfilehook@simple at preload@<filename>`,
- `\blx at lbxfilehook@simple at postload@<filename>`
- and `\blx at lbxfilehook@simple at failure@<filename>`
- as well as
- `\blx at lbxfilehook@once at preload@<filename>`,
- `\blx at lbxfilehook@once at postload@<filename>`
- and `\blx at lbxfilehook@once at failure@<filename>`
- are the equivalents for `.lbx` loading, where
- files may be loaded several times in some situations.
-- Added limited support for 'nodate' with BibTeX.
-- Improved `babel` and `polyglossia` interfacing (avoids more or less
- unsupported patches).
- This should work with `babel` at least v3.9r (2016/04/23)
- and polyglossia `polyglossia` v1.49 (2020/04/08) or later.
-- **INCOMPATIBLE CHANGE** Removed list and name index wrappers
- (`\DeclareIndexNameWrapperFormat`, `\DeclareIndexListWrapperFormat`
- and friends). Those wrappers make no sense, since the indexed
- names are not printed 'together' in any useful sense of the word
- and were never working anyway.
-- **CRITICAL CHANGE** Generalised some keyval macros.
- `biblatex`-related uses of `\define at key` should ideally replaced with
- `\blx at kv@defkey`.
- Style authors are advised not to rely too much on the internal
- implementation of certain keyval interfaces.
- Users who want to experiment with using a different underlying
- keyval parser need only provide replacements of the `\blx at kv@...`
- macros (which are defined via `\provide...` so that they will
- not overwrite existing definitions; in particular users can define
- those replacements before loading `biblatex`).
-- Deprecate `\ifkomabibtotoc` and `\ifkomabibtotocnumbered`.
- With newer versions of KOMA-Script these tests are no longer used
- and their implementation was always a bit shifty (they would only pick
- up globally set options).
-
-
-# RELEASE NOTES FOR VERSION 3.14
-- biber from version 2.14 has extended, granular XDATA functionality to
- allow referencing from and to parts of fields. This makes XDATA entries into
- more general data sharing containers.
-- Biber applies Perl's Unicode case folding to normalise the
- capitalisation of field names and entry types when reading from the
- `.bib` file. The output in the `.bbl` (what comes out on the
- `biblatex` side uses the capitalisation from the data model; the only
- exception are unknown entry types which are passed on *exactly*
- as they are given in the `.bib` file - of course it is strongly
- recommended to define all entry types one intends to use in the
- data model).
-- `biblatex` now interfaces with `polyglossia` much better and can deal
- with language variants.
- Note that `polyglossia` v1.45 (2019/10/27) is required for this
- to work properly, it is strongly recommended to update `polyglossia`
- to this or a later (current) version.
-
-# RELEASE NOTES FOR VERSION 3.13
-- **INCOMPATIBLE CHANGE** Any custom per-entry options in datasources must
- be defined with `\DeclareEntryOption` in order for biber to recognise
- them and pass them out in the `.bbl`.
- This should not adversely affect any code using the documented
- `\Decalare...Option` interface, so should be uncritical for most users.
-- Added `\DeclareBiblatexOption` as a convenient interface to declare the same
- option in different scopes. This should help avoid code duplication.
- For example
- ```
- \DeclareBibliographyOption[boolean]{noroman}[true]{%
- \settoggle{blx at noroman}{#1}}
- \DeclareTypeOption[boolean]{noroman}[true]{%
- \settoggle{blx at noroman}{#1}}
- \DeclareEntryOption[boolean]{noroman}[true]{%
- \settoggle{blx at noroman}{#1}}
- ```
- can be replaced with
- ```
- \DeclareBiblatexOption{global,type,entry}[boolean]{noroman}[true]{%
- \settoggle{blx at noroman}{#1}}
- ```
-- Following the introduction of `\DeclareBiblatexOption` extend the scope
- of a few options (`abbreviate`, `citetracker`, `clearlang`, `dataonly`,
- `dateabbrev`, `<namepart>inits`, `ibidtracker`, `idemtracker`, `labelalpha`,
- `labelnumber`, `labeltitle`, `labeltitleyear`, `labeldateparts`,
- `loccittracker`, `opcittracker`, `singletitle`, `skipbib`, `skipbiblist`,
- `skipbiblab` `terseinits`, `uniquelist`, `uniquename`, `uniquetitle`,
- `uniquebaretitle`, `uniquework`, `uniqueprimaryauthor`).
-- Furthermore, the standard style options `doi`, `eprint`, `isbn`, `url`,
- `related` are now available also on a per-type and per-entry level.
- The same holds for `mergedate`, `subentry` and the options of `reading.bbx`.
- This change has the potential to clash with custom styles that already define
- the standard options at these scopes.
-- Promote `@software` to regular entry type and define `@dataset`.
- `@software` is aliased to the `@misc` driver,
- `@dataset` has a dedicated driver.
-- Add `\ifvolcite` test to check if the current citation is in a `\volcite`
- context.
-- Add the special fields `volcitevolume` and `volcitepages` for finer control
- over the `\volcite` postnote.
-- Add `\AtVolcite` hook to initialise `\volcite` commands.
-- Add `\mkbibcompletename` as well as `\mkbibcompletename<formatorder>`
- to format complete names.
- The commands are analogous to `\mkbibname<namepart>` but apply to
- the entire name printed in format order `<formatorder>`.
- By default the predefined macros all expand to `\mkbibcompletename`.
-- Add `multiprenotedelim` and `multipostnotedelim` and make all
- `(pre|post)notedelim`-like commands context sensitive.
-- Add rudimentary support for `labelprefix` with BibTeX backend.
- Biber implements `labelprefix` via `refcontext`s, but BibTeX does not
- actually support `refcontext`s. The user interface is retained, but BibTeX's
- "`refcontext`s" support only the emulation of `labelprefix` and nothing more.
- There might be subtle differences between Biber's and BibTeX's
- `labelprefix` behaviour, but it should be better than nothing.
- If you need full `labelprefix` support, please consider switching to Biber.
-- Add `\thefirstlistitem`, `\strfirstlistitem` and `\usefirstlistitem` to
- grab and use the first item of a field.
-- Add `\isdot` to the format for `journaltitle` so that `.`s at the end of the
- `journal(title)` field are automatically treated as abbreviation dots and not
- sentence-ending periods. To restore the old behaviour add
- ```
- \DeclareFieldFormat{journaltitle}{\mkbibemph{#1}}
- ```
- to the preamble.
-- Add second optional item post processing argument to `\mkcomprange`,
- `\mknormrange` and `\mkfirstpage`. It can be used to post process
- every number item in the formatted range separately. It can for
- example turn cardinal ranges into ordinal ranges (this is done in
- the Latvian localisation module).
-- Add further customisation options for strings typeset with `url`'s `\url`
- command (mainly URLs and DOIs). It is now possible to add a bit of
- stretchable space after characters with `biburlnumskip`, `biburlucskip`
- and `biburlucskip`. The previously hard-coded (stretacheble) space
- `\biburlbigskip` as well as the penalties `biburlbigbreakpenalty` and
- `biburlbreakpenalty` are also configurable now.
-- Add `\DeclarePrintbibliographyDefaults` to set default values for some
- option keys to `\printbibliography` and friends.
-- `\nocite` is now enabled in the bibliography (previously it was
- deactivated in the bibliography).
- Please report any issues that this may cause.
-- The internals macros `\abx at aux@cite`, `\abx at aux@refcontext`
- and `\abx at aux@biblist` are now called every time an entry is cite
- (and appears in a bibliography or biblist, respectively).
- This helps to avoid unwanted side-effects when writing to aux files
- is disabled.
-- `\nohyphenation` and `\textnohyphenation` now rely on a (fake)
- language without hyphenation patterns instead of `\lefthyphenmin`,
- which means that the command can now be used anywhere in a paragraph,
- see also <https://texfaq.org/FAQ-hyphoff>.
- Note that switching languages with `babel` *within* those commands
- removes the hyphenation protection.
-- Allow `doi` field for `@online` entries. This field was previously
- not printed in the `@online` driver. In case DOIs appear where
- they should not appear the output of earlier versions can be
- recreated with
- ```
- \ExecuteBibliographyOptions[online]{doi=false}
- ```
- since the `doi` option is now available on a per-type level.
-
-
-# RELEASE NOTES FOR VERSION 3.12
-- **INCOMPATIBLE CHANGE** The syntax for defining data annotations in the
- BibLaTeXML data source format has changed to accommodate named
- annotations. Annotations are no longer attributes but are fully-fledged
- elements. It is not expected that this will impact any current users.
-- **INCOMPATIBLE CHANGE** The field/fieldset argument to the `\translit`
- command is now mandatory to allow for a new optional argument which
- restricts transliteration to entries with particular `langid` fields.
-- The field `sortyear` is an integer field now and not a literal. This is
- because the `sortX` fields should be the same datatype as the `X` field
- as sorting depends on this. This fixes an issue where years were not
- sorted properly as integers. `sortyear` was sometimes used to tune date
- sorting as in "1984-1", "1984-2" etc. for multi-volume collections with
- the same year. However, this is really an abuse of the sorting template
- system since this should be done by having a semantically more granular
- sorting item to differentiate below the year level (typically, `volume`
- does this for multi-volume works and this is already part of all default
- sorting templates). The example .bib that comes with biblatex has been
- changed to remove such `sortyear` abuses and the sorting is not impacted
- as they examples using this already have either `volume` or `sorttitle`
- which made this abuse of `sortyear` unnecessary anyway.
-- The field `number` is a literal field now and not an integer. This allows for
- a wider range of possible input such as "S1", "Suppl. 1", "1-3".
- If you want to sort by `number` and only have integers in there, you should
- consider using a custom data model to turn `number` back into an integer type
- field, since sorting integers as literals has performance implications and
- might lead to undesired sorting such as "1", "10", "2".
-- **INCOMPATIBLE CHANGE** Removed the 'semi-hidden' option `noerroretextools`.
- If you want to load `noerroretextools` now, you need to define the macro
- `\blx at noerroretextools` instead. This can for example be done with
- ```
- \usepackage{etoolbox}
- \cslet{blx at noerroretextools}\empty
- \usepackage{biblatex}
- ```
- or
- ```
- \makeatletter
- \let\blx at noerroretextools\@empty
- \makeatother
- \usepackage{biblatex}
- ```
- You still need to make sure that all macros used by `biblatex` are restored
- to their `etoolbox` definitions before loading `biblatex`.
-- New macro `\abx at missing@entry` to style missing entrykeys in citations.
-- Added field format deprecation macros `\DeprecateFieldFormatWithReplacement`
- and friends.
-- Add `\ifdateyearsequal` to check if two dates have the same year and era
- date part. Since `year`s are always non-negative integers and the 'sign' is
- stored as the `era`, you should use `\ifdateyearsequal` instead of a simple
- `\iffieldequals{#1year}{#2year}` to compare years. The latter can lead to
- undesired results if the years have opposite signs, but are otherwise the
- same.
-- New values `part+`, `chapter+`, `section+` and `subsection+` for 'section'-
- valued options `refsection`, `refsegment` and `citereset`. These options
- are then executed at not only the specified level of sectioning, but also
- all higher levels.
-- Add second optional argument to `\DeclareDelimAlias*`.
-- Allow keywords for dataonly/skipped entries as well.
-- Added `maxcitecounter`.
-- Deprecate `\labelnamepunct` in favour of the context-sensitive
- `nametitledelim`.
- For compatibility reasons `\labelnamepunct` still pops up in the code here
- and there, but `nametitledelim` should be preferred now.
-- The `xstring` package is not loaded by default any more.
- Style developers whose styles make use of that package should load it
- explicitly.
-- `authoryear.bbx` now has a macro `bbx:ifmergeddate` that can be used to
- check whether the date has been printed at the beginning of an entry
- and can thus be suppressed later in the `date` and `issue+date` macros.
- The macro works like a test and expands to the `<true>` branch if the date
- has been merged and can be suppressed, it expands to `<false>` if the date
- has not been merged. In practice `\printdate` should then be issued
- if and only if the test yields false.
-
- This change means that the definition of the `date` macro can be the same for
- all mergedate settings and that only `bbx:ifmergeddate` is redefined for
- each different value. No backwards compatibility issues are expected,
- but style authors are encouraged to test the changes and see if the new
- macro could be useful for their styles.
-- For a long time `biblatex` has defined `\enquote` if `csquotes` was not
- loaded. This behaviour was not documented, the official command intended
- for quotation marks was always `\mkbibquote`. Because `biblatex` should not
- (re)define user-level commands that are not primarily associated with
- citations or the bibliography, from this release on `\enquote` is not defined
- any more, instead the internal command `\blx at enquote` is defined and used.
- The same holds for `\initoquote`, `\initiquote`, `\textooquote`,
- `\textcoquote`, `\textoiquote`, `\textciquote`.
- `biblatex` still defines the internal commands `\@quotelevel`, `\@quotereset`
- and `\@setquotesfcodes` if `csquotes` is not loaded.
-
- Users are encouraged to use `csquotes` for proper quotation marks, but can
- get back the old behaviour with
- ```
- \makeatletter
- \providerobustcmd*{\enquote}{\blx at enquote}
- \makeatother
- ```
- or
- ```
- \newrobustcmd*{\enquote}{\mkbibquote}
- ```
-- Add new list wrapper and name wrapper formats (`\DeclareListWrapperFormat`,
- `\DeclareNameWrapperFormat`) to style a (name) lists in its entirety.
- This is useful because name and lists formats normally style only one
- particular item of the list. The wrapper format can be used to easily format
- the entire list in italics, for example.
-- `\DeclareCitePunctuationPosition` can be used to configure the punctuation
- position for citation commands similar to the optional `position` argument
- of `\DeclareAutoCiteCommand`.
-- If the `\pdfmdfivesum` primitive is available (via `pdftexcmds`'
- `\pdf at mdfivesum`) the `labelprefix` value is hashed for internal use, making
- it safer for construction of macro names and the like. If you don't like
- that you can turn off the behaviour by redefining `\blx at mdfivesum`. The
- fallback in case `\pdf at mdfivesum` is unavailable is
- ```
- \let\blx at mdfivesum\@firstofone
- ```
-
- As before the labelprefix value is fully expanded before use. If its contents
- are unexpandable you need to avoid expansion with `\detokenize`.
-
-# RELEASE NOTES FOR VERSION 3.11
-- `\printbiblist` now supports `driver` and `biblistfilter` options
- to change the defaults set by the biblistname.
-- Add `\mknormrange` to normalise page ranges without compressing them.
-- **INCOMPATIBLE CHANGE** The format for `postnote` (`multipostnote`,
- `volcitepages`) normalises page ranges with `\mknormrange`.
- Since `\mknormrange` acts only on page ranges as detected by
- `\ifpages`, this does not affect text other than page ranges.
- Hyphens and dashes in page ranges will be transformed to
- `\bibrangedash`, commas and semicolons to `\bibrangesep`.
- This is analogous to Biber's treatment of page-like fields.
- If you always separated page ranges with `--` or `\bibrangedash`
- anyway, this should not change the output you get.
- If you used a single hyphen to separate page ranges (e.g., `23-27`)
- you will now get the arguably more aesthetically pleasing output
- with `\bibrangedash`.
- In case you want to restore the old behaviour where page ranges were
- not normalised add the following three lines to your preamble.
- ```
- \DeclareFieldFormat{postnote}{\mkpageprefix[pagination]{#1}}
- \DeclareFieldFormat{volcitepages}{\mkpageprefix[pagination]{#1}}
- \DeclareFieldFormat{multipostnote}{\mkpageprefix[pagination]{#1}}
- ```
- Style developers may note that the field format for `pages`
- was not changed to include `\mknormrange` because the contents
- of that field are prepared by the backend and Biber already does
- the page range normalisation out of the box.
-- The standard definitions for headings were changed to be as close to the
- defaults of the standard document classes or KOMA/memoir as possible.
- **PLEASE CHECK** if your document headers relied on the behaviour of older
- versions.
-- The `@unpublished` entry type now also supports `type`, `eventtitle`,
- `eventdate` and `venue`.
-- A long-standing bug with punctuation before `eventdate` and `venue` was fixed.
- Originally the round brackets were supposed to be preceded only by a space,
- the addition of other fields caused this space to be replaced by new unit
- punctuation. **PLEASE CHECK** if you can accept the changed output.
-- Added `\ifdateannotation`. Added optional argument for field and item to
- `\iffieldannotation`, `\ifitemannotation`, and `\ifpartannotation`.
-- `\DeclareSourcemap` can now be used multiple times.
-- **INCOMPATIBLE CHANGE** Language aliases are now also resolved when loading
- localisation files, only infinite recursion is avoided.
- Assuming `\DeclareLanguageMappingSuffix{-apa}`, loading `ngerman` localisation
- causes `ngerman-apa.lbx` to be read. If that file inherits from `german`,
- `german-apa.lbx` will be read. Previously only `german.lbx` would have been
- read at that point. Of course if `german-apa.lbx` inherits from `german`,
- `german.lbx` is loaded at that point, so infinite recursion is avoided.
-- **CRITICAL CHANGE** The code to load localisation files was changed.
- This is a an internal change and should not influence document output,
- save for a few bug fixes. Style authors should check if the changes introduce
- any bugs for their localisation handling and report them.
-- Added `\begrelateddelim` and `\begrelateddelim<relatedtype>` for punctuation
- before the related block. **PLEASE CHECK** that this change does not interfere
- with your punctuation settings. The change should be backwards compatible,
- but might give different results if `\usebibmacro{related}` is used in
- unusual positions.
-- Added `locallabelwidth` option to control the label spacing in bibliographies,
- if set to true, the label width will be calculated locally for the current
- bibliography and not globally from a list of all citation.
-
-# RELEASE NOTES FOR VERSION 3.10
-- **INCOMPATIBLE CHANGE** The recent ISO8601:201x standard supersedes
- the draft EDTF (Extended Date Time Format) extensions. Biblatex therefore
- now supports the ISO8601-2 Clause 4, Level 1 Extended Format which is
- equivalent to the draft EDTF standard but with different syntax. *This
- syntax is in some cases not backwards compatible*. Biblatex will not
- support backwards compatibility for the draft EDTF syntax because it is
- too messy to do so and few people were using this anyway since it is a
- relatively new and specialised feature. Please note these syntax changes
- which effect only the formatting of DATE fields in bibliography datasources:
- - The "unspecified" marker "u" is now "X"
- - An approximate+uncertain date is now indicated with "%" rather than "?~"
- - Open dates are now marked with ".." instead of "open" or blank
- start/end dates.
- - Unknown dates are now indicated by blank start/end dates rather than
- "unknown" or "*"
-- Unicode support code that is problematic for non-Unicode engines,
- but useful for XeTeX and LuaTeX now resides in `blx-unicode.def`.
- That file is only read by XeTeX and LuaTeX.
-- The option `noerroretextools` demotes the incompatibility error for
- `etextools` to a mere warning if set to `true`. Users still need
- to make sure that `\forlistloop` has the definition from `etoolbox`
- and not the completely incompatible definition from `etextools`.
- This option is meant as a last resort for people who must at all
- costs load `etextools` or a package that uses it.
- `noerroretextools=true` will always cause a warning even if
- `etextools` is not loaded.
-
-# RELEASE NOTES FOR VERSION 3.9
-## Bug fix release
-- Fix `\mkpagetotal`
-- Fix issue with refcontexts not appearing in some circumstances
-- **DEPRECATION NOTICE** The coming update to the ISO8601 standard
- supercedes the draft EDTF (Extended Date Time Format) extensions.
- When the new ISO8601 standard is public, biblatex will therefore
- support the ISO8601-2 Clause 4, Level 1 Extended Format which is
- equivalent to the draft EDTF standard but with different syntax. This
- syntax is in some cases not backwards compatible. Biblatex will not
- support backwards compatibility for the draft EDTF syntax because it is
- too messy to do so and few people were using this anyway since it is a
- relatively new and specialised feature. Please note these syntax changes
- which will effect only the formatting of DATE fields in bibliography
- datasources:
- - The "unspecified" marker `u` is now `X`
- - An approximate+uncertain date is now indicated with `%` rather than `?~`
- - Open dates are now marked with `..` instead of `open` or blank start/end dates.
- - Unknown dates are now indicated by blank start/end dates rather than `unknown` or `*`
-
-# RELEASE NOTES FOR VERSION 3.8a
-## Bug fix release
-- Documentation version fix and loop fix in certain styles
-
-# RELEASE NOTES FOR VERSION 3.8
-## Requirements
-Biber version 2.8 is required for biblatex 3.8
-
-## In order to standardise terminology, some commands and options have dropped the "scheme" naming convention and switched to "template"
-- `\DeclareSortingScheme` is now `\DeclareSortingTemplate`
-- `\DeclareSortingNamekeyScheme` is now `\DeclareSortingNamekeyTemplate`
-- The "sortingnamekeyscheme" option is now "sortingnamekeytemplate"
-
-## `\DeclareLabelalphaNameTemplate` no longer has entrytype scope
-- **INCOMPATIBLE CHANGE** The optional first argument to
- `\DeclareLabelalphaNameTemplate` was previously an entrytype but is now an
- arbitrary template name, as with `\DeclareUniquenameTemplate`. This is to
- allow multiple definitions which can be referred to at different scopes.
- It is unlikely that anyone used this with entrytype scope anyway.
-
-## `origlanguage` is now a list instead of a field.
-- **INCOMPATIBLE CHANGE** Since this is mostly used to generate localisation strings like
- 'Translated from the <language>' via the internal macros `lbx at lfromlang`
- and `\lbx at sfromlang`, users and style authors should not see any
- differences. However, if your style prints `origlanguage` directly using
- `\printfield`, this will need to be changed to `\printlist`.
-
-## Name handling enhancements
-- Name handling is now fully generalised to cover arbitrary name parts.
- The final few pieces have been completed to allow fully customisable
- name handling, allowing for better internationalisation. The code for
- name uniqueness calculation and label generation for names is now fully
- abstracted: templates created with `\DeclareUniquenameTemplate` and
- `\DeclareLabelalphaNameTemplate` may now be specified at per-refcontext,
- per-entry, per-namelist and per-name scope, which allows complete
- control over all aspects of name usage. See the comments in the enhanced
- `93-nameparts.tex` example file.
-
-## `extrayear` is now `extradate` and the information used to track this can be customised
-- **INCOMPATIBLE CHANGE** `extrayear` is called `extradate` now.
- Limited backwards compatibility is
- in place to allow a smooth transition, but style developers should use the new name.
-- The new `\DeclareExtradate` command allows users to track authoryear
- disambiguation in arbitrary ways now, for example allowing disambiguation
- at month or day level instead of just year. See the PDF doc for details.
-- **INCOMPATIBLE CHANGE** Some bibmacros from the `authoryear` style family
- were renamed, `cite:labelyear+extrayear` becomes `cite:labeldate+extradate`,
- `cite:extrayear` is `cite:extradate` now, and `date+extrayear`
- is `date+extradate`. Some backwards compatibility code is present,
- but developers should make sure their code works as expected.
-
-## Date formatting
-- The `mergedate` output has been restored to its earlier form,
- it has also been extended to cover all EDTF date parts.
- In order to facilitate this, a few date-related tests were introduced
- `\iflabeldateisdate`, `\ifdatehasyearonlyprecision`, `\ifdatehastime`
- and `\ifdateshavedifferentprecision`.
-- The `authoryear` citation styles now use `\printlabeldateextra`
- instead of `\printfield{labelyear}\printfield{extrayear}`.
- This should have no consequences for end users (except that
- dates in citations and bibliography don't differ any more -
- previously there were subtle differences when many EDTF features
- were used), but style developers should check if they assume
- anything about the bibmacros that have now changed.
- Style developers are invited to have a look at the changes and
- to get inspired to offer full EDTF format for their styles as well.
-
-## Set handling
-- Static entry sets used to have the behaviour that when citing a member of
- a set, the data for the citation came from the set parent which was in
- turn taken from the first member of the set. In most use cases, the only
- part of the set parent data that was actually used was the labels but in
- certain edge cases, other data was used which results in confusing
- citations for set members. This has been refactored so that when citing
- set members, the member data is used along with some labelling data
- injected from the set parent. This means that things like
- `\citeauthor{somesetmember}` now give the expected results.
- *PLEASE NOTE* that this means that citing sets directly in default styles *not*
- based on labels (`authoryear`, `authortitle`, `verbose` etc.) will result
- in blank citations as it is not envisaged that sets are useful in such
- styles.
-- The members of a set can now be sorted according to the active
- sorting scheme, this is enabled via the `sortsets` option.
- By default the option is set to false and set members appear
- in the order given in the data source.
-- The `alphabetic` style family now also supports the `subentry`
- option.
-
-## Localisation and styles
-- Styles which supply their own location strings in `.lbx` files typically
- use `\DeclareLanguageMapping` to map a document language to the supplied
- language files. This is not ideal because the mapping has to be done by
- the user depending on the specific language. For example, for the APA
- style, in a document using American English, this line is necessary in
- every document:
- ```
- \DeclareLanguageMapping{american}{american-apa}
- ```
- so that the style supplied `america-apa.lbx` file is loaded.
- In a document using the German language, the user would have to use:
- ```
- \DeclareLanguageMapping{german}{german-apa}
- ```
- A new macro `\DeclareLanguageMappingSuffix` is now supplied which allows
- styles to register a global localisation file suffix which is appended to
- any document language automatically. This removes the need for
- `\DeclareLanguageMapping` in user documents as it ensures that the
- correct localisation file will be read nomatter what the document language.
- For example, the APA style (from version v7.5) now has this
- in `apa.bbx`:
- ```
- \DeclareLanguageMappingSuffix{-apa}
- ```
- which means that for a given document language `<lang>`
- the localisation file `<lang>-apa.lbx` will be loaded.
- `\DeclareLanguageMapping`, if present, will override
- `\DeclareLanguageMappingSuffix`.
-
-## Context-sensitive delimiters
-- Several delimiter macros now use the context-sensitive delimiter interface
- introduced in version 3.4 (`\DeclareDelimFormat`). This change is fully
- backwards compatible, but style developers should feel encouraged to use the
- new commands `\DeclareDelimFormat` and `\printdelim`.
-- Three new delimiters are introduced. `authortypedelim`, `editortypedelim`,
- and `translatortypedelim` control the delimiter between the respective name
- and the following `<name>` bibstring.
- This together with `\DeclareFieldFormat{<name>type}` allows one to go from
- 'E. Ditor, ed.' to 'E. Ditor (ed.)' more easily without the need
- to redefine entire bibmacros.
-- `\DeclareDelimAlias` allows one to alias one delimiter to another.
- E.g. `\DeclareDelimAlias{finalnamedelim}{multinamedelim}`
- will make `finalnamedelim` an alias for `multinamedelim`.
- The starred version `\DeclareDelimAlias*` is local to the
- specified contexts.
-
-## Misc changes
-- The initialisation code for `\usedriver` can now be modified via
- `\AtUsedriver`, the code can be executed with `\UseUsedriverHook`.
- The default settings retain backwards compatibility with earlier
- versions.
-- The field `urlraw` contains the unencoded, raw version of the URL.
- If the URL includes Unicode characters, `urlraw` will show them
- unencoded while the standard `url` field will contain them in
- percent-encoded form.
-- `\mkpagetotal` now has its own bibstrings `<pagination>total(s)`
- Previously it relied on the `<pagination>(s)` bibstrings.
-- `sortyear` is now a literal field and not an integer.
-- The `etextools` package is now officially incompatible.
-- `bidi`-support for footnotes was improved.
-- `\ifentryseen`, `\ifentryinbib`, `\ifentrycategory`
- and `\ifentrykeyword` can now be used outside of
- `biblatex` macros directly in the document.
-- `\letbibmacro` can be used to create bibmacro aliases as if
- using `\let`.
-- `\DeprecateFieldWithReplacement`, `\DeprecateListWithReplacement`
- and `\DeprecateNameWithReplacement` can be used to deprecate a field,
- name or list and replace it with a new one.
-
-# RELEASE NOTES FOR VERSION 3.7
-## Requirements
-Biber version 2.7 is required for biblatex 3.7
-
-Bugfix release.
-
-# RELEASE NOTES FOR VERSION 3.6
-## Requirements
-Biber version 2.6 is required for biblatex 3.6
-
-This is a minor bugfix release.
-
-# RELEASE NOTES FOR VERSION 3.5
-## Requirements
-Biber version 2.6 is required for biblatex 3.5
-
-## Name support
-- **INCOMPATIBLE CHANGE** The labelling system has been generalised
- to be able to deal better with names. `\DeclareLabelalphaTemplate` no
- longer uses hard-coded name parts (prefix, family) when extracting label
- parts from name fields. Name field label extraction now obeys the new
- `\DeclareLabelalphaNameTemplate` specification which details how to extract
- label information from each namepart known to the data model. The default
- setting is backwards compatible with the old hard-coded behaviour.
- However, if you have custom `\DeclareLabelalphaTemplate` specifications,
- you should note that the "pcompound" and "pstrwidth" options to `\field`
- are now gone and replaced with the relevant settings on `\namepart` in
- `\DeclareLabelalphaNameTemplate`. The old options will generate warnings.
- It is too complex to provide backwards compat for this, sorry - please
- update your templates if necessary. This is one of the last changes
- needed to fully generalise name handling.
-
-## Date input and output
-Major enhancements to the dates parsed by biblatex and the output formats
-available. Biblatex now supports [[http://www.loc.gov/standards/datetime/pre-submission.html][EDTF]] level 0 and 1. This is an enhanced
-ISO8601v2004 format suitable for bibliographic data. The new support is a
-superset of the previous limited ISO8601 support. Times are now fully
-supported in various formats as online sources become more common and time
-specifications for such sources are increasingly important. Tests and
-localisation strings are provided to use EDTF information about date
-uncertainty, era, approximation etc. in styles. A new example document
-(96-dates.tex) is provided which demonstrates the new features. See the PDF
-manual and its changelog for details of usage. The new date format
-functionality is backwards compatible. The following changes are more
-detailed and mostly of interest to style authors:
-
-- The `iso8601` date output format is now called `edtf`. The old name will
- automatically use `edtf` and issue a deprecation warning.
-- `\bibdatedash` is now `\bibdaterangesep` as this name is more
- informative and more descriptive of how it is actually used. A backwards
- compat alias is provided.
-- Pre-biblatex 2.0 legacy sorting scheme definition macros `\name` and
- `\list` are now deprecated with warnings.
-- **INCOMPATIBLE CHANGE** The `labeldate` option is renamed to
- `labeldateparts`. The `datelabel` option is renamed to `labeldate` to
- provide consistency with all other date options. Backwards compatibility
- is provided and warnings will be issued.
-- The new date system necessitated changes to the default year printing
- routine for citations in the default authoryear styles. If you wish to
- take advantage of the new date features like circa, uncertainty and eras,
- when printing citations in authoryear styles, see the enhanced
- `cite:labelyear+extrayear` macros in any of the default authoryear
- styles.
-- The `labelyear` field was inconsistently implemented and in fact could
- sometimes contain a date range which made handling it rather difficult.
- It is now guaranteed to contain only one year, when it is a copy of an
- existing datepart field found by `\DeclareLabeldate` (`labelyear` can
- contain a literal/bibstring or non date field too). A new field
- `labelendyear` will contain the end of the labeldate year range. The same
- applies to labelmonth and labelday.
-- The internal macros `\mkbibrange*` have all been changed to
- `\mkdaterange*` to make the name more obvious (since they only deal with
- dates) and for consistency with the new `\mktimerange*` macros. These
- macros are usually only used in style .lbx files and the old names will
- generate a deprecation warning.
-- The option `datezeros` was inconsistent as it did not enforce zeros when
- set to 'true', it merely preserved the field. In the new date internals,
- leading zeros are not present after date parsing as this should always be
- a formatting/style decision. Now, `datezeros` enforces leading zeros and
- also handles all date parts.
-- `\mkdatezeros` has been replaced with `\mkyearzeros`, `\mkmonthzeros` and
- `\mkdayzeros` due to the date internals changes which are more consistent
- about integer formats of date parts. `\mkdatezeros` now generates a
- deprecation warning and calls `\mkmonthzeros` which is backwards compatible
- with its old behaviour.
-- **INCOMPATIBLE CHANGE** The .bbl field `datelabelsource` has been renamed to
- `labeldatesource` to prevent confusion with other fields. In the unlikely
- event that you referenced this field in a style, please change the name.
-- **INCOMPATIBLE CHANGE** The macro `\printdatelabel` has been renamed to
- `\printlabeldate` in line with the naming of all other date printing
- macros. Please use the new name. The old one will issue a deprecation warning.
-- **INCOMPATIBLE CHANGE** The macro `\printdatelabelextra` has been renamed to
- `\printlabeldateextra` in line with the naming of all other date printing
- macros. Please use the new name. The old one will issue a deprecation warning.
-
-## Misc changes
-- The experimental RIS format support is no longer available as it was
- rarely used and made biber maintenance more complicated. RIS is a very
- primitive format and not much use anyway.
-- **INCOMPATIBLE CHANGE** The `singletitle` option no longer considers the
- presence of labeltitle if labelname does not exist. This has always been
- potentially confusing. For several versions now, there has been a
- separate test and option for labeltitle called "uniquetitle".
-- **INCOMPATIBLE CHANGE** The `sortgiveninits` option has been deprecated and
- the functionality generalised. It is replaced by the "inits" option to
- `\namepart` in `\DeclareSortingNamekeyScheme`. Any nameparts may now
- therefore be sorted using initials only.
-- **INCOMPATIBLE CHANGE** The sorting subsystem in biber has been completely
- re-engineered to support better sorting of different datatypes.
- Previously, due to bibtex limitations, all sorting was lexical, even for
- numbers. This is why the padding options for things like volume in the
- default sorting specifications existed - so that lexical sorts for
- numbers would work. With the enhancement of the date parsing routines to
- include negative years, in order to sort these properly, it was time to
- switch to a better sorting method. As a result, the datatypes of fields
- is now a bit stricter, as it should be. Expect more changes in this
- direction but for this release, the datatype of the following fields in
- the default data model have been changed to 'integer':
-
- - number
- - sortyear
- - volume
- - volumes
-
- Integer datatypes no longer need padding or literal fallbacks in the
- sorting scheme definitions since they are now sorted properly as
- integers. Such datatype changes only effect sorting.
-
-
Added: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES.md
===================================================================
--- branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES.md (rev 0)
+++ branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES.md 2023-03-08 21:39:33 UTC (rev 66481)
@@ -0,0 +1,986 @@
+# RELEASE NOTES FOR VERSION 4.0
+ - This is a major update with support for multiscript entryfields
+ - **INCOMPATIBLE CHANGE** Default name list and plain list formats declared
+ with \DeclareNameFormat and \DeclareListFormat respectively have been
+ modified to support per-item language switching via the macros:
+
+ name:langswitchon/name:langswitchoff
+ list:langswitchon/list:langswitchoff
+
+ If you use or provide custom name/list formats, you may want to look at
+ the format definitions in biblatex.def to see where to place these in
+ your custom formats in order to provide multiscript support for
+ per-item automatic language switching. Nothing will break if you don't
+ do this but there may be a loss of some aspects of multiscript
+ functionality. In general, you should place the "on" macros *after*
+ name:delim/list:delim and the "off" macros at the end of the format.
+- **INCOMPATIBLE CHANGE** Data annotation test macros \if*annotation,
+ \has*annotation and \get*annotation now have multiscript form and
+ language as optional arguments in position 1 and 2, therefore, if you
+ are using these macros with any optional arguments, be sure to supply
+ the first two arguments (as "[][]"). For example:
+
+ \getitemannotation[somefield] -> \getitemannotation[][][somefield]
+ \ifpartannotation[][someannotationname][2]{family}{someval} ->
+ \ifpartannotation[][][][someannotationname][2]{family}{someval}
+- **INCOMPATIBLE CHANGE** Namelist-specific hashes of the form
+ <namelist>namehash, <namelist>bibnamehash or <namelist>fullhash now must
+ contain a multiscript form and language in order to differentiate
+ between multiscript name alternates. The format is now
+ <namelist><msform><mslang>namehash,
+ <namelist><msform><mslang>bibnamehash or
+ <namelist><msform><mslang>fullhash and biber 4.0+ always generates specific
+ name hashes in this format.
+# RELEASE NOTES FOR VERSION 3.19
+- Added `\AtNextRefsection`.
+- Added `\DeclareExtradateContext`.
+
+# RELEASE NOTES FOR VERSION 3.18b
+- Reenable `\MakeUppercase`/`\MakeLowercase` "patches" for `\bibstring`
+ based on `\CaseSwitch`.
+
+# RELEASE NOTES FOR VERSION 3.18a
+- Disable `\MakeUppercase`/`\MakeLowercase` patches as emergency fix
+ for LaTeX 2022-06-01-PL4 compatibility.
+
+# RELEASE NOTES FOR VERSION 3.18
+- New sorting name key generation macro `\visibility` which allows
+ application of sorting name key generation to apply only to sorting
+ within citations.
+- New sorting macro `\intciteorder` which allows sorting by order internal
+ to a cite command like \cite{a,b,c}.
+- New option `pluralothers` to force "et al." to be plural (i.e. only
+ replace two or more names). This is required for some styles (e.g. APA)
+- Added `\localrefcontext` as a local alternative
+ to the global `\newrefcontext`.
+ `\localrefcontext` can be nested and is only active in the current group.
+
+# RELEASE NOTES FOR VERSION 3.17
+- **INCOMPATIBLE CHANGE**
+ The behaviour of index-less granular xdata references to list fields has
+ changed. Before, a reference to an XDATA list field would select the
+ first element in the XDATA field list if no index was given but now this
+ will splice in all elements of the XDATA list field. To ensure the
+ previous behaviour, simply add "-1" (assuming the default value of "-"
+ for the biber 'xdatasep' option) to the end of all granaular list
+ XDATA references.
+- Added helper macros to enable calculations with non-ASCII numerals.
+ This is necessary to properly support languages like Marathi.
+ At the moment the 'translation' is very basic and uses a one-to-one
+ correspondence of US-ASCII (Arabic) digits and non-ASCII digits.
+ The translation also needs additional post-processing steps.
+ Use `\blx at defcomputableequivalent{<numeral digit>}{<ASCII digit>}` to
+ make `<numeral digit>` an equivalent of `<ASCII digit>`
+ (presumably this command will be used in `.lbx` files if the language
+ requires it).
+ `\hascomputableequivalent{<string>}` can be used to check if `<string>`
+ is a number that can be converted to a number with ASCII digits.
+ `\getcomputableequivalent{<string>}{<macro>}` does the conversion
+ and saves the number in `<macro>`.
+ There is `\ifiscomputable{<string>}` to check if a `<string>`
+ is an ASCII number OR has a computable equivalent.
+ There are analogous macros for fields instead of strings.
+- Added `\textouterlang` to select the last active language that
+ was not selected by `biblatex` itself.
+ This may help in multilingual setups where `biblatex` also changes the
+ language quite heavily.
+- Added `\DeclareBibstringSet`, `\DeclareBibstringSetFormat` etc.
+ to allow injecting additional formatting for a set of bibstrings.
+ Sets can be defined arbitrarily. These commands are primarily
+ intended for use in localisation modules.
+- Changed the definition of `\bibnamedelimi` to `\isdot\addnbspace`.
+ Previously the definition was just `\addnbspace`, which meant the `.`
+ would be treated as a period/full stop.
+- **BREAKING CHANGE**
+ `\DeclareDelimFormat` no longer accepts a list of names as argument.
+ It only accepts a single delimiter name.
+ A list of contexts is still supported.
+ Note that previously the optional argument would not work correctly
+ with a list of names.
+- **CRITICAL CHANGE**
+ `biblatex` no longer writes tracking and refsection initialisation code
+ to aux files.
+ Instead the `\...cite` commands are redefined locally to do that on demand.
+ This should keep the auxiliary files much cleaner of `biblatex`
+ intervention.
+- **CRITICAL CHANGE**
+ Generalised `season` date part to `yeardivision`. It can now also
+ hold quarter, quadrimester, semestral or seasons with hemisphere
+ designation.
+ Helper macros have been renamed accordingly. Limited backwards
+ compatibility is in place.
+- **(Possibly) CRITICAL CHANGE**
+ `\notecite` and friends no longer issue an explicit `\nocite`.
+ Since the commands are defined with `\DeclareCiteCommand`, they
+ already issue a normal cite request.
+ The additional `\nocite` from the loop code was superfluous
+ and would result in slightly instable `.bcf` files.
+
+
+# RELEASE NOTES FOR VERSION 3.16
+- Fixed an infinite loop caused by excessive aliasing of the `volcitepages`
+ format.
+ Reverted the alias `\DeclareFieldAlias{volcitepages}{postnote}`
+ and again define
+ ```
+ \DeclareFieldFormat{volcitepages}{\mkpageprefix[pagination][\mknormrange]{#1}}
+ ```
+ explicitly.
+# RELEASE NOTES FOR VERSION 3.15b
+- Fixed `.lbx` file loading behaviour. All `.lbx` files are now loaded
+ `\AtBeginDocument`. Languages that were not requested explicitly by packages
+ are recorded in the `.aux` file and loaded on the next run.
+ This may require a further LaTeX run in some situations, but now we can be
+ sure when `.lbx` files are read.
+- Added `label` option to `\printbibliography`.
+- Added more name wrapper aliases to make name aliasing smoother.
+- Deprecate `\mainlang` switch in favour of the text macro `\textmainlang`.
+- Deprecate `\mkrelatedstring` (which is defined as `\mainlang`)
+ in favour of `\mkrelatestringtext` (defined as `\textmainlang`).
+
+# RELEASE NOTES FOR VERSION 3.15a
+- Fixed bug with long argument for `\DeclareFieldFormat` and friends.
+
+# RELEASE NOTES FOR VERSION 3.15
+- Fixed a long-standing issue with `\intitlepunct`.
+ The old definition
+ ```
+ \newbibmacro*{in:}{%
+ \printtext{%
+ \bibstring{in}\intitlepunct}}
+ ```
+ would print `\intitlepunct` directly and not via the punctuation
+ buffer. Since the `\add...` punctuation macros guard against
+ undesired double punctuation, this would usually not show as an
+ issue (except in edge cases https://tex.stackexchange.com/q/175730/,
+ https://github.com/plk/biblatex/issues/943).
+ The new definition uses the punctuation tracker to print
+ `\intitlepunct`.
+ ```
+ \newbibmacro*{in:}{%
+ \bibstring{in}%
+ \printunit{\intitlepunct}}
+ ```
+ `\printunit` is needed instead of `\setunit` to stop subsequent
+ `\setunit`s from overriding `\intitlepunct` in case of missing
+ fields.
+- Define `volcitepages` and `multipostnote` as a field alias of `postnote`
+ and `multiprenote` as an alias of `prenote`.
+ That should make it easier to change all post- and prenote formats at once.
+ A change to `postnote` will automatically apply to `multipostnote`
+ and `volcitepages` as well. Similarly for `multiprenote`.
+ In case that is not desired, the original definitions can be restored with
+ ```
+ \DeclareFieldFormat{volcitepages}{\mkpageprefix[pagination][\mknormrange]{#1}}
+ \DeclareFieldFormat{multiprenote}{#1\isdot}
+ \DeclareFieldFormat{multipostnote}{\mkpageprefix[pagination][\mknormrange]{#1}}
+ ```
+
+ **NB** The definition of `volcitepages` caused an infinite loop and was
+ reverted in v3.15b.
+ This means that only `multiprenote` and `multipostnote` are aliased.
+- Unified DOI, eprint and URL printing across all entry types.
+ The fields `doi`, `eprint`, `eprintclass`, `eprinttype` and `url`
+ are now valid for all entry types.
+ `@online` and `@unpublished` now also use the bibmacro
+ `doi+eprint+url`.
+ This means `@online` now responds to the `url` option.
+ That does not mean, however, that a global `url=false,`
+ suppresses URLs for `@online` entries, since `url=true,`
+ is set on a per-type level to ensure backwards compatibility
+ as far as possible.
+ In case eprint information should be suppressed for `@online`
+ and `@unpublished`, add
+ ```
+ \ExecuteBibliographyOptions[online,unpublished]{eprint=false}
+ ```
+- Added `eid` to more entry types.
+ To avoid issues with backwards compatibility of widely used bibmacros,
+ the bibmacro `chapter+pages` was redefined from
+ ```
+ \newbibmacro*{chapter+pages}{%
+ \printfield{chapter}%
+ \setunit{\bibpagespunct}%
+ \printfield{pages}%
+ \newunit}
+ ```
+ to
+ ```
+ \newbibmacro*{chapter+pages}{%
+ \printfield{chapter}%
+ \setunit{\bibeidpunct}%
+ \printfield{eid}%
+ \setunit{\bibpagespunct}%
+ \printfield{pages}%
+ \newunit}
+ ```
+- Added `\bibeidpunct` in analogy to `\bibpagespunct`.
+- Added `issuetitleaddon` and `journaltitleaddon` fields.
+- Added options `backreffloats` and `trackfloats` to enable/disable
+ citation tracking and back references in floats.
+ Note that citation tracking in floats can lead to undesirable
+ results in case the float objects floats too far from its "natural"
+ position.
+- **INCOMPATIBLE CHANGE** `numeric-comp` compresses subentry set
+ references now.
+ This behaviour can be disabled with `subentrycomp=false`.
+- Added `subentrycomp` option to `numeric-comp` citation style.
+ The option is only relevant with `subentry=true`.
+ With `subentrycomp=true` set citations will be compressed
+ to "1a-c" instead of "1a; 1b; 1c".
+ The option is mainly intended for backwards compatibility;
+ the behaviour of previous `biblatex` versions can be restored
+ with `subentrycomp=false`.
+- Added `\multiciterangedelim`, `\multicitesubentrydelim`,
+ `\multicitesubentryrangedelim`, `\superciterangedelim`,
+ `\supercitesubentrydelim`, and `\supercitesubentryrangedelim` for
+ finer control over (compressed) subentry citations in `numeric-comp`.
+- **CRITICAL CHANGE**
+ The structure of the bibmacros in `numeric-comp`
+ has been reworked to make it easier to customise the printed output.
+ Documents that relied on patching internal bibmacros or heavily
+ redefined them may have to adapt.
+- **CRITICAL CHANGE**
+ Implemented better `@set` support for BibTeX, `@set`s should now
+ sort properly.
+ This is achieved with a two-pass structure and (hidden) copies of
+ the set entries.
+ The two-pass structure means that the compilation sequence becomes
+ LaTeX, BibTeX, LaTeX, BibTeX, LaTeX, LaTeX.
+- **CRITICAL CHANGE**
+ The case change functions now make use of the `expl3` module `l3text`
+ if the available `expl3` version is recent enough.
+ If `expl3` is too old the old LaTeX2e implementation is used.
+ If desired the implementation of the case changing functions
+ can be selected at load-time with the `casechanger` option, which
+ accepts the values `expl3`, `latex2e` and `auto` (which selects
+ `expl3` if the `expl3` version not older than 2020-04-06, this
+ is the default).
+
+ The `expl3` implementation of the case changer is slightly more
+ robust than the home-grown `latex2e` code.
+- The option `bibtexcaseprotection` can be used to turn off the
+ case protection via curly braces. This allows for a saner approach
+ to case protection where text is protected solely via a macro
+ like `\NoCaseChange`, e.g.
+ ```
+ title = {The Story of \NoCaseChange{HMS \emph{Erebus}}
+ in \emph{Really} Strong Wind},
+ ```
+ instead of
+ ```
+ title = {The Story of {HMS} \emph{Erebus}
+ in {\emph{Really}} Strong Wind},
+ ```
+- Added `\mautocite` and `\Mautocite`.
+- Added `\NumsCheckSetup` and `\PagesCheckSetup` for finer control
+ of the `\ifnumerals` and `\ifpages` checks.
+- Deprecate the starred `\DeclareDelimAlias*` in favour of
+ `\DeclareDelimAlias` with optional arguments.
+- **INCOMPATIBLE CHANGE**
+ `biblatex` no longer falls back to English for unknown languages.
+ Warnings will be triggered if undefined language strings or extras
+ are used.
+- **INCOMPATIBLE CHANGE**
+ Bibliography strings and bibliography extras can now be written
+ either to `\captions<language>` or to `\extras<language>`
+ (this is controlled with the `langhook` option).
+ Previously, they were written to `\extras<language>`, but upon
+ reflection `\captions<language>` appears to be a more sensible
+ place for these definitions.
+ The new default is to write to `\captions<language>`
+ (i.e. `langhook=captions`).
+ The previous behaviour can be restored with `langhook=extras`.
+- **INCOMPATIBLE CHANGE** Moved `\delimcontext{bib}` to `\AtUsedriver`,
+ this makes it easier to override the delimiter context in `\usedriver`
+ calls. `\AtUsedriver*` calls may have to be amended to include
+ `\delimcontext{bib}`. The new default is
+ ```
+ \AtUsedriver{%
+ \delimcontext{bib}%
+ \let\finentry\blx at finentry@usedrv
+ \let\newblock\relax
+ \let\abx at macro@bibindex\@empty
+ \let\abx at macro@pageref\@empty}
+ ```
+ Note that this definition is backwards compatible
+ and can be used in older versions as well (down to v3.4 2016-05-10).
+- `biblatex` now tests if a requested backend (re)run happened by
+ comparing the MD5 hashes of the new and old `.bbl` files.
+- Added file hooks `\blx at filehook@preload@<filename>`,
+ `\blx at filehook@postload@<filename>`
+ and `\blx at filehook@failure@<filename>`
+ to execute hooks before or after a file is loaded
+ or if the loading fails.
+ `\blx at lbxfilehook@simple at preload@<filename>`,
+ `\blx at lbxfilehook@simple at postload@<filename>`
+ and `\blx at lbxfilehook@simple at failure@<filename>`
+ as well as
+ `\blx at lbxfilehook@once at preload@<filename>`,
+ `\blx at lbxfilehook@once at postload@<filename>`
+ and `\blx at lbxfilehook@once at failure@<filename>`
+ are the equivalents for `.lbx` loading, where
+ files may be loaded several times in some situations.
+- Added limited support for 'nodate' with BibTeX.
+- Improved `babel` and `polyglossia` interfacing (avoids more or less
+ unsupported patches).
+ This should work with `babel` at least v3.9r (2016/04/23)
+ and polyglossia `polyglossia` v1.49 (2020/04/08) or later.
+- **INCOMPATIBLE CHANGE** Removed list and name index wrappers
+ (`\DeclareIndexNameWrapperFormat`, `\DeclareIndexListWrapperFormat`
+ and friends). Those wrappers make no sense, since the indexed
+ names are not printed 'together' in any useful sense of the word
+ and were never working anyway.
+- **CRITICAL CHANGE** Generalised some keyval macros.
+ `biblatex`-related uses of `\define at key` should ideally replaced with
+ `\blx at kv@defkey`.
+ Style authors are advised not to rely too much on the internal
+ implementation of certain keyval interfaces.
+ Users who want to experiment with using a different underlying
+ keyval parser need only provide replacements of the `\blx at kv@...`
+ macros (which are defined via `\provide...` so that they will
+ not overwrite existing definitions; in particular users can define
+ those replacements before loading `biblatex`).
+- Deprecate `\ifkomabibtotoc` and `\ifkomabibtotocnumbered`.
+ With newer versions of KOMA-Script these tests are no longer used
+ and their implementation was always a bit shifty (they would only pick
+ up globally set options).
+
+
+# RELEASE NOTES FOR VERSION 3.14
+- biber from version 2.14 has extended, granular XDATA functionality to
+ allow referencing from and to parts of fields. This makes XDATA entries into
+ more general data sharing containers.
+- Biber applies Perl's Unicode case folding to normalise the
+ capitalisation of field names and entry types when reading from the
+ `.bib` file. The output in the `.bbl` (what comes out on the
+ `biblatex` side uses the capitalisation from the data model; the only
+ exception are unknown entry types which are passed on *exactly*
+ as they are given in the `.bib` file - of course it is strongly
+ recommended to define all entry types one intends to use in the
+ data model).
+- `biblatex` now interfaces with `polyglossia` much better and can deal
+ with language variants.
+ Note that `polyglossia` v1.45 (2019/10/27) is required for this
+ to work properly, it is strongly recommended to update `polyglossia`
+ to this or a later (current) version.
+
+# RELEASE NOTES FOR VERSION 3.13
+- **INCOMPATIBLE CHANGE** Any custom per-entry options in datasources must
+ be defined with `\DeclareEntryOption` in order for biber to recognise
+ them and pass them out in the `.bbl`.
+ This should not adversely affect any code using the documented
+ `\Decalare...Option` interface, so should be uncritical for most users.
+- Added `\DeclareBiblatexOption` as a convenient interface to declare the same
+ option in different scopes. This should help avoid code duplication.
+ For example
+ ```
+ \DeclareBibliographyOption[boolean]{noroman}[true]{%
+ \settoggle{blx at noroman}{#1}}
+ \DeclareTypeOption[boolean]{noroman}[true]{%
+ \settoggle{blx at noroman}{#1}}
+ \DeclareEntryOption[boolean]{noroman}[true]{%
+ \settoggle{blx at noroman}{#1}}
+ ```
+ can be replaced with
+ ```
+ \DeclareBiblatexOption{global,type,entry}[boolean]{noroman}[true]{%
+ \settoggle{blx at noroman}{#1}}
+ ```
+- Following the introduction of `\DeclareBiblatexOption` extend the scope
+ of a few options (`abbreviate`, `citetracker`, `clearlang`, `dataonly`,
+ `dateabbrev`, `<namepart>inits`, `ibidtracker`, `idemtracker`, `labelalpha`,
+ `labelnumber`, `labeltitle`, `labeltitleyear`, `labeldateparts`,
+ `loccittracker`, `opcittracker`, `singletitle`, `skipbib`, `skipbiblist`,
+ `skipbiblab` `terseinits`, `uniquelist`, `uniquename`, `uniquetitle`,
+ `uniquebaretitle`, `uniquework`, `uniqueprimaryauthor`).
+- Furthermore, the standard style options `doi`, `eprint`, `isbn`, `url`,
+ `related` are now available also on a per-type and per-entry level.
+ The same holds for `mergedate`, `subentry` and the options of `reading.bbx`.
+ This change has the potential to clash with custom styles that already define
+ the standard options at these scopes.
+- Promote `@software` to regular entry type and define `@dataset`.
+ `@software` is aliased to the `@misc` driver,
+ `@dataset` has a dedicated driver.
+- Add `\ifvolcite` test to check if the current citation is in a `\volcite`
+ context.
+- Add the special fields `volcitevolume` and `volcitepages` for finer control
+ over the `\volcite` postnote.
+- Add `\AtVolcite` hook to initialise `\volcite` commands.
+- Add `\mkbibcompletename` as well as `\mkbibcompletename<formatorder>`
+ to format complete names.
+ The commands are analogous to `\mkbibname<namepart>` but apply to
+ the entire name printed in format order `<formatorder>`.
+ By default the predefined macros all expand to `\mkbibcompletename`.
+- Add `multiprenotedelim` and `multipostnotedelim` and make all
+ `(pre|post)notedelim`-like commands context sensitive.
+- Add rudimentary support for `labelprefix` with BibTeX backend.
+ Biber implements `labelprefix` via `refcontext`s, but BibTeX does not
+ actually support `refcontext`s. The user interface is retained, but BibTeX's
+ "`refcontext`s" support only the emulation of `labelprefix` and nothing more.
+ There might be subtle differences between Biber's and BibTeX's
+ `labelprefix` behaviour, but it should be better than nothing.
+ If you need full `labelprefix` support, please consider switching to Biber.
+- Add `\thefirstlistitem`, `\strfirstlistitem` and `\usefirstlistitem` to
+ grab and use the first item of a field.
+- Add `\isdot` to the format for `journaltitle` so that `.`s at the end of the
+ `journal(title)` field are automatically treated as abbreviation dots and not
+ sentence-ending periods. To restore the old behaviour add
+ ```
+ \DeclareFieldFormat{journaltitle}{\mkbibemph{#1}}
+ ```
+ to the preamble.
+- Add second optional item post processing argument to `\mkcomprange`,
+ `\mknormrange` and `\mkfirstpage`. It can be used to post process
+ every number item in the formatted range separately. It can for
+ example turn cardinal ranges into ordinal ranges (this is done in
+ the Latvian localisation module).
+- Add further customisation options for strings typeset with `url`'s `\url`
+ command (mainly URLs and DOIs). It is now possible to add a bit of
+ stretchable space after characters with `biburlnumskip`, `biburlucskip`
+ and `biburlucskip`. The previously hard-coded (stretacheble) space
+ `\biburlbigskip` as well as the penalties `biburlbigbreakpenalty` and
+ `biburlbreakpenalty` are also configurable now.
+- Add `\DeclarePrintbibliographyDefaults` to set default values for some
+ option keys to `\printbibliography` and friends.
+- `\nocite` is now enabled in the bibliography (previously it was
+ deactivated in the bibliography).
+ Please report any issues that this may cause.
+- The internals macros `\abx at aux@cite`, `\abx at aux@refcontext`
+ and `\abx at aux@biblist` are now called every time an entry is cite
+ (and appears in a bibliography or biblist, respectively).
+ This helps to avoid unwanted side-effects when writing to aux files
+ is disabled.
+- `\nohyphenation` and `\textnohyphenation` now rely on a (fake)
+ language without hyphenation patterns instead of `\lefthyphenmin`,
+ which means that the command can now be used anywhere in a paragraph,
+ see also <https://texfaq.org/FAQ-hyphoff>.
+ Note that switching languages with `babel` *within* those commands
+ removes the hyphenation protection.
+- Allow `doi` field for `@online` entries. This field was previously
+ not printed in the `@online` driver. In case DOIs appear where
+ they should not appear the output of earlier versions can be
+ recreated with
+ ```
+ \ExecuteBibliographyOptions[online]{doi=false}
+ ```
+ since the `doi` option is now available on a per-type level.
+
+
+# RELEASE NOTES FOR VERSION 3.12
+- **INCOMPATIBLE CHANGE** The syntax for defining data annotations in the
+ BibLaTeXML data source format has changed to accommodate named
+ annotations. Annotations are no longer attributes but are fully-fledged
+ elements. It is not expected that this will impact any current users.
+- **INCOMPATIBLE CHANGE** The field/fieldset argument to the `\translit`
+ command is now mandatory to allow for a new optional argument which
+ restricts transliteration to entries with particular `langid` fields.
+- The field `sortyear` is an integer field now and not a literal. This is
+ because the `sortX` fields should be the same datatype as the `X` field
+ as sorting depends on this. This fixes an issue where years were not
+ sorted properly as integers. `sortyear` was sometimes used to tune date
+ sorting as in "1984-1", "1984-2" etc. for multi-volume collections with
+ the same year. However, this is really an abuse of the sorting template
+ system since this should be done by having a semantically more granular
+ sorting item to differentiate below the year level (typically, `volume`
+ does this for multi-volume works and this is already part of all default
+ sorting templates). The example .bib that comes with biblatex has been
+ changed to remove such `sortyear` abuses and the sorting is not impacted
+ as they examples using this already have either `volume` or `sorttitle`
+ which made this abuse of `sortyear` unnecessary anyway.
+- The field `number` is a literal field now and not an integer. This allows for
+ a wider range of possible input such as "S1", "Suppl. 1", "1-3".
+ If you want to sort by `number` and only have integers in there, you should
+ consider using a custom data model to turn `number` back into an integer type
+ field, since sorting integers as literals has performance implications and
+ might lead to undesired sorting such as "1", "10", "2".
+- **INCOMPATIBLE CHANGE** Removed the 'semi-hidden' option `noerroretextools`.
+ If you want to load `noerroretextools` now, you need to define the macro
+ `\blx at noerroretextools` instead. This can for example be done with
+ ```
+ \usepackage{etoolbox}
+ \cslet{blx at noerroretextools}\empty
+ \usepackage{biblatex}
+ ```
+ or
+ ```
+ \makeatletter
+ \let\blx at noerroretextools\@empty
+ \makeatother
+ \usepackage{biblatex}
+ ```
+ You still need to make sure that all macros used by `biblatex` are restored
+ to their `etoolbox` definitions before loading `biblatex`.
+- New macro `\abx at missing@entry` to style missing entrykeys in citations.
+- Added field format deprecation macros `\DeprecateFieldFormatWithReplacement`
+ and friends.
+- Add `\ifdateyearsequal` to check if two dates have the same year and era
+ date part. Since `year`s are always non-negative integers and the 'sign' is
+ stored as the `era`, you should use `\ifdateyearsequal` instead of a simple
+ `\iffieldequals{#1year}{#2year}` to compare years. The latter can lead to
+ undesired results if the years have opposite signs, but are otherwise the
+ same.
+- New values `part+`, `chapter+`, `section+` and `subsection+` for 'section'-
+ valued options `refsection`, `refsegment` and `citereset`. These options
+ are then executed at not only the specified level of sectioning, but also
+ all higher levels.
+- Add second optional argument to `\DeclareDelimAlias*`.
+- Allow keywords for dataonly/skipped entries as well.
+- Added `maxcitecounter`.
+- Deprecate `\labelnamepunct` in favour of the context-sensitive
+ `nametitledelim`.
+ For compatibility reasons `\labelnamepunct` still pops up in the code here
+ and there, but `nametitledelim` should be preferred now.
+- The `xstring` package is not loaded by default any more.
+ Style developers whose styles make use of that package should load it
+ explicitly.
+- `authoryear.bbx` now has a macro `bbx:ifmergeddate` that can be used to
+ check whether the date has been printed at the beginning of an entry
+ and can thus be suppressed later in the `date` and `issue+date` macros.
+ The macro works like a test and expands to the `<true>` branch if the date
+ has been merged and can be suppressed, it expands to `<false>` if the date
+ has not been merged. In practice `\printdate` should then be issued
+ if and only if the test yields false.
+
+ This change means that the definition of the `date` macro can be the same for
+ all mergedate settings and that only `bbx:ifmergeddate` is redefined for
+ each different value. No backwards compatibility issues are expected,
+ but style authors are encouraged to test the changes and see if the new
+ macro could be useful for their styles.
+- For a long time `biblatex` has defined `\enquote` if `csquotes` was not
+ loaded. This behaviour was not documented, the official command intended
+ for quotation marks was always `\mkbibquote`. Because `biblatex` should not
+ (re)define user-level commands that are not primarily associated with
+ citations or the bibliography, from this release on `\enquote` is not defined
+ any more, instead the internal command `\blx at enquote` is defined and used.
+ The same holds for `\initoquote`, `\initiquote`, `\textooquote`,
+ `\textcoquote`, `\textoiquote`, `\textciquote`.
+ `biblatex` still defines the internal commands `\@quotelevel`, `\@quotereset`
+ and `\@setquotesfcodes` if `csquotes` is not loaded.
+
+ Users are encouraged to use `csquotes` for proper quotation marks, but can
+ get back the old behaviour with
+ ```
+ \makeatletter
+ \providerobustcmd*{\enquote}{\blx at enquote}
+ \makeatother
+ ```
+ or
+ ```
+ \newrobustcmd*{\enquote}{\mkbibquote}
+ ```
+- Add new list wrapper and name wrapper formats (`\DeclareListWrapperFormat`,
+ `\DeclareNameWrapperFormat`) to style a (name) lists in its entirety.
+ This is useful because name and lists formats normally style only one
+ particular item of the list. The wrapper format can be used to easily format
+ the entire list in italics, for example.
+- `\DeclareCitePunctuationPosition` can be used to configure the punctuation
+ position for citation commands similar to the optional `position` argument
+ of `\DeclareAutoCiteCommand`.
+- If the `\pdfmdfivesum` primitive is available (via `pdftexcmds`'
+ `\pdf at mdfivesum`) the `labelprefix` value is hashed for internal use, making
+ it safer for construction of macro names and the like. If you don't like
+ that you can turn off the behaviour by redefining `\blx at mdfivesum`. The
+ fallback in case `\pdf at mdfivesum` is unavailable is
+ ```
+ \let\blx at mdfivesum\@firstofone
+ ```
+
+ As before the labelprefix value is fully expanded before use. If its contents
+ are unexpandable you need to avoid expansion with `\detokenize`.
+
+# RELEASE NOTES FOR VERSION 3.11
+- `\printbiblist` now supports `driver` and `biblistfilter` options
+ to change the defaults set by the biblistname.
+- Add `\mknormrange` to normalise page ranges without compressing them.
+- **INCOMPATIBLE CHANGE** The format for `postnote` (`multipostnote`,
+ `volcitepages`) normalises page ranges with `\mknormrange`.
+ Since `\mknormrange` acts only on page ranges as detected by
+ `\ifpages`, this does not affect text other than page ranges.
+ Hyphens and dashes in page ranges will be transformed to
+ `\bibrangedash`, commas and semicolons to `\bibrangesep`.
+ This is analogous to Biber's treatment of page-like fields.
+ If you always separated page ranges with `--` or `\bibrangedash`
+ anyway, this should not change the output you get.
+ If you used a single hyphen to separate page ranges (e.g., `23-27`)
+ you will now get the arguably more aesthetically pleasing output
+ with `\bibrangedash`.
+ In case you want to restore the old behaviour where page ranges were
+ not normalised add the following three lines to your preamble.
+ ```
+ \DeclareFieldFormat{postnote}{\mkpageprefix[pagination]{#1}}
+ \DeclareFieldFormat{volcitepages}{\mkpageprefix[pagination]{#1}}
+ \DeclareFieldFormat{multipostnote}{\mkpageprefix[pagination]{#1}}
+ ```
+ Style developers may note that the field format for `pages`
+ was not changed to include `\mknormrange` because the contents
+ of that field are prepared by the backend and Biber already does
+ the page range normalisation out of the box.
+- The standard definitions for headings were changed to be as close to the
+ defaults of the standard document classes or KOMA/memoir as possible.
+ **PLEASE CHECK** if your document headers relied on the behaviour of older
+ versions.
+- The `@unpublished` entry type now also supports `type`, `eventtitle`,
+ `eventdate` and `venue`.
+- A long-standing bug with punctuation before `eventdate` and `venue` was fixed.
+ Originally the round brackets were supposed to be preceded only by a space,
+ the addition of other fields caused this space to be replaced by new unit
+ punctuation. **PLEASE CHECK** if you can accept the changed output.
+- Added `\ifdateannotation`. Added optional argument for field and item to
+ `\iffieldannotation`, `\ifitemannotation`, and `\ifpartannotation`.
+- `\DeclareSourcemap` can now be used multiple times.
+- **INCOMPATIBLE CHANGE** Language aliases are now also resolved when loading
+ localisation files, only infinite recursion is avoided.
+ Assuming `\DeclareLanguageMappingSuffix{-apa}`, loading `ngerman` localisation
+ causes `ngerman-apa.lbx` to be read. If that file inherits from `german`,
+ `german-apa.lbx` will be read. Previously only `german.lbx` would have been
+ read at that point. Of course if `german-apa.lbx` inherits from `german`,
+ `german.lbx` is loaded at that point, so infinite recursion is avoided.
+- **CRITICAL CHANGE** The code to load localisation files was changed.
+ This is a an internal change and should not influence document output,
+ save for a few bug fixes. Style authors should check if the changes introduce
+ any bugs for their localisation handling and report them.
+- Added `\begrelateddelim` and `\begrelateddelim<relatedtype>` for punctuation
+ before the related block. **PLEASE CHECK** that this change does not interfere
+ with your punctuation settings. The change should be backwards compatible,
+ but might give different results if `\usebibmacro{related}` is used in
+ unusual positions.
+- Added `locallabelwidth` option to control the label spacing in bibliographies,
+ if set to true, the label width will be calculated locally for the current
+ bibliography and not globally from a list of all citation.
+
+# RELEASE NOTES FOR VERSION 3.10
+- **INCOMPATIBLE CHANGE** The recent ISO8601:201x standard supersedes
+ the draft EDTF (Extended Date Time Format) extensions. Biblatex therefore
+ now supports the ISO8601-2 Clause 4, Level 1 Extended Format which is
+ equivalent to the draft EDTF standard but with different syntax. *This
+ syntax is in some cases not backwards compatible*. Biblatex will not
+ support backwards compatibility for the draft EDTF syntax because it is
+ too messy to do so and few people were using this anyway since it is a
+ relatively new and specialised feature. Please note these syntax changes
+ which effect only the formatting of DATE fields in bibliography datasources:
+ - The "unspecified" marker "u" is now "X"
+ - An approximate+uncertain date is now indicated with "%" rather than "?~"
+ - Open dates are now marked with ".." instead of "open" or blank
+ start/end dates.
+ - Unknown dates are now indicated by blank start/end dates rather than
+ "unknown" or "*"
+- Unicode support code that is problematic for non-Unicode engines,
+ but useful for XeTeX and LuaTeX now resides in `blx-unicode.def`.
+ That file is only read by XeTeX and LuaTeX.
+- The option `noerroretextools` demotes the incompatibility error for
+ `etextools` to a mere warning if set to `true`. Users still need
+ to make sure that `\forlistloop` has the definition from `etoolbox`
+ and not the completely incompatible definition from `etextools`.
+ This option is meant as a last resort for people who must at all
+ costs load `etextools` or a package that uses it.
+ `noerroretextools=true` will always cause a warning even if
+ `etextools` is not loaded.
+
+# RELEASE NOTES FOR VERSION 3.9
+## Bug fix release
+- Fix `\mkpagetotal`
+- Fix issue with refcontexts not appearing in some circumstances
+- **DEPRECATION NOTICE** The coming update to the ISO8601 standard
+ supercedes the draft EDTF (Extended Date Time Format) extensions.
+ When the new ISO8601 standard is public, biblatex will therefore
+ support the ISO8601-2 Clause 4, Level 1 Extended Format which is
+ equivalent to the draft EDTF standard but with different syntax. This
+ syntax is in some cases not backwards compatible. Biblatex will not
+ support backwards compatibility for the draft EDTF syntax because it is
+ too messy to do so and few people were using this anyway since it is a
+ relatively new and specialised feature. Please note these syntax changes
+ which will effect only the formatting of DATE fields in bibliography
+ datasources:
+ - The "unspecified" marker `u` is now `X`
+ - An approximate+uncertain date is now indicated with `%` rather than `?~`
+ - Open dates are now marked with `..` instead of `open` or blank start/end dates.
+ - Unknown dates are now indicated by blank start/end dates rather than `unknown` or `*`
+
+# RELEASE NOTES FOR VERSION 3.8a
+## Bug fix release
+- Documentation version fix and loop fix in certain styles
+
+# RELEASE NOTES FOR VERSION 3.8
+## Requirements
+Biber version 2.8 is required for biblatex 3.8
+
+## In order to standardise terminology, some commands and options have dropped the "scheme" naming convention and switched to "template"
+- `\DeclareSortingScheme` is now `\DeclareSortingTemplate`
+- `\DeclareSortingNamekeyScheme` is now `\DeclareSortingNamekeyTemplate`
+- The "sortingnamekeyscheme" option is now "sortingnamekeytemplate"
+
+## `\DeclareLabelalphaNameTemplate` no longer has entrytype scope
+- **INCOMPATIBLE CHANGE** The optional first argument to
+ `\DeclareLabelalphaNameTemplate` was previously an entrytype but is now an
+ arbitrary template name, as with `\DeclareUniquenameTemplate`. This is to
+ allow multiple definitions which can be referred to at different scopes.
+ It is unlikely that anyone used this with entrytype scope anyway.
+
+## `origlanguage` is now a list instead of a field.
+- **INCOMPATIBLE CHANGE** Since this is mostly used to generate localisation strings like
+ 'Translated from the <language>' via the internal macros `lbx at lfromlang`
+ and `\lbx at sfromlang`, users and style authors should not see any
+ differences. However, if your style prints `origlanguage` directly using
+ `\printfield`, this will need to be changed to `\printlist`.
+
+## Name handling enhancements
+- Name handling is now fully generalised to cover arbitrary name parts.
+ The final few pieces have been completed to allow fully customisable
+ name handling, allowing for better internationalisation. The code for
+ name uniqueness calculation and label generation for names is now fully
+ abstracted: templates created with `\DeclareUniquenameTemplate` and
+ `\DeclareLabelalphaNameTemplate` may now be specified at per-refcontext,
+ per-entry, per-namelist and per-name scope, which allows complete
+ control over all aspects of name usage. See the comments in the enhanced
+ `93-nameparts.tex` example file.
+
+## `extrayear` is now `extradate` and the information used to track this can be customised
+- **INCOMPATIBLE CHANGE** `extrayear` is called `extradate` now.
+ Limited backwards compatibility is
+ in place to allow a smooth transition, but style developers should use the new name.
+- The new `\DeclareExtradate` command allows users to track authoryear
+ disambiguation in arbitrary ways now, for example allowing disambiguation
+ at month or day level instead of just year. See the PDF doc for details.
+- **INCOMPATIBLE CHANGE** Some bibmacros from the `authoryear` style family
+ were renamed, `cite:labelyear+extrayear` becomes `cite:labeldate+extradate`,
+ `cite:extrayear` is `cite:extradate` now, and `date+extrayear`
+ is `date+extradate`. Some backwards compatibility code is present,
+ but developers should make sure their code works as expected.
+
+## Date formatting
+- The `mergedate` output has been restored to its earlier form,
+ it has also been extended to cover all EDTF date parts.
+ In order to facilitate this, a few date-related tests were introduced
+ `\iflabeldateisdate`, `\ifdatehasyearonlyprecision`, `\ifdatehastime`
+ and `\ifdateshavedifferentprecision`.
+- The `authoryear` citation styles now use `\printlabeldateextra`
+ instead of `\printfield{labelyear}\printfield{extrayear}`.
+ This should have no consequences for end users (except that
+ dates in citations and bibliography don't differ any more -
+ previously there were subtle differences when many EDTF features
+ were used), but style developers should check if they assume
+ anything about the bibmacros that have now changed.
+ Style developers are invited to have a look at the changes and
+ to get inspired to offer full EDTF format for their styles as well.
+
+## Set handling
+- Static entry sets used to have the behaviour that when citing a member of
+ a set, the data for the citation came from the set parent which was in
+ turn taken from the first member of the set. In most use cases, the only
+ part of the set parent data that was actually used was the labels but in
+ certain edge cases, other data was used which results in confusing
+ citations for set members. This has been refactored so that when citing
+ set members, the member data is used along with some labelling data
+ injected from the set parent. This means that things like
+ `\citeauthor{somesetmember}` now give the expected results.
+ *PLEASE NOTE* that this means that citing sets directly in default styles *not*
+ based on labels (`authoryear`, `authortitle`, `verbose` etc.) will result
+ in blank citations as it is not envisaged that sets are useful in such
+ styles.
+- The members of a set can now be sorted according to the active
+ sorting scheme, this is enabled via the `sortsets` option.
+ By default the option is set to false and set members appear
+ in the order given in the data source.
+- The `alphabetic` style family now also supports the `subentry`
+ option.
+
+## Localisation and styles
+- Styles which supply their own location strings in `.lbx` files typically
+ use `\DeclareLanguageMapping` to map a document language to the supplied
+ language files. This is not ideal because the mapping has to be done by
+ the user depending on the specific language. For example, for the APA
+ style, in a document using American English, this line is necessary in
+ every document:
+ ```
+ \DeclareLanguageMapping{american}{american-apa}
+ ```
+ so that the style supplied `america-apa.lbx` file is loaded.
+ In a document using the German language, the user would have to use:
+ ```
+ \DeclareLanguageMapping{german}{german-apa}
+ ```
+ A new macro `\DeclareLanguageMappingSuffix` is now supplied which allows
+ styles to register a global localisation file suffix which is appended to
+ any document language automatically. This removes the need for
+ `\DeclareLanguageMapping` in user documents as it ensures that the
+ correct localisation file will be read nomatter what the document language.
+ For example, the APA style (from version v7.5) now has this
+ in `apa.bbx`:
+ ```
+ \DeclareLanguageMappingSuffix{-apa}
+ ```
+ which means that for a given document language `<lang>`
+ the localisation file `<lang>-apa.lbx` will be loaded.
+ `\DeclareLanguageMapping`, if present, will override
+ `\DeclareLanguageMappingSuffix`.
+
+## Context-sensitive delimiters
+- Several delimiter macros now use the context-sensitive delimiter interface
+ introduced in version 3.4 (`\DeclareDelimFormat`). This change is fully
+ backwards compatible, but style developers should feel encouraged to use the
+ new commands `\DeclareDelimFormat` and `\printdelim`.
+- Three new delimiters are introduced. `authortypedelim`, `editortypedelim`,
+ and `translatortypedelim` control the delimiter between the respective name
+ and the following `<name>` bibstring.
+ This together with `\DeclareFieldFormat{<name>type}` allows one to go from
+ 'E. Ditor, ed.' to 'E. Ditor (ed.)' more easily without the need
+ to redefine entire bibmacros.
+- `\DeclareDelimAlias` allows one to alias one delimiter to another.
+ E.g. `\DeclareDelimAlias{finalnamedelim}{multinamedelim}`
+ will make `finalnamedelim` an alias for `multinamedelim`.
+ The starred version `\DeclareDelimAlias*` is local to the
+ specified contexts.
+
+## Misc changes
+- The initialisation code for `\usedriver` can now be modified via
+ `\AtUsedriver`, the code can be executed with `\UseUsedriverHook`.
+ The default settings retain backwards compatibility with earlier
+ versions.
+- The field `urlraw` contains the unencoded, raw version of the URL.
+ If the URL includes Unicode characters, `urlraw` will show them
+ unencoded while the standard `url` field will contain them in
+ percent-encoded form.
+- `\mkpagetotal` now has its own bibstrings `<pagination>total(s)`
+ Previously it relied on the `<pagination>(s)` bibstrings.
+- `sortyear` is now a literal field and not an integer.
+- The `etextools` package is now officially incompatible.
+- `bidi`-support for footnotes was improved.
+- `\ifentryseen`, `\ifentryinbib`, `\ifentrycategory`
+ and `\ifentrykeyword` can now be used outside of
+ `biblatex` macros directly in the document.
+- `\letbibmacro` can be used to create bibmacro aliases as if
+ using `\let`.
+- `\DeprecateFieldWithReplacement`, `\DeprecateListWithReplacement`
+ and `\DeprecateNameWithReplacement` can be used to deprecate a field,
+ name or list and replace it with a new one.
+
+# RELEASE NOTES FOR VERSION 3.7
+## Requirements
+Biber version 2.7 is required for biblatex 3.7
+
+Bugfix release.
+
+# RELEASE NOTES FOR VERSION 3.6
+## Requirements
+Biber version 2.6 is required for biblatex 3.6
+
+This is a minor bugfix release.
+
+# RELEASE NOTES FOR VERSION 3.5
+## Requirements
+Biber version 2.6 is required for biblatex 3.5
+
+## Name support
+- **INCOMPATIBLE CHANGE** The labelling system has been generalised
+ to be able to deal better with names. `\DeclareLabelalphaTemplate` no
+ longer uses hard-coded name parts (prefix, family) when extracting label
+ parts from name fields. Name field label extraction now obeys the new
+ `\DeclareLabelalphaNameTemplate` specification which details how to extract
+ label information from each namepart known to the data model. The default
+ setting is backwards compatible with the old hard-coded behaviour.
+ However, if you have custom `\DeclareLabelalphaTemplate` specifications,
+ you should note that the "pcompound" and "pstrwidth" options to `\field`
+ are now gone and replaced with the relevant settings on `\namepart` in
+ `\DeclareLabelalphaNameTemplate`. The old options will generate warnings.
+ It is too complex to provide backwards compat for this, sorry - please
+ update your templates if necessary. This is one of the last changes
+ needed to fully generalise name handling.
+
+## Date input and output
+Major enhancements to the dates parsed by biblatex and the output formats
+available. Biblatex now supports [[http://www.loc.gov/standards/datetime/pre-submission.html][EDTF]] level 0 and 1. This is an enhanced
+ISO8601v2004 format suitable for bibliographic data. The new support is a
+superset of the previous limited ISO8601 support. Times are now fully
+supported in various formats as online sources become more common and time
+specifications for such sources are increasingly important. Tests and
+localisation strings are provided to use EDTF information about date
+uncertainty, era, approximation etc. in styles. A new example document
+(96-dates.tex) is provided which demonstrates the new features. See the PDF
+manual and its changelog for details of usage. The new date format
+functionality is backwards compatible. The following changes are more
+detailed and mostly of interest to style authors:
+
+- The `iso8601` date output format is now called `edtf`. The old name will
+ automatically use `edtf` and issue a deprecation warning.
+- `\bibdatedash` is now `\bibdaterangesep` as this name is more
+ informative and more descriptive of how it is actually used. A backwards
+ compat alias is provided.
+- Pre-biblatex 2.0 legacy sorting scheme definition macros `\name` and
+ `\list` are now deprecated with warnings.
+- **INCOMPATIBLE CHANGE** The `labeldate` option is renamed to
+ `labeldateparts`. The `datelabel` option is renamed to `labeldate` to
+ provide consistency with all other date options. Backwards compatibility
+ is provided and warnings will be issued.
+- The new date system necessitated changes to the default year printing
+ routine for citations in the default authoryear styles. If you wish to
+ take advantage of the new date features like circa, uncertainty and eras,
+ when printing citations in authoryear styles, see the enhanced
+ `cite:labelyear+extrayear` macros in any of the default authoryear
+ styles.
+- The `labelyear` field was inconsistently implemented and in fact could
+ sometimes contain a date range which made handling it rather difficult.
+ It is now guaranteed to contain only one year, when it is a copy of an
+ existing datepart field found by `\DeclareLabeldate` (`labelyear` can
+ contain a literal/bibstring or non date field too). A new field
+ `labelendyear` will contain the end of the labeldate year range. The same
+ applies to labelmonth and labelday.
+- The internal macros `\mkbibrange*` have all been changed to
+ `\mkdaterange*` to make the name more obvious (since they only deal with
+ dates) and for consistency with the new `\mktimerange*` macros. These
+ macros are usually only used in style .lbx files and the old names will
+ generate a deprecation warning.
+- The option `datezeros` was inconsistent as it did not enforce zeros when
+ set to 'true', it merely preserved the field. In the new date internals,
+ leading zeros are not present after date parsing as this should always be
+ a formatting/style decision. Now, `datezeros` enforces leading zeros and
+ also handles all date parts.
+- `\mkdatezeros` has been replaced with `\mkyearzeros`, `\mkmonthzeros` and
+ `\mkdayzeros` due to the date internals changes which are more consistent
+ about integer formats of date parts. `\mkdatezeros` now generates a
+ deprecation warning and calls `\mkmonthzeros` which is backwards compatible
+ with its old behaviour.
+- **INCOMPATIBLE CHANGE** The .bbl field `datelabelsource` has been renamed to
+ `labeldatesource` to prevent confusion with other fields. In the unlikely
+ event that you referenced this field in a style, please change the name.
+- **INCOMPATIBLE CHANGE** The macro `\printdatelabel` has been renamed to
+ `\printlabeldate` in line with the naming of all other date printing
+ macros. Please use the new name. The old one will issue a deprecation warning.
+- **INCOMPATIBLE CHANGE** The macro `\printdatelabelextra` has been renamed to
+ `\printlabeldateextra` in line with the naming of all other date printing
+ macros. Please use the new name. The old one will issue a deprecation warning.
+
+## Misc changes
+- The experimental RIS format support is no longer available as it was
+ rarely used and made biber maintenance more complicated. RIS is a very
+ primitive format and not much use anyway.
+- **INCOMPATIBLE CHANGE** The `singletitle` option no longer considers the
+ presence of labeltitle if labelname does not exist. This has always been
+ potentially confusing. For several versions now, there has been a
+ separate test and option for labeltitle called "uniquetitle".
+- **INCOMPATIBLE CHANGE** The `sortgiveninits` option has been deprecated and
+ the functionality generalised. It is replaced by the "inits" option to
+ `\namepart` in `\DeclareSortingNamekeyScheme`. Any nameparts may now
+ therefore be sorted using initials only.
+- **INCOMPATIBLE CHANGE** The sorting subsystem in biber has been completely
+ re-engineered to support better sorting of different datatypes.
+ Previously, due to bibtex limitations, all sorting was lexical, even for
+ numbers. This is why the padding options for things like volume in the
+ default sorting specifications existed - so that lexical sorts for
+ numbers would work. With the enhancement of the date parsing routines to
+ include negative years, in order to sort these properly, it was time to
+ switch to a better sorting method. As a result, the datatypes of fields
+ is now a bit stricter, as it should be. Expect more changes in this
+ direction but for this release, the datatype of the following fields in
+ the default data model have been changed to 'integer':
+
+ - number
+ - sortyear
+ - volume
+ - volumes
+
+ Integer datatypes no longer need padding or literal fallbacks in the
+ sorting scheme definitions since they are now sorted properly as
+ integers. Such datatype changes only effect sorting.
+
+
Property changes on: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/CHANGES.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/biblatex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/biblatex-ms.tex
===================================================================
--- branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/biblatex-ms.tex 2023-03-08 21:38:44 UTC (rev 66480)
+++ branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/biblatex-ms.tex 2023-03-08 21:39:33 UTC (rev 66481)
@@ -425,6 +425,7 @@
\sffamily\bfseries\spotcolor Biber version
& \sffamily\bfseries\spotcolor \biblatex\ version\\
\midrule
+2.19 & 3.19\\
2.18 & 3.18\\
2.17 & 3.17\\
2.16 & 3.16\\
@@ -2697,7 +2698,7 @@
\boolitem[true]{dashed}
-This option controls whether recurrent the same author\slash editor list in the bibliography are replaced by a dash (\cmd{bibnamdeash}, see \secref{use:fmt:fmt}). If the option is enabled, subsequent mentions of the same name list at the beginning of an entry are replaced by a dash provided the entry is not the first on the current page. If the option is disabled, name lists are never replaced by a dash.
+This option controls whether recurrent the same author\slash editor list in the bibliography are replaced by a dash (\cmd{bibnamedash}, see \secref{use:fmt:fmt}). If the option is enabled, subsequent mentions of the same name list at the beginning of an entry are replaced by a dash provided the entry is not the first on the current page. If the option is disabled, name lists are never replaced by a dash.
\end{optionlist}
@@ -4397,7 +4398,7 @@
\cmditem{newrefcontext}[key=value, \dots]{name}
-This command is similar to the \env{refcontext} environment except that it is a stand"=alone command rather than an environment. It automatically ends any previous reference context section begun with \cmd{newrefcontext} (if any) and immediately starts a new one. Note that the context section started by the last \cmd{newrefcontext} command in the document will extend to the very end of the document. Use \cmd{endrefcontext} if you want to terminate it earlier.
+This command is similar to the \env{refcontext} environment except that it is a stand"=alone command rather than an environment. It automatically ends any previous reference context section begun with \cmd{newrefcontext} (if any) and immediately starts a new one. Note that the context section started by the last \cmd{newrefcontext} command in the document will extend to the end of the current refsection. Use \cmd{endrefcontext} if you want to terminate it earlier.
\cmditem{localrefcontext}[key=value, \dots]{name}
@@ -8612,6 +8613,11 @@
option to the \cmd{map} command above).
\begin{itemize}
+\item If \texttt{final} is \texttt{true} for a step then no more steps
+ after this one are run within the current map for the current entry if
+ the conditions for the step so far are not satisfied. Examples are given in
+ the descriptions for specific steps as to what this means for their
+ particular semantics.
\item If \texttt{entrynew} is set, a new entry is created with the entry key \texttt{entrynewkey} and the entry type given in the option \texttt{entrynewtype}. This
entry is only in-scope during the processing of the current entry and can be referenced by
\texttt{entrytarget}. In \texttt{entrynewkey}, you may use standard Perl regular expression
@@ -8664,15 +8670,7 @@
\texttt{match} regular expression (logic is reversed if you use \texttt{notmatch} and case-insensitive if you use the versions ending in <i>)\footnote{Regular expressions are full Perl 5.16 regular expressions. This means you may need to deal with special characters, see examples.}. You may use capture parenthesis as usual and refer to these (\$1\ldots\$9) in later \texttt{fieldvalue} specifications. This allows you to pull out parts of some fields and put these parts in other fields.
\item Perform a regular expression match and replace on the value of the \texttt{fieldsource} \prm{entryfield} if \texttt{match} and \texttt{replace} are defined.
\item If \texttt{matches} is defined, it should be a comma-separated list of literal strings which are replaced by corresponding locations in a comma-separated list provided in \texttt{replace}. The lists must have the same number of elements or the step will be skipped. \texttt{matchesi} is the same but case-insensitive.
-\item If \texttt{fieldset} is defined, then its value is \prm{entryfield}
- which will be set to a value specified by further options. If
- \texttt{overwrite} is false for this step and the field to set already
- exists then the map step is ignored. If \texttt{final} is also true for
- this step, then processing of the parent map stops at this point. If
- \texttt{append} is true, then the value to set is appended to the current
- value of \prm{entryfield}. \texttt{appendstrict} only appends to
- \prm{entryfield} if \prm{entryfield} is not empty. The value to set is
- specified by a mandatory one and only one of the following options:
+\item If \texttt{fieldset} is defined, then its value is \prm{entryfield} which will be set to a value specified by further options. If \texttt{overwrite} is false for this step and the field to set already exists then the map step is ignored. If \texttt{final} is also true when \texttt{overwrite} is false for this step, then processing of the parent map stops at this point. If \texttt{append} is true, then the value to set is appended to the current value of \prm{entryfield}. \texttt{appendstrict} only appends to \prm{entryfield} if \prm{entryfield} is not empty. The value to set is specified by a mandatory one and only one of the following options:
\begin{itemize}
\item\ \texttt{fieldvalue} --- The \texttt{fieldset} \prm{entryfield} is set to the \texttt{fieldvalue} \prm{string}
\item\ \texttt{null} --- The \texttt{fieldset} \prm{entryfield} is ignored, as if it did not exist in the datasource
@@ -10774,11 +10772,11 @@
Restores a \prm{name list} (optionally a multiscript name of \prm{msform}/\prm{mslang}) from a \prm{macro} defined with \cmd{savename} before. The list is restored within a local scope.
-\cmditem[msform][mslang]{clearfield}{field}
+\cmditem{clearfield}[msform][mslang]{field}
Clears the \prm{field} (optionally a multiscript field of \prm{msform}/\prm{mslang} of which both or neither optional arguments must be provided) within a local scope. A field cleared this way is treated as undefined by subsequent data commands. When no optional \prm{msform}/\prm{mslang} arguments are provided, clears all alternates of a multiscript field.
-\cmditem[msform][mslang]{clearlist}{literal list}
+\cmditem{clearlist}[msform][mslang]{literal list}
Clears the \prm{literal list} (optionally a multiscript list of \prm{msform}/\prm{mslang} of which both or neither optional arguments must be provided) within a local scope. A list cleared this way is treated as undefined by subsequent data commands. When no optional \prm{msform}/\prm{mslang} arguments are provided, clears all alternates of a multiscript list. Clearing only one alternate of a multiscript list does not clear the associated counters for the list.
@@ -13724,6 +13722,10 @@
Appends the \prm{code} to an internal hook executed at the beginning of every reference section. The \prm{code} is executed just after setting the reference section number. This command may only be used in the preamble.
+\cmditem{AtNextRefsection}{code}
+
+Appends the \prm{code} to an internal hook executed at the beginning of the next reference section. The \prm{code} is executed just after setting the reference section number.
+
\cmditem{AtBeginBibliography}{code}
Appends the \prm{code} to an internal hook executed at the beginning of the bibliography. The \prm{code} is executed at the beginning of the list of references, immediately after the \prm{begin code} of \cmd{defbibenvironment}. This command may only be used in the preamble.
@@ -15491,6 +15493,8 @@
\item Multiscript support\see{use:multiscript}
\end{release}
\begin{release}{3.19}{2022}
+\begin{release}{3.19}{2023-03-05}
+\item Added \cmd{AtNextRefsection}\see{aut:fmt:hok}
\item Added \cmd{DeclareExtradateContext} option\see{aut:ctm:fld}
\item Modified warning for using bibtex backend
\item Enhanced \bibfield{extradate} tracking to fallback on \bibfield{labeltitle} when there is no author
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/02-annotations-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/02-annotations-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/03-localization-keys-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/03-localization-keys-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/16-numeric-prefixed-1-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/16-numeric-prefixed-1-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/17-numeric-prefixed-2-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/17-numeric-prefixed-2-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/19-alphabetic-prefixed-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/19-alphabetic-prefixed-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/20-indexing-single-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/20-indexing-single-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/21-indexing-multiple-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/21-indexing-multiple-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/40-style-alphabetic-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/40-style-alphabetic-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/50-style-authoryear-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/50-style-authoryear-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/60-style-authortitle-biber-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/60-style-authortitle-bibtex-ms.pdf
===================================================================
(Binary files differ)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/91-sorting-schemes-ms.tex
===================================================================
--- branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/91-sorting-schemes-ms.tex 2023-03-08 21:38:44 UTC (rev 66480)
+++ branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/91-sorting-schemes-ms.tex 2023-03-08 21:39:33 UTC (rev 66481)
@@ -6,7 +6,7 @@
\usepackage{hyperref}
\addbibresource{biblatex-examples.bib}
\begin{document}
-% This demonstrates that the sorting of citations can be difference to the
+% This demonstrates that the sorting of citations can be different to the
% bibliography. However, this is not always advisable in case of multiple
% citations in the same year for the same author list. This is because
% extradate (the "a", "b" etc. in "Smith 2010a" and "Smith 2010b" etc.)
Modified: branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/98-multiscript-ms.tex
===================================================================
--- branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/98-multiscript-ms.tex 2023-03-08 21:38:44 UTC (rev 66480)
+++ branches/branch2022.final/Master/texmf-dist/doc/latex/biblatex-ms/examples/98-multiscript-ms.tex 2023-03-08 21:39:33 UTC (rev 66481)
@@ -89,7 +89,7 @@
% bibstrings being activated.
\printbibliography
-% Here we are citing and printing the bibliography using data contain in
+% Here we are citing and printing the bibliography using data contained in
% the entryfields of alternate msform="transliteration" and mslang="el"
\begin{refcontext}[msform=transliteration,mslang=el]
Modified: branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/biblatex-ms.sty
===================================================================
--- branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/biblatex-ms.sty 2023-03-08 21:38:44 UTC (rev 66480)
+++ branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/biblatex-ms.sty 2023-03-08 21:39:33 UTC (rev 66481)
@@ -12,7 +12,7 @@
% particular purpose.
% Set up the version strings here
-\def\abx at date{2022/08/21}
+\def\abx at date{2023/03/08}
\def\abx at version{4.0}
\def\abx at bbxid{\abx at date\space v\abx at version\space biblatex bibliography style (PK/MW)}
\def\abx at cbxid{\abx at date\space v\abx at version\space biblatex citation style (PK/MW)}
@@ -10832,18 +10832,23 @@
{\blx at printbibchecks
\blx at notfilter\blx at tempa{blx at catg@#1}}}
+\let\blx at default@thefilter\@empty
+\blx at kv@defkey{blx at bibdefaults}{filter}{%
+ \def\blx at default@thefilter{#1}}
\blx at kv@defkey{blx at bib2}{filter}{\blx at key@filter{#1}}
\blx at kv@defkey{blx at biblist2}{filter}{\blx at key@filter{#1}}
\def\blx at key@filter#1{%
- \ifcsdef{blx at filter@#1}
- {\blx at printbibchecks
- \blx at bibfilter\blx at tempa{blx at filter@#1}}
- {\let\blx at tempa\@empty
- \blx at error
- {Filter '#1' not found}
- {The filter '#1' could not be found.\MessageBreak
- Use \string\defbibfilter\space to define it}}}
+ \ifblank{#1}
+ {}
+ {\ifcsdef{blx at filter@#1}
+ {\blx at printbibchecks
+ \blx at bibfilter\blx at tempa{blx at filter@#1}}
+ {\let\blx at tempa\@empty
+ \blx at error
+ {Filter '#1' not found}
+ {The filter '#1' could not be found.\MessageBreak
+ Use \string\defbibfilter\space to define it}}}}
\blx at kv@defkey{blx at bib2}{check}{\blx at key@bibcheck{#1}}
\blx at kv@defkey{blx at biblist2}{check}{\blx at key@bibcheck{#1}}
@@ -11028,6 +11033,7 @@
\let\blx at theprenote\blx at default@theprenote
\let\blx at thepostnote\blx at default@thepostnote
\let\blx at thetitle\blx at default@thetitle
+ \let\blx at thefilter\blx at default@thefilter
\undef\blx at thelabel
% defaults
\let\blx at tempa\@empty% before there is a .bbl, this must not be undef
@@ -11053,6 +11059,7 @@
% \printbibliography following one with this set will inherit any
% previous "true" value
\togglefalse{blx at omitnumbers}%
+ \expandafter\blx at key@filter\expandafter{\blx at thefilter}% Can only be defaulted once \blx at tempa is set since it filters on this
\blx at kv@setkeys{blx at bib2}{#1}% ... now we have correct \blx at tempa, set rest of options
\blx at rest@actives
% Add datalist to list of seen datalists to prevent duplicates
@@ -11083,6 +11090,7 @@
\let\blx at theprenote\blx at default@theprenote
\let\blx at thepostnote\blx at default@thepostnote
\let\blx at thetitle\blx at default@thetitle
+ \let\blx at thefilter\blx at default@thefilter
\undef\blx at thelabel
\c at refsection\z@
\blx at safe@actives
@@ -11123,6 +11131,7 @@
\let\blx at theprenote\blx at default@theprenote
\let\blx at thepostnote\blx at default@thepostnote
\let\blx at thetitle\blx at default@thetitle
+ \let\blx at thefilter\blx at default@thefilter
\undef\blx at thelabel
\c at refsegment\@ne
\blx at safe@actives
@@ -11168,8 +11177,8 @@
\let\blx at theprenote\blx at default@theprenote
\let\blx at thepostnote\blx at default@thepostnote
\let\blx at thetitle\blx at default@thetitle
+ \let\blx at thefilter\blx at default@thefilter
\undef\blx at thelabel
- \c at refsection\z@
\blx at safe@actives
\blx at kv@setkeys{blx at bbc}{#1}%
\blx at rest@actives
@@ -11469,6 +11478,7 @@
\let\blx at theprenote\@empty
\let\blx at thepostnote\@empty
\let\blx at thetitle\@empty
+ \let\blx at thefilter\@empty
\undef\blx at thelabel
% defaults
\let\blx at tempa\@empty% before there is a .bbl, this must not be undef
@@ -11917,6 +11927,12 @@
\newrobustcmd*{\AtBeginRefsection}{\gappto\blx at hook@refsectioninit}
\@onlypreamble\AtBeginRefsection
+\newrobustcmd*{\AtNextRefsection}{%
+ \ifundef\blx at hook@refsection at next
+ {\gdef\blx at hook@refsection at next{\global\undef\blx at hook@refsection at next}}
+ {}%
+ \gappto\blx at hook@refsection at next}
+
\newrobustcmd*{\newrefsection}{%
\endrefcontext
\ifnum\c at refsection>\z@
@@ -11950,6 +11966,7 @@
\stepcounter{blx at maxsection}%
\setcounter{refsection}{\value{blx at maxsection}}%
\csuse{blx at hook@refsectioninit}%
+ \csuse{blx at hook@refsection at next}%
\xifinlist{\the\c at refsection}\blx at allrefsections
{}
{\listxadd\blx at allrefsections{\the\c at refsection}}%
@@ -17772,6 +17789,7 @@
\blx at bblinput
\setcounter{blx at maxsection}{0}%
\csuse{blx at hook@refsectioninit}%
+ \csuse{blx at hook@refsection at next}%
\csuse{abx at preamble}%
\blx at inf@refsec
\blx at inf@refseg}
Modified: branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/lbx/lithuanian-ms.lbx
===================================================================
--- branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/lbx/lithuanian-ms.lbx 2023-03-08 21:38:44 UTC (rev 66480)
+++ branches/branch2022.final/Master/texmf-dist/tex/latex/biblatex-ms/lbx/lithuanian-ms.lbx 2023-03-08 21:39:33 UTC (rev 66481)
@@ -12,7 +12,7 @@
{The file 'lithuanian.lbx' requires UTF-8 encoding but you
seem\MessageBreak to be using a different encoding.
This is a fatal error. I will\MessageBreak abort loading
- russian.lbx now.}%
+ lithuanian.lbx now.}%
\endinput}
\DeclareBibliographyExtras{%
More information about the tex-live-commits
mailing list.