5 files changed, 43 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/latex/hyperxmp/README b/Master/texmf-dist/doc/latex/hyperxmp/README
index 7fecb23e926..cd0eb250ce1 100644
--- a/Master/texmf-dist/doc/latex/hyperxmp/README
+++ b/Master/texmf-dist/doc/latex/hyperxmp/README
@@ -51,7 +51,7 @@ Building hyperxmp.pdf is a little more involved:
 Copyright and license
 =====================
 
-Copyright (C) 2018 Scott Pakin
+Copyright (C) 2019 Scott Pakin
 
 This file may be distributed and/or modified under the conditions of
 the LaTeX Project Public License, either version 1.3c of this license
diff --git a/Master/texmf-dist/doc/latex/hyperxmp/hyperxmp.pdf b/Master/texmf-dist/doc/latex/hyperxmp/hyperxmp.pdf
index b649ed5daaa..59c20d11d32 100644
--- a/Master/texmf-dist/doc/latex/hyperxmp/hyperxmp.pdf
+++ b/Master/texmf-dist/doc/latex/hyperxmp/hyperxmp.pdf
diff --git a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx
index 7edb195c983..dd4cd3b9d4c 100644
--- a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx
+++ b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright (C) 2018 by Scott Pakin <scott+hyxmp@pakin.org>
+% Copyright (C) 2019 by Scott Pakin <scott+hyxmp@pakin.org>
 % -------------------------------------------------------
 %
 % This file may be distributed and/or modified under the
@@ -22,7 +22,7 @@
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package>\ProvidesPackage{hyperxmp}
 %<*package>
-    [2018/11/27 v3.5 Store hyperref metadata in XMP format]
+    [2019/02/25 v3.5a Store hyperref metadata in XMP format]
 %</package>
 %
 %<*driver>
@@ -55,7 +55,7 @@
   pdftitle={The hyperxmp package},
   pdfsubject={LaTeX2e support for XMP metadata},
   pdfkeywords={LaTeX, embedded metadata, XMP, PDF, copyright, license, comments},
-  pdfcopyright={Copyright (C) 2018, Scott Pakin},
+  pdfcopyright={Copyright (C) 2019, Scott Pakin},
   pdflicenseurl={http://www.latex-project.org/lppl/},
   pdfcaptionwriter={Scott Pakin},
   pdfcontactemail={scott+hyxmp@pakin.org},
@@ -835,6 +835,41 @@
 %   \XMPLangAlt{rm}{pdftitle={Titel rumantsch}}
 % \end{verbatim}
 %
+% \usagenote{Expandable arguments}
+% All arguments passed to \pkgname{hyperxmp} options must be expandable,
+% in \tex\ terminology.  This implies that any macros that are used in
+% arguments are limited to a relatively small set of operations (such as
+% conditionals and macro expansion) and must produce a string of text.
+% Code (such as macro definitions and arithmetic operations) will be
+% written to \acro{XMP} as code, not as the result of executing the
+% code.
+%
+% By way of example, the macros provided by the \pkgname{texdate}
+% package for typesetting dates are not expandable (at least at the time
+% of this writing).  Hence, the |\printfdate{Y}| in the following code
+% snippet is not replaced by the current year, as one might expect:
+%
+% \begin{verbatim}
+% \usepackage{texdate}
+% \initcurrdate
+% \hypersetup{%
+%   pdfcopyright={Copyright \textcopyright\ \printfdate{Y}, Scott Pakin}
+% }
+% \end{verbatim}
+%
+% \noindent
+% Rather, it generates a \xmpterm{dc:rights} tag of the form
+% ``\texttt{Copyright \textcopyright\ =2=0=by-1by=0\the\year, Scott
+%   Pakin}''.  The garbage in that line corresponds to the remnants of
+% the |\printfdate| code after expanding all of the \tex\ primitives and
+% certain other control sequences it uses to the empty string.  For
+% example, ``|\global\advance\texd@yr| |by-1|'' expands to ``|by-1|''.
+%
+% It is not possible to determine a~priori whether or not a macro is
+% expandable.  The best advice is to carefully inspect the \acro{XMP}
+% package in the output file to ensure that any macros used in arguments
+% to \pkgname{hyperxmp} options produced the expected output.
+%
 %
 % \StopEventually{^^A
 % \section{Future Work}
diff --git a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.ins b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.ins
index 9a16246d750..1b82c2a2020 100644
--- a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.ins
+++ b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.ins
@@ -1,5 +1,5 @@
 %%
-%% Copyright (C) 2018 by Scott Pakin <scott+hyxmp@pakin.org>
+%% Copyright (C) 2019 by Scott Pakin <scott+hyxmp@pakin.org>
 %%
 %% This file may be distributed and/or modified under the conditions of
 %% the LaTeX Project Public License, either version 1.3c of this license
@@ -21,7 +21,7 @@
 
 This is a generated file.
 
-Copyright (C) 2018 by Scott Pakin <scott+hyxmp@pakin.org>
+Copyright (C) 2019 by Scott Pakin <scott+hyxmp@pakin.org>
 
 This file may be distributed and/or modified under the conditions of
 the LaTeX Project Public License, either version 1.3c of this license
diff --git a/Master/texmf-dist/tex/latex/hyperxmp/hyperxmp.sty b/Master/texmf-dist/tex/latex/hyperxmp/hyperxmp.sty
index 462cb3758bb..ff8d81bd246 100644
--- a/Master/texmf-dist/tex/latex/hyperxmp/hyperxmp.sty
+++ b/Master/texmf-dist/tex/latex/hyperxmp/hyperxmp.sty
@@ -8,7 +8,7 @@
 %% 
 %% This is a generated file.
 %% 
-%% Copyright (C) 2018 by Scott Pakin <scott+hyxmp@pakin.org>
+%% Copyright (C) 2019 by Scott Pakin <scott+hyxmp@pakin.org>
 %% 
 %% This file may be distributed and/or modified under the conditions of
 %% the LaTeX Project Public License, either version 1.3c of this license
@@ -22,7 +22,7 @@
 %% 
 \NeedsTeXFormat{LaTeX2e}[1999/12/01]
 \ProvidesPackage{hyperxmp}
-    [2018/11/27 v3.5 Store hyperref metadata in XMP format]
+    [2019/02/25 v3.5a Store hyperref metadata in XMP format]
 \edef\hyxmp@dq@code{\the\catcode`\"}
 \catcode`\"=12
 \def\hyxmp@driver{hpdftex}