biblatex-ext (4jan19)

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

4 files changed, 53 insertions, 21 deletions

diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md b/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md
index 6ce20e69573..2336f09ec23 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md
@@ -1,5 +1,12 @@
+# Version 0.6a (2019-01-04)
+See https://github.com/moewew/biblatex-ext/compare/v0.6...v0.6a
+- Only patch bibmacros in `biblatex-ext-oa`. This avoids redefinitions,
+  which could clear out custom definitions.
+- Use socket.url's URL escape/encode function in blxextdoiapi.lua.
+- Fix bug in deprecation handling.
+
 # Version 0.6 (2018-11-23)
-See https://github.com/moewew/biblatex-ext/compare/v0.5a..v0.6
+See https://github.com/moewew/biblatex-ext/compare/v0.5a...v0.6
 - Sync `mergedate` code with `biblatex` 3.12
   (https://github.com/plk/biblatex/pull/810
    https://github.com/plk/biblatex/issues/752).
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/README.md b/Master/texmf-dist/doc/latex/biblatex-ext/README.md
index 8d2a26d2181..3b30f870068 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/README.md
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/README.md
@@ -73,7 +73,7 @@ standard styles. The bundle consists of the following files
 
 ## Licence
 
-Copyright 2017-2018 Moritz Wemheuer
+Copyright 2017-2019 Moritz Wemheuer
 
 This work consists of the `.bbx`, `.cbx`, `.def`, `.sty` and `.lua` files
 mentioned above.
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf
index 2cca9afc1c5..bff09eebdcf 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
index 92496b811be..fabe0af91e1 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
@@ -415,7 +415,7 @@
 
 \newcommand*{\ctan}{\mkbibacro{CTAN}}
 \newcommand*{\gitbaseurl}{https://github.com/moewew/biblatex-ext}
-\newcommand*{\extblxversion}{0.6}
+\newcommand*{\extblxversion}{0.6a}
 \newcommand*{\biber}{Biber}
 \newcommand*{\gitissuelink}[1]{%
   \href{\gitbaseurl/issues/#1}{issue \##1 on github}}
@@ -463,7 +463,7 @@
   author   = {Moritz Wemheuer},
   link     = {mwemheu@gmail.com},%
   revision = {\extblxversion},
-  date     = {\DTMDate{2018-11-23}},
+  date     = {\DTMDate{2019-01-04}},
 }
 
 \hypersetup{%
@@ -609,7 +609,8 @@ If at all possible you should install this bundle via your \tex{} distribution
 (using \miktex{} Console\fnurl{https://miktex.org/howto/miktex-console} or
 \sty{tlmgr} for \texlive\fnurl{https://www.tug.org/texlive/pkginstall.html}).
 If you must install this package manually, get the files from \ctan{}
-and install the \sty{.bbx}, \sty{.cbx} and \sty{.def} files preferably to
+and install the \sty{.bbx}, \sty{.cbx}, \sty{.def}, \sty{.sty} and \sty{.lua}
+files preferably to
 \path{tex/latex/biblatex-ext} of your local or home \TeX{} tree%
 \fnurl{https://texfaq.org/FAQ-inst-wlcf}, the other
 files (\path{CHANGES.md}, \path{README.md}, \path{biblatex-ext.tex},
@@ -623,7 +624,7 @@ under the terms of the \lppl, version 1.3c%
 \fnurl{https://www.latex-project.org/lppl/lppl-1-3c.txt}
 or (at your option) any later version%
 \fnurl{https://www.latex-project.org/lppl.txt}.
-This bundle is maintained by Moritz Wemheuer (\textcopyright 2017--2018).
+This bundle is maintained by Moritz Wemheuer (\textcopyright 2017--2019).
 
 
 \subsection{Feedback}\label{sec:feedback}
@@ -671,8 +672,8 @@ available on \ctan\fnurl{https://ctan.org/pkg/latex-sciences-humaines}.
 If you read German you may be interested in Dominik Waßenhoven's two-part
 series \foreignlanguage{ngerman}{\emph{Bibliographien erstellen mit
 \sty{biblatex}}} in \foreignlanguage{ngerman}{\emph{Die \TeX nische Komödie}}
-2/2008\fnurl{http://www.dante.de/DTK/Ausgaben/2008-2.pdf} (pp.~53--75)
-and 4/2008\fnurl{http://www.dante.de/DTK/Ausgaben/2008-4.pdf} (pp.~31--51).
+2/2008\fnurl{https://www.dante.de/DTK/Ausgaben/2008-2.pdf} (pp.~53--75)
+and 4/2008\fnurl{https://www.dante.de/DTK/Ausgaben/dtk08-4.pdf} (pp.~31--51).
 Please keep in mind that some of these texts were written a while ago and
 that \sty{biblatex} is actively developed: technical details may have changed
 and new features make some things easier.
@@ -2375,9 +2376,16 @@ by pluton\fnurl{https://tex.stackexchange.com/users/371/pluton} on TeX.SX
 about promoting open access works by adding a small open access symbol into
 the margin.
 
-The package must be loaded after \sty{biblatex}
-and is not tied to use with styles of this bundle, though it can not be
-guaranteed that everything will work out of the box with other styles.
+The package must be loaded after \sty{biblatex}.
+It is not tied to use with styles of this bundle, though it can not be
+guaranteed that everything will work out of the box with all other styles.
+The package works as expected with the standard styles and
+should work with most contributed styles at least to some extent.
+For the actual typesetting of the symbol \sty{biblatex-ext-oa}
+patches the bibliography macro \bibmacro{begentry} to include a call to the
+bibliography macro \bibmacro{oamark}.
+That means that you have to keep in mind this behaviour should you want to
+redefine \bibmacro{begentry} yourself.
 \begin{biblatexcode}
 \usepackage[(*@\prm{\sty{biblatex} options}@*)]{biblatex}
 (*@\dots @*)
@@ -2409,10 +2417,10 @@ If the package is loaded with \opt{enable} set to \opt{false} the global
 bibliography option \opt{openaccess} will be set to \opt{false} and no sensible
 defaults are defined for the semi-automatic open access detection.
 
-\optitem[false]{tikzsymbol}{\opt{true}, \opt{false}, \prm{string}}
+\optitem[false]{tikzsymbol}{\opt{true}, \opt{false}, \prm{symbol identifier}}
 
 Load the support package \sty{biblatex-ext-oa-tikzsymbols} with its load-time
-option \opt{symbol} set to \prm{string}.
+option \opt{symbol} set to \prm{symbol identifier}.
 The values \opt{true} and \opt{false} are provided for convenience.
 \opt{false} does not load the package at all, \opt{true} is like giving the
 value \opt{plos}.
@@ -2422,7 +2430,7 @@ as well as a short note on their respective licenses.
 
 \marginwarn Note that \sty{biblatex-ext-oa-tikzsymbols} will load \pgftikz
 \fnurl{https://ctan.org/pkg/pgf} to draw the open access symbols.
-If you prefer a more light-weight solution you can define a symbol yourself
+If you prefer a more light-weight solution, you can define a symbol yourself
 with an external graphics file.
 
 \marginwarn
@@ -2501,12 +2509,15 @@ open access URL may not be amongst the fields that are already displayed
 in the entry.
 \end{keymarglistbook}
 
-With \opt{enable} set to \opt{true} the package will furtermore redefine the
-bibliography macro \bibmacro{begentry} to execute the bibliography macro
+\marginwarn
+With \opt{enable} set to \opt{true} the package will furtermore patch
+the bibliography macro \bibmacro{begentry} to execute the bibliography macro
 \bibmacro{oamark}.
-If additionally \opt{doiapi} is \opt{true} the bibliography macro
-\bibmacro{doi+eprint+url} will be redefined to include a call to
+If additionally \opt{doiapi} is \opt{true}, the bibliography macro
+\bibmacro{doi+eprint+url} will be patched to include a call to
 \bibmacro{api:bestoaurl}.
+Please keep that in mind should you need to redefine \bibmacro{begentry}
+or \bibmacro{doi+eprint+url}.
 
 \subsection{Open access detection}\label{sec:oa:detect}
 The heart of the package \sty{biblatex-ext-oa} is the bibliography option
@@ -2758,7 +2769,7 @@ If the package is loaded and no email was provided until the
 beginning of the document (as tested in an \cmd{AtBeginDocument} hook)
 you will recieve a warning.
 A fatal error will be thrown if you try to query the Unpaywall database
-without an email.
+without an email address.
 
 \cmditem{SetDOIAPICacheExpiration}{days}
 
@@ -2803,8 +2814,10 @@ for \cmd{oasymbol}.
 \item[plos] Use the open access symbol by PLOS | Public Library of Science%
   \fnurl{https://www.plos.org/} \csuse{extblx@oasymbol@plos}.
 
-  The drawing is based on a CC0 work by PLoS, modified by Wikipedia users
-  Nina, Beao, and JakobVoss%
+  The drawing is based on a CC0%
+  \fnurl{https://creativecommons.org/publicdomain/zero/1.0/deed.en}
+  work by PLoS (now PLOS | Public Library of Science),
+  modified by Wikipedia users Nina, Beao, and JakobVoss%
 \fnurl{https://commons.wikimedia.org/wiki/File:Open_Access_logo_PLoS_white.svg}.
 
 \item[oanet] Use the open access symbol by open-access.net%
@@ -2839,6 +2852,15 @@ for \cmd{oasymbol}.
   \fnurl{https://open-access.net/DE-EN/about-us/}.
   While the German version leaves some leeway as to whether or not a link is
   required as attribution, the English version seems more explicit.
+  
+  That means that if you do not follow Wikimedia in considering the symbol
+  not protected by copyright in your~-- and all other relevant jurisdictions%
+  ~-- due to its failure to cross the threshold of originality,
+  you should probably treat it as CC BY 4.0 and treat the link to
+  \url{https://open-access.net} as attribution requested by the Licensor
+  according to Section 3(a)(1)(A) of the license.
+  If you can't reasonably meet the requirements of the license in your work,
+  you may want to consider using the PLOS logo, which is licensed under CC0.
 \end{valuelist}
 \end{optionlist}
 
@@ -2858,6 +2880,9 @@ See also \sty{CHANGES.md}.
 
 The numbers on the right indicate the relevant section of the manual.
 \begin{changelog}
+\begin{release}{0.6a}{2019-01-04}
+  \item Minor improvements for \sty{biblatex-ext-oa}\see{sec:oasymb}
+\end{release}
 \begin{release}{0.6}{2018-11-23}
   \item Require \sty{biblatex} 3.12
   \item Make \opt{dashed} and \opt{introcite} options available on a per-entry