Skip to content

Commit

Permalink
#540 Implementing \DeclareExtradate
Browse files Browse the repository at this point in the history
  • Loading branch information
plk committed Oct 28, 2017
1 parent a3ea701 commit 76f591b
Show file tree
Hide file tree
Showing 19 changed files with 26 additions and 4,371 deletions.
4,272 changes: 0 additions & 4,272 deletions doc/latex/biblatex/CHANGES.old

This file was deleted.

19 changes: 18 additions & 1 deletion doc/latex/biblatex/CHANGES.org
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,20 @@
** Requirements
Biber version 2.8 is required for biblatex 3.8

** Bugfix for CLDR sorting issues
Some CLDR sort tailoring was broken in version 2.7. This was due to an invisible
Unicode::Collate library change which was not noticed until after 2.7 was released and is fixed in version 2.8.
** 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.

** 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~
Expand Down Expand Up @@ -32,6 +46,10 @@ Biber version 2.8 is required for biblatex 3.8
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
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.
** 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
Expand All @@ -53,7 +71,6 @@ Biber version 2.8 is required for biblatex 3.8
- 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
Expand Down
Binary file modified doc/latex/biblatex/examples/50-style-authoryear-biber.pdf
Binary file not shown.
Binary file modified doc/latex/biblatex/examples/50-style-authoryear-bibtex.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion doc/latex/biblatex/examples/50-style-authoryear.tex
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ \subsubsection*{The \texttt{mergedate} option}

\texttt{mergedate=basic} is similar in concept but more economical.
It will also omit the date if it differs from the date label only by
\texttt{extrayear}.
\texttt{extradate}.

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
Expand Down
Binary file modified doc/latex/biblatex/examples/51-style-authoryear-ibid-biber.pdf
Binary file not shown.
Binary file modified doc/latex/biblatex/examples/51-style-authoryear-ibid-bibtex.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion doc/latex/biblatex/examples/51-style-authoryear-ibid.tex
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ \subsubsection*{The \texttt{mergedate} option}

\texttt{mergedate=basic} is similar in concept but more economical.
It will also omit the date if it differs from the date label only by
\texttt{extrayear}.
\texttt{extradate}.

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
Expand Down
Binary file modified doc/latex/biblatex/examples/52-style-authoryear-comp-biber.pdf
Binary file not shown.
Binary file modified doc/latex/biblatex/examples/52-style-authoryear-comp-bibtex.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion doc/latex/biblatex/examples/52-style-authoryear-comp.tex
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ \subsubsection*{The \texttt{mergedate} option}

\texttt{mergedate=basic} is similar in concept but more economical.
It will also omit the date if it differs from the date label only by
\texttt{extrayear}.
\texttt{extradate}.

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
Expand Down
Binary file modified doc/latex/biblatex/examples/53-style-authoryear-icomp-biber.pdf
Binary file not shown.
Binary file modified doc/latex/biblatex/examples/53-style-authoryear-icomp-bibtex.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion doc/latex/biblatex/examples/53-style-authoryear-icomp.tex
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ \subsubsection*{The \texttt{mergedate} option}

\texttt{mergedate=basic} is similar in concept but more economical.
It will also omit the date if it differs from the date label only by
\texttt{extrayear}.
\texttt{extradate}.

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
Expand Down
2 changes: 1 addition & 1 deletion doc/latex/biblatex/examples/91-sorting-schemes.tex
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
% This demonstrates that the sorting of citations can be difference 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
% extrayear (the "a", "b" etc. in "Smith 2010a" and "Smith 2010b" etc.)
% extradate (the "a", "b" etc. in "Smith 2010a" and "Smith 2010b" etc.)
% depends on the sorting order and if the sorting order is different
% between citations and bibliography, this can cause confusion.
Filler text \parencite{wassenberg,cicero,companion,angenendt}.
Expand Down
Binary file modified doc/latex/biblatex/examples/93-nameparts-biber.pdf
Binary file not shown.
Binary file modified doc/latex/biblatex/examples/93-nameparts.tex
Binary file not shown.
92 changes: 0 additions & 92 deletions doc/latex/biblatex/notes.org

This file was deleted.

4 changes: 3 additions & 1 deletion tex/latex/biblatex/biblatex.sty
Original file line number Diff line number Diff line change
Expand Up @@ -10687,6 +10687,8 @@
~~~~<bcf:scope>\blx@nl
#1%
~~~~</bcf:scope>\blx@nl}
\xdef\blx@xml@edordered#1#2{%
~~~~~~<bcf:field order="#1">#2</bcf:field>\blx@nl}
\xdef\blx@xml@inheritance#1{%
~~<bcf:inheritance>\blx@nl
Expand Down Expand Up @@ -12056,7 +12058,7 @@
\newcommand*{\blx@ordereded@field}[1]{%
\advance\blx@tempcnta\@ne
\csxappto{blx@tempb}{%
\noexpand\blx@xml@ordered{\the\blx@tempcnta}{}{#1}}}
\noexpand\blx@xml@edordered{\the\blx@tempcnta}{#1}}}
% [<type,type,...>]{<field,field,...>}
\newrobustcmd*{\DeclareLabelname}[2][]{%
Expand Down

4 comments on commit 76f591b

@moewew
Copy link
Collaborator

@moewew moewew commented on 76f591b Oct 29, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should CHANGES.org also contain info about Biber changes (i.e. ** Bugfix for CLDR sorting issues)?

@plk
Copy link
Owner Author

@plk plk commented on 76f591b Oct 29, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure but I don't think people differentiate biblatex/biber that much and this impacted a lot of biblatex users. Happy to remove it if you think it should be removed.

@moewew
Copy link
Collaborator

@moewew moewew commented on 76f591b Oct 29, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was mainly confused at first because the version number is 2.something.

@plk
Copy link
Owner Author

@plk plk commented on 76f591b Oct 29, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, I removed it ...

Please sign in to comment.