hyperxmp (12sep23)

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

1 files changed, 33 insertions, 7 deletions

diff --git a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx
index ea0d5334298..9be837cf2aa 100644
--- a/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx
+++ b/Master/texmf-dist/source/latex/hyperxmp/hyperxmp.dtx
@@ -22,7 +22,7 @@
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package>\ProvidesPackage{hyperxmp}
 %<*package>
-    [2022/10/16 v5.11 Store hyperref metadata in XMP format]
+    [2023/09/10 v5.12 Store hyperref metadata in XMP format]
 %</package>
 %
 %<*driver>
@@ -131,7 +131,7 @@
 %</driver>
 % \fi
 %
-% \CheckSum{2844}
+% \CheckSum{2848}
 %
 % \CharacterTable
 %  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -653,10 +653,10 @@
 % \pkgname{hyperxmp} works by postprocessing some of the package options
 % honored by \pkgname{hyperref}.  To use \pkgname{hyperxmp}, merely put
 % a |\usepackage{hyperxmp}| in your document's preamble.  That line can
-% appear anywhere before the \pkgname{hyperref} \acro{PDF} options are
-% specified (i.e.,~with either |\usepackage[|\dots|]{hyperref}| or
-% |\hypersetup{|\dots|}|).  \pkgname{hyperxmp} will construct its
-% \acro{XMP} data using the following \pkgname{hyperref} options:
+% appear anywhere \emph{after} the |\usepackage{hyperref}| but
+% \emph{before} \pkgname{hyperref}'s \acro{PDF} options are specified
+% with |\hypersetup|.  \pkgname{hyperxmp} will construct its \acro{XMP}
+% data using the following \pkgname{hyperref} options:
 %
 % \begin{multicols}{3}
 %   \raggedcolumns
@@ -1060,8 +1060,8 @@
 % \begin{verbatim}
 %    \documentclass{article}
 %    \usepackage[utf8]{inputenc}
-%    \usepackage{hyperxmp}
 %    \usepackage[unicode]{hyperref}
+%    \usepackage{hyperxmp}
 %
 %    \title{%
 %      On a heuristic viewpoint concerning the production and
@@ -2641,6 +2641,32 @@ sub mycmd {
 % same thing.  This is required in case \pkgname{hyperref} is loaded
 % before \pkgname{hyperxmp}.
 %
+% \changes{v5.12}{2023/09/10}{Require that \pkgname{hyperref} be loaded
+%   before \pkgname{hyperxmp}}
+% \begin{center}
+%   \fbox{%
+%     \begin{minipage}{0.75\linewidth}
+%       \paragraph{New in v5.12}
+%       \pkgname{hyperref} must be loaded \emph{before} \pkgname{hyperxmp}.
+%       This is because recent changes in \pkgname{hyperref} and the
+%       \LaTeX\ kernel prevent \pkgname{hyperxmp} from hooking into
+%       \pkgname{hyperref}'s internals if \pkgname{hyperref} is loaded
+%       first.
+%     \end{minipage}%
+%   }
+% \end{center}
+%
+%    \begin{macrocode}
+\@ifpackageloaded{hyperref}{%
+}{%
+  \PackageError{hyperxmp}%
+    {hyperref must be loaded before hyperxmp}%
+    {Recent versions of hyperref and the LaTeX kernel inhibit\MessageBreak
+      hyperxmp's ability to hook into hyperref's internals unless\MessageBreak
+      hyperref is loaded first.}
+}
+%    \end{macrocode}
+%
 % \begin{macro}{\hyxmp@pdfauthor}
 % \begin{macro}{\hyxmp@pdfkeywords}
 % Prepare to store the name of the author and a list of keywords.