summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/zref-check/zref-check.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-04-23 03:00:42 +0000
committerNorbert Preining <norbert@preining.info>2022-04-23 03:00:42 +0000
commit4acee1a3ab0aae587d4f0a4327141056ee7e6081 (patch)
tree1cde72d1e942ae756d750c665cd346533074171b /macros/latex/contrib/zref-check/zref-check.dtx
parentc65c806536b3d6b228d5d71f0e0c835968a3733a (diff)
CTAN sync 202204230300
Diffstat (limited to 'macros/latex/contrib/zref-check/zref-check.dtx')
-rw-r--r--macros/latex/contrib/zref-check/zref-check.dtx37
1 files changed, 27 insertions, 10 deletions
diff --git a/macros/latex/contrib/zref-check/zref-check.dtx b/macros/latex/contrib/zref-check/zref-check.dtx
index 186173b35c..9647be95fe 100644
--- a/macros/latex/contrib/zref-check/zref-check.dtx
+++ b/macros/latex/contrib/zref-check/zref-check.dtx
@@ -24,7 +24,7 @@
% zref-check.ins,
% zref-check.tex,
% zref-check-code.tex,
-% and the files listed in MANIFEST.md.
+% and the files generated from them.
%
% The released version of this package is available from CTAN.
%
@@ -124,12 +124,14 @@
% \section{Loading the package}
% \label{sec:loading-package}
%
-% As usual:
+% \pkg{zref-check} can be loaded with the usual:
%
% \begin{syntax}
-% \cs{usepackage}\oarg{options}|{zref-check}|
+% \cs{usepackage}|{zref-check}|
% \end{syntax}
%
+% The package does not accept load-time options, package options must be set
+% using \cs{zrefchecksetup} (see Section~\ref{sec:user-interface}).
%
%
% \section{Dependencies}
@@ -469,7 +471,11 @@
% A change log with relevant changes for each version, eventual upgrade
% instructions, and upcoming changes, is maintained in the package's
% repository, at
-% \url{https://github.com/gusbrs/zref-check/blob/main/CHANGELOG.md}.
+% \url{https://github.com/gusbrs/zref-check/blob/main/CHANGELOG.md}. The
+% change log is also distributed with the package's documentation through CTAN
+% upon release so, most likely, \texttt{texdoc zref-check/changelog} should
+% provide easy local access to it. An archive of historical versions of the
+% package is also kept at \url{https://github.com/gusbrs/zref-check/releases}.
%
%
%
@@ -510,7 +516,7 @@
%
% Identify the package.
% \begin{macrocode}
-\ProvidesExplPackage {zref-check} {2022-02-11} {0.2.5}
+\ProvidesExplPackage {zref-check} {2022-04-22} {0.3.0}
{Flexible cross-references with contextual checks based on zref}
% \end{macrocode}
%
@@ -660,6 +666,11 @@
}
\msg_new:nnn { zref-check } { option-deprecated }
{ Option~'#1'~has~been~deprecated~\msg_line_context:. }
+\msg_new:nnn { zref-check } { load-time-options }
+ {
+ 'zref-check'~does~not~accept~load-time~options.~
+ To~configure~package~options,~use~'\iow_char:N\\zrefchecksetup'.
+ }
% \end{macrocode}
%
%
@@ -918,11 +929,17 @@
%
% \subsubsection*{Package options}
%
-% Process load-time package options
-% (\url{https://tex.stackexchange.com/a/15840}).
-% \begin{macrocode}
-\RequirePackage { l3keys2e }
-\ProcessKeysOptions { zref-check }
+% \pkg{zref-check} does not accept load-time options. Despite the tradition
+% of so doing, Joseph Wright has a point in recommending otherwise at
+% \url{https://chat.stackexchange.com/transcript/message/60360822#60360822}:
+% separating ``loading the package'' from ``configuring the package'' grants
+% less trouble with ``option clashes'' and with expansion of options at
+% load-time.
+% \begin{macrocode}
+\bool_lazy_and:nnT
+ { \tl_if_exist_p:c { opt@ zref-check.sty } }
+ { ! \tl_if_empty_p:c { opt@ zref-check.sty } }
+ { \msg_warning:nn { zref-check } { load-time-options } }
% \end{macrocode}
%
%