summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/tex')
-rw-r--r--Master/texmf-dist/tex/latex/cleveref-usedon/cleveref-usedon.sty165
1 files changed, 119 insertions, 46 deletions
diff --git a/Master/texmf-dist/tex/latex/cleveref-usedon/cleveref-usedon.sty b/Master/texmf-dist/tex/latex/cleveref-usedon/cleveref-usedon.sty
index 9f23e91dcdf..3fec64b2234 100644
--- a/Master/texmf-dist/tex/latex/cleveref-usedon/cleveref-usedon.sty
+++ b/Master/texmf-dist/tex/latex/cleveref-usedon/cleveref-usedon.sty
@@ -30,28 +30,58 @@
%% LaTeX version 2005/12/01 or later.
%% -----------------------------------------------------------------------
%%
-\def\packageversion{0.2.0}
-\def\packagedate{2023-04-07}
-\NeedsTeXFormat{LaTeX2e}[2022/06/01]
-\RequirePackage{expl3}
+\def\UsedOnPackageVersion{0.4.0}
+\def\UsedOnPackageDate{2023-04-21}
+\NeedsTeXFormat{LaTeX2e}[2021-06-01]
\ProvidesExplPackage{cleveref-usedon}
- {\packagedate}
- {\packageversion}
+ {\UsedOnPackageDate}
+ {\UsedOnPackageVersion}
{Patches the cleveref package and adds forward-referencing functionality}
+%%
+\providecommand\IfFormatAtLeastTF{\@ifl@t@r\fmtversion}
+\IfFormatAtLeastTF{2021-06-01}{%
+ % LaTeX2e version new enough
+}{%
+ \PackageError{cleveref-usedon}{%
+ Mismatched~LaTeX~support~files~detected.\MessageBreak
+ Your~LaTeX~format~is~dated~\fmtversion,\MessageBreak
+ but~the~package~cleveref-usedon\MessageBreak
+ requires~at~least~2021-06-01.\MessageBreak
+ Update~your~TeX~distribution.\MessageBreak
+ \MessageBreak
+ Loading~cleveref-usedon~will~abort!}%
+ {Update~your~TeX~distribution~using~your~TeX~package~manager.}%
+}
+\providecommand\IfExplAtLeastTF{\@ifl@t@r\ExplLoaderFileDate}
+\RequirePackage{expl3}[2021-05-16]
+\IfExplAtLeastTF{2021-05-16}{%
+ % expl3 version new enough
+}{%
+ \PackageError{cleveref-usedon}{%
+ Support~package~expl3~too~old.\MessageBreak
+ The~L3~programming~layer~in~the~LaTeX~format\MessageBreak
+ is~dated~\ExplLoaderFileDate,\MessageBreak
+ but~the~package~cleveref-usedon\MessageBreak
+ requires~at~least~2021-05-16.\MessageBreak
+ Update~your~TeX~distribution.\MessageBreak
+ \MessageBreak
+ Loading~cleveref-usedon~will~abort!}%
+ {Update~your~TeX~distribution~using~your~TeX~package~manager.}%
+}
\RequirePackage{xparse}
-\bool_new:N \g_StandardBehaviour_bool
-\bool_gset_true:N \g_StandardBehaviour_bool
+\bool_new:N \g__UsedOn_StandardBehaviour_bool
+\bool_gset_true:N \g__UsedOn_StandardBehaviour_bool
\DeclareOption{usedon}{
\OptionNotUsed
- \bool_gset_true:N \g_StandardBehaviour_bool
+ \bool_gset_true:N \g__UsedOn_StandardBehaviour_bool
}
\DeclareOption{notusedon}{
\OptionNotUsed
- \bool_gset_false:N \g_StandardBehaviour_bool
+ \bool_gset_false:N \g__UsedOn_StandardBehaviour_bool
}
\DeclareOption*{
\PackageInfo{cleveref-usedon}
- {Passing~to~cleveref:~Option~`\CurrentOption'}
+ {Passing~option~'\CurrentOption'~to~cleveref}
\PassOptionsToPackage{\CurrentOption}{cleveref}
}
\ProcessOptions*
@@ -63,46 +93,74 @@
\newcommand*{\@setlabelcpagerefrange}[3]{%
\@@setcpagerefrange{#1}{#2}{labelcref}{#3}}
\prg_generate_conditional_variant:Nnn \str_case:nn { x } { TF }
+\cs_generate_variant:Nn \str_case:nn { x }
\seq_new:N \g__UsedOn_k_seq
\prop_new:N \g__UsedOn_kv_prop
+\clist_new:N \g__UsedOn_Options_clist
+\clist_set:Nn \g__UsedOn_Options_clist {UsedOn, UsedBy, UsedByAndOn}
\NewDocumentCommand{\UsedOnMessage}{m}{
- \emph{(Used~on~#1.)} \\
+ \emph{(Used~on~#1.)} \newline
}
-\NewDocumentCommand{\__UsedOn_PrintUsedOnLabel}{ m }{%
-%% % Check if the reference UsedOn@<LabelName>@1 exists
+\NewDocumentCommand{\UsedByMessage}{ m }{
+ \emph{(Used~by~#1.)} \newline
+}
+\NewDocumentCommand{\UsedByAndOnMessage}{ m m }{
+ \emph{(Used~by~#1~on~#2.)} \newline
+}
+\NewDocumentCommand{\__UsedOn_Printer}{ m m }{%
+%% % Check if the reference #1@<LabelName>@1 exists
%% % Here the @1 means that <LabelName> has been referenced
-%% % with option `UsedOn' at least once
- \cs_if_exist:cT {r@UsedOn@#1@1}
+%% % with option #1 at least once where #1 is
+%% % 'UsedOn', 'UsedBy' or 'UsedByAndOn'
+ \cs_if_exist:cT {r@#1@#2@1}
{
%% % In a tmp clist we store all the references of the form
-%% % `UsedOn@<LabelName>@<Number>`
+%% % `<Option>@<LabelName>@<Number>`
%% % where Number between 1 and \value{LastRun@UsedOn@<LabelName>}
%% % if the latter exists, otherwise until 1
%% % Should/will normally need two consecutive runs of pdflatex
- \cs_if_free:cTF {c@LastRun@UsedOn@#1}
+ \cs_if_free:cTF {c@LastRun@#1@#2}
{ \int_set:Nn \l_tmpa_int { 1 } }
- { \int_set:Nn \l_tmpa_int { \value{LastRun@UsedOn@#1} } }
+ { \int_set:Nn \l_tmpa_int { \value{LastRun@#1@#2} } }
\int_set:Nn \l_tmpb_int { 1 }
\int_while_do:nn { \l_tmpb_int <= \l_tmpa_int }
{
- \clist_put_right:Nx \l_tmpa_clist { UsedOn@#1@\int_use:N \l_tmpb_int }
+ \clist_put_right:Nx \l_tmpa_clist { #1@#2@\int_use:N \l_tmpb_int }
\int_incr:N \l_tmpb_int
}
%% % Print `UsedOn` message by calling \cpageref with the parameter clist above
-%% % Uncomment the next two lines to see the contents of \l_tmpa_clist
-%% %% Arguments~of~cpageref~are:
+%% % Uncomment the next two lines for debugging to see the contents of \l_tmpa_clist
+%% %% Arguments~of~cpageref/cref~are:
%% %% \par\clist_use:Nn \l_tmpa_clist {\par}\par
- \UsedOnMessage{\cpageref{\l_tmpa_clist}}
+ \str_case:xn { \str_foldcase:n { #1 } }
+ {
+ {usedon}
+ {\UsedOnMessage{\cpageref{\l_tmpa_clist}}}
+ {usedby}
+ {\UsedByMessage{\cref{\l_tmpa_clist}}}
+ {usedbyandon}
+ {\UsedByAndOnMessage{\cref{\l_tmpa_clist}}
+ {\cpageref{\l_tmpa_clist}}}
+ }
}
}%
+\NewDocumentCommand{\__UsedOn_PrintMessage}{ m }{%
+ \clist_map_inline:Nn \g__UsedOn_Options_clist
+ { \__UsedOn_Printer{##1}{#1} }
+}%
+\str_new:N \l__UsedOn_Option_str
\NewDocumentCommand{\__UsedOn_Processor}{ o m }{%
\IfValueT{#1}{
\str_case:xnTF { \str_foldcase:n { #1 } }
{
-%% % check if option 'UsedOn' (case-insensitive) was used
-%% % in one of the following forms
- {usedon} {}
- {uo} {}
+%% % check if options 'UsedOn', 'UsedBy' or 'UsedByAndOn'
+%% % (case-insensitive) were used in one of the following forms
+ {usedon} {\str_set:Nn \l__UsedOn_Option_str {UsedOn}}
+ {uo} {\str_set:Nn \l__UsedOn_Option_str {UsedOn}}
+ {usedby} {\str_set:Nn \l__UsedOn_Option_str {UsedBy}}
+ {ub} {\str_set:Nn \l__UsedOn_Option_str {UsedBy}}
+ {usedbyandon} {\str_set:Nn \l__UsedOn_Option_str {UsedByAndOn}}
+ {ubao} {\str_set:Nn \l__UsedOn_Option_str {UsedByAndOn}}
}
{
{
@@ -112,26 +170,38 @@
{
%% % if the label has not been referenced yet,
%% % create a counter for the current and last run and save the label in the
-%% % global container \g__UsedOn_k_seq
- \seq_if_in:NxF \g__UsedOn_k_seq {UsedOn@##1}
+%% % global container \g_@@_k_seq
+ \seq_if_in:NxF \g__UsedOn_k_seq
+ { \l__UsedOn_Option_str @##1}
{
- \newcounter{ThisRun@UsedOn@##1}
- \cs_if_free:cT {c@LastRun@UsedOn@##1}
- { \newcounter{LastRun@UsedOn@##1} }
- \seq_gput_right:Nx \g__UsedOn_k_seq {UsedOn@##1}
+ \newcounter{
+ ThisRun@ \l__UsedOn_Option_str @##1
+ }
+ \cs_if_free:cT {c@LastRun@ \l__UsedOn_Option_str @##1}
+ {
+ \newcounter{LastRun@ \l__UsedOn_Option_str @##1}
+ }
+ \seq_gput_right:Nx \g__UsedOn_k_seq
+ { \l__UsedOn_Option_str @##1}
}
%% % increase the counters and compare with max counter
- \stepcounter{ThisRun@UsedOn@##1}
- \setcounter{LastRun@UsedOn@##1}{%
- \fp_eval:n { max(%
- \value{ThisRun@UsedOn@##1},%
- \value{LastRun@UsedOn@##1} ) }%
+ \stepcounter{ThisRun@ \l__UsedOn_Option_str @##1}
+ \setcounter{LastRun@ \l__UsedOn_Option_str @##1}{%
+ \fp_eval:n
+ { max(%
+ \value{ThisRun@ \l__UsedOn_Option_str @##1},%
+ \value{LastRun@ \l__UsedOn_Option_str @##1}
+ ) }%
}
%% % store the value in global key-value property list
\prop_gput:Nxx \g__UsedOn_kv_prop
- {UsedOn@##1} {\arabic{LastRun@UsedOn@##1}}
+ { \l__UsedOn_Option_str @##1}
+ {\arabic{LastRun@ \l__UsedOn_Option_str @##1}}
%% % create a label for the UsedOn reference and number this label
- \__UsedOn_origlabel{UsedOn@##1@\arabic{ThisRun@UsedOn@##1}}
+ \__UsedOn_origlabel{
+ \l__UsedOn_Option_str @##1@
+ \arabic{ThisRun@ \l__UsedOn_Option_str @##1}
+ }
}
}
}
@@ -139,10 +209,10 @@
%% % Throw an error, if an unrecognised option was used
%% % for the optional argument to this macro.
\msg_new:nnn {cleveref-usedon} { OptionSpellingError }
- { \\
+ { \MessageBreak
Spelling~error~\msg_line_context:
- \\
- Did~you~mean~to~pass~option\\
+ \MessageBreak
+ Did~you~mean~to~pass~option\MessageBreak
'UsedOn'~to~cref~or~Cref?
}
\msg_fatal:nn { cleveref-usedon } { OptionSpellingError }
@@ -165,7 +235,7 @@
}
}%
\NewDocumentCommand{\__UsedOn_WriteToAux}{ }{%
-%% % First, we clear the global key-value prop list |\g__UsedOn_kv_prop| and
+%% % First, we clear the global key-value prop list \cs{g_@@_kv_prop} and
%% % then we rebuild it with the information from the current run.
\prop_clear:N \g__UsedOn_kv_prop
\seq_map_inline:Nn \g__UsedOn_k_seq
@@ -177,7 +247,10 @@
\prop_map_inline:Nn \g__UsedOn_kv_prop
{
\iow_now:cx { @auxout }
- { \prop_gput_from_keyval:Nn \token_to_str:N \g__UsedOn_kv_prop {##1=##2} }
+ {
+ \prop_gput_from_keyval:Nn \token_to_str:N \g__UsedOn_kv_prop
+ {##1=##2}
+ }
}
%% % Turn off |expl3| functionality in .aux file.
\iow_now:cx { @auxout }
@@ -189,7 +262,7 @@
\NewCommandCopy{\__UsedOn_origcref}{\cref}
\NewCommandCopy{\__UsedOn_origCref}{\Cref}
\RenewDocumentCommand{\label}{ m }{%
- \__UsedOn_origlabel{#1}\__UsedOn_PrintUsedOnLabel{#1}
+ \__UsedOn_origlabel{#1}\__UsedOn_PrintMessage{#1}
}%
\RenewCommandCopy{\cref}{\__UsedOn_cref}
\RenewCommandCopy{\Cref}{\__UsedOn_Cref}
generated by cgit v1.2.3 (git 2.39.1) at 2024-11-10 02:07:44 +0000