summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/undolabl/undolabl.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-02-15 03:01:49 +0000
committerNorbert Preining <norbert@preining.info>2023-02-15 03:01:49 +0000
commita7d99429152acee049db679dc26a92e01faf4992 (patch)
treec12bd699dd6c10d6efea6d36cfb71493181d98f5 /macros/latex/contrib/undolabl/undolabl.dtx
parentdc5dafdd7c01d469b556bc5bef745a6f1c84a5cb (diff)
CTAN sync 202302150301
Diffstat (limited to 'macros/latex/contrib/undolabl/undolabl.dtx')
-rw-r--r--macros/latex/contrib/undolabl/undolabl.dtx399
1 files changed, 160 insertions, 239 deletions
diff --git a/macros/latex/contrib/undolabl/undolabl.dtx b/macros/latex/contrib/undolabl/undolabl.dtx
index 180876aefd..f42347fef0 100644
--- a/macros/latex/contrib/undolabl/undolabl.dtx
+++ b/macros/latex/contrib/undolabl/undolabl.dtx
@@ -1,17 +1,18 @@
% \iffalse meta-comment
%
% File: undolabl.dtx
-% Version: 2015/03/29 v1.0l
+% Version: 2023-02-14 v1.0m
+% Info: Overriding labels
%
-% Copyright (C) 2010 - 2015 by
-% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de>
+% Copyright © 2010 - 2023 by
+% H.-Martin Münch <Martin dot Muench at Uni-Bonn dot de>
% Portions of code copyrighted by other people as marked.
%
% The main code of this package was invented by Ulrich Diez
% and first published in the comp.text.tex newsgroup
% at Sun, 20 Apr 2008 16:39:26 +0200, with subject:
% Re: How to undefine/overwrite a label? (see e.g.
-% http://groups.google.de/group/comp.text.tex/msg/af6cfe93917097da?dmode=source
+% https://groups.google.com/g/comp.text.tex/c/MBiR-EpPceo/m/2pdwkZP-bK8J
% ). While Ulrich Diez neither wanted to create a package himself yet
% nor have one published under his name, he granted the
% publication of his code. Therefore: Thanks!
@@ -20,15 +21,15 @@
% conditions of the LaTeX Project Public License, either
% version 1.3c of this license or (at your option) any later
% version. This version of this license is in
-% http://www.latex-project.org/lppl/lppl-1-3c.txt
+% https://www.latex-project.org/lppl/lppl-1-3c.txt
% and the latest version of this license is in
-% http://www.latex-project.org/lppl.txt
+% https://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of
-% LaTeX version 2005/12/01 or later.
+% LaTeX version 2005-12-01 or later.
%
% This work has the LPPL maintenance status "maintained".
%
-% The Current Maintainer of this work is H.-Martin Muench.
+% The Current Maintainer of this work is H.-Martin Münch.
%
% This work consists of the main source file undolabl.dtx,
% the README, and the derived files
@@ -36,12 +37,12 @@
% undolabl.ins, undolabl.drv,
% undolabl-example.tex, undolabl-example.pdf.
%
-% 'undolabl' is available on CTAN:
+% "undolabl" is available on CTAN:
% https://www.ctan.org/pkg/undolabl
%
% Also a TDS.ZIP file is provided that contains all the files
% already sorted in a TDS tree:
-% http://mirrors.ctan.org/install/macros/latex/contrib/undolabl.tds.zip
+% https://mirror.ctan.org/install/macros/latex/contrib/undolabl.tds.zip
%
%<*ignore>
\begingroup
@@ -56,10 +57,10 @@
%</ignore>
%<*install>
\input docstrip.tex
-\Msg{************************************************************}
-\Msg{* Installation}
-\Msg{* Package: undolabl 2015/03/29 v1.0l Overriding labels (HMM)}
-\Msg{************************************************************}
+\Msg{*************************************************************}
+\Msg{* Installation *}
+\Msg{* Package: undolabl 2023-02-14 v1.0m Overriding labels (HMM)*}
+\Msg{*************************************************************}
\keepsilent
\askforoverwritefalse
@@ -70,26 +71,21 @@
This is a generated file.
Project: undolabl
-Version: 2015/03/29 v1.0l
+Version: 2023-02-14 v1.0m
-Copyright (C) 2010 - 2015 by
- H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de>
+Copyright (C) 2010 - 2023 by
+ H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de>
Portions of code copyrighted by other people as marked.
-The usual disclaimer applies:
-If it doesn't work right that's your problem.
-(Nevertheless, send an e-mail to the maintainer
- when you find an error in this package.)
-
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either
version 1.3c of this license or (at your option) any later
version. This version of this license is in
- http://www.latex-project.org/lppl/lppl-1-3c.txt
+ https://www.latex-project.org/lppl/lppl-1-3c.txt
and the latest version of this license is in
- http://www.latex-project.org/lppl.txt
+ https://www.latex-project.org/lppl.txt
and version 1.3c or later is part of all distributions of
-LaTeX version 2005/12/01 or later.
+LaTeX version 2005-12-01 or later.
This work has the LPPL maintenance status "maintained".
@@ -100,7 +96,7 @@ Ulrich Diez (eu_angelion AT web DOT de)
and first published in the comp.text.tex newsgroup
at Sun, 20 Apr 2008 16:39:26 +0200, with subject:
Re: How to undefine/overwrite a label? (see e.g.
-http://groups.google.de/group/comp.text.tex/msg/af6cfe93917097da?dmode=source
+https://groups.google.com/g/comp.text.tex/c/MBiR-EpPceo/m/2pdwkZP-bK8J
). While Ulrich Diez neither wanted to create a package himself yet
nor have one published under his name, he granted the
publication of his code. Therefore: Thanks!
@@ -112,9 +108,9 @@ the README, and the derived files
undolabl-example.tex, undolabl-example.pdf.
In memoriam
- Claudia Simone Barth + 1996/01/30
- Tommy Muench + 2014/01/02
- Hans-Klaus Muench + 2014/08/24
+ Claudia Simone Barth + 1996-01-30
+ Tommy Muench + 2014-01-02
+ Hans-Klaus Muench + 2014-08-24
\endpreamble
\let\MetaPrefix\DoubleperCent
@@ -169,19 +165,14 @@ In memoriam
%
% \begin{macrocode}
%<*driver>
-\NeedsTeXFormat{LaTeX2e}[2014/05/01]
+\NeedsTeXFormat{LaTeX2e}[2022-11-01]
\ProvidesFile{undolabl.drv}%
- [2015/03/29 v1.0l Overriding labels (HMM)]
-\documentclass{ltxdoc}[2014/09/29]% v2.0u
-\usepackage{holtxdoc}[2012/03/21]% v0.24
-%% undolabl may work with earlier versions of LaTeX2e and those
-%% class and package, but this was not tested.
-%% Please consider updating your LaTeX, class, and package
-%% to the most recent version (if they are not already the most
-%% recent version).
+ [2023-02-14 v1.0m Overriding labels (HMM)]
+\documentclass{ltxdoc}[2022/06/22]% v2.1i
+\usepackage{holtxdoc}[2019/12/09]% v0.30
\hypersetup{%
- pdfsubject={LaTeX2e package for overriding labels (HMM)},%
- pdfkeywords={LaTeX, undolabl, undolabel, undo label, label, override, H.-Martin Muench},%
+ pdfsubject={Overriding labels (HMM)},%
+ pdfkeywords={LaTeX, undolabl, undolabel, undo label, label, override},%
pdfencoding=auto,%
pdflang={en},%
breaklinks=true,%
@@ -198,33 +189,13 @@ In memoriam
}
\CodelineIndex
\hyphenation{docu-ment}
-\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
\begin{document}
\DocInput{undolabl.dtx}%
\end{document}
%</driver>
% \end{macrocode}
-%
% \fi
%
-% \CheckSum{107}
-%
-% \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
-% Lower-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
-% Digits \0\1\2\3\4\5\6\7\8\9
-% Exclamation \! Double quote \" Hash (number) \#
-% Dollar \$ Percent \% Ampersand \&
-% Acute accent \' Left paren \( Right paren \)
-% Asterisk \* Plus \+ Comma \,
-% Minus \- Point \. Solidus \/
-% Colon \: Semicolon \; Less than \<
-% Equals \= Greater than \> Question mark \?
-% Commercial at \@ Left bracket \[ Backslash \\
-% Right bracket \] Circumflex \^ Underscore \_
-% Grave accent \` Left brace \{ Vertical bar \|
-% Right brace \} Tilde \~}
-%
% \GetFileInfo{undolabl.drv}
%
% \begingroup
@@ -242,23 +213,18 @@ In memoriam
% }%^^A
% \expandafter\endgroup\x
%
-% \DoNotIndex{\",\-,\,,\\,\noindent}
-% \DoNotIndex{\documentclass,\usepackage,\ProvidesPackage,\begin,\end}
-% \DoNotIndex{\MessageBreak}
-% \DoNotIndex{\NeedsTeXFormat,\DoNotIndex,\verb}
-% \DoNotIndex{\def,\edef,\gdef,\global}
-% \DoNotIndex{\ifx,\listfiles,\mathord,\mathrm}
-% \DoNotIndex{\kvoptions,\SetupKeyvalOptions,\ProcessKeyvalOptions}
-% \DoNotIndex{\bigskip,\space,\thinspace,\ldots}
-% \DoNotIndex{\indent,\noindent,\newline,\linebreak,\pagebreak,\newpage}
-% \DoNotIndex{\textbf,\textit,\textsf,\texttt,\textsc,\textquotedblleft,\textquotedblright}
-% \DoNotIndex{\plainTeX,\TeX,\LaTeX,\pdfLaTeX}
-% \DoNotIndex{\chapter,\section}
-% \DoNotIndex{\Large}
+% \DoNotIndex{\@auxout,\@bsphack,\@esphack,\@firstofone,\@gobble,\@ifl@t@r,\@ifundefined}
+% \DoNotIndex{\@namedef,\@secondoftwo,\\,\AddToHook,\begin,\begindocument,\bigskip}
+% \DoNotIndex{\csname,\documentclass,\empty,\end,\endcsname,\fmtversion,\g@addto@macro}
+% \DoNotIndex{\holtxdoc,\hypdoc,\hyperref,\if@filesw,\IfFormatAtLeastTF,\IfPackageAtLeastTF}
+% \DoNotIndex{\IfPackageLoadedTF,\ifx,\label,\listfiles,\MessageBreak,\nameref}
+% \DoNotIndex{\NeedsTeXFormat,\newcommand,\newline,\newpage,\PackageError,\PackageWarning}
+% \DoNotIndex{\pagenumbering,\pageref,\ProvidesPackage,\ref,\section,\space,\textsf}
+% \DoNotIndex{\usepackage}
%
% \title{The \xpackage{undolabl} package}
-% \date{2015/03/29 v1.0l}
-% \author{H.-Martin M\"{u}nch\\\xemail{Martin.Muench at Uni-Bonn.de}}
+% \date{2023-02-14 v1.0m}
+% \author{H.-Martin Münch\\\xemail{Martin.Muench at Uni-Bonn.de}}
%
% \maketitle
%
@@ -267,7 +233,7 @@ In memoriam
% especially automatically generated ones.
% \end{abstract}
%
-% \noindent \textbf{WARNING}: Since version 1.0d [2010/07/15] the |\undonewlabel|
+% \noindent \textbf{WARNING}: Since version 1.0d [2010-07-15] the |\undonewlabel|
% command takes only one argument,\\
% \texttt{\textbackslash undonewlabel\{<\textit{label name}>\}},\\
% instead of two,\\
@@ -280,7 +246,7 @@ In memoriam
% and first published in the \Newsgroup{comp.text.tex} newsgroup at\\
% \texttt{Sun,~20~Apr~2008~16:39:26~+0200}, with subject:\\
% \texttt{Re:~How~to~undefine/overwrite~a~label?} (see e.\,g.
-% \url{http://groups.google.de/group/comp.text.tex/msg/af6cfe93917097da?dmode=source}%
+% \url{https://groups.google.com/g/comp.text.tex/c/MBiR-EpPceo/m/2pdwkZP-bK8J}%
% ).\\
% While \textbf{ULRICH DIEZ} neither wanted to create a~package himself yet
% nor have one published under his name, he granted the publication of his code.
@@ -291,25 +257,14 @@ In memoriam
% \bigskip
%
% \noindent Disclaimer for web links: The author is not responsible for any contents
-% referred to in this work unless he has full knowledge of illegal contents.
-% If any damage occurs by the use of information presented there, only the
-% author of the respective pages might be liable, not the one who has referred
-% to these pages.
-%
-% \bigskip
-%
-% \noindent {\color{green} Save per page about $200\unit{ml}$ water,
-% $2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\\
-% Therefore please print only if this is really necessary.}
-%
-% \newpage
+% referred to in this work unless having full knowledge of illegal contents.
+% If any damage occurs by the use of information presented there,
+% only the author of the respective pages might be liable,
+% not the one who has referred to those pages.
%
% \tableofcontents
%
-% \newpage
-%
% \section{Introduction\label{sec:Introduction}}
-%
% \indent The package's name \texttt{undolabl} is an eight-letter
% abbreviation for the phrases ``undo'' and ``label''.\\
%
@@ -337,8 +292,8 @@ In memoriam
% \begin{verbatim}
% IF (macro \r@foo is already defined)
% THEN
-% - Issue an error-message,
-% - Make sure that the multiply-defined-labels-warning occurs
+% - issue an error-message,
+% - make sure that the multiply-defined-labels-warning occurs
% in the log-file
% ELSE
% \def\r@foo{{<page-no>}{<sectional no>}{<probably something else>}}
@@ -349,13 +304,11 @@ In memoriam
% |\ref{foo}| |->|
% \begin{description}
% \item[-] expand |\r@foo|: |{<page-no>}{<sectional no>}{<probably something else>}|
-%
% \item[-] grab the second from the resulting arguments: |<sectional no>|
% \end{description}
% |\pageref{foo}| |->|
% \begin{description}
% \item[-] expand |\r@foo|: |{<page-no>}{<sectional no>}{<probably something else>}|
-%
% \item[-] grab the first from the resulting arguments: |<page-no>|
% \end{description}
% Back to the |\label|-mechanism:
@@ -364,9 +317,7 @@ In memoriam
% get defined from reading the \xfile{.aux} file. The |\r@<label>|-macros
% get used by the referencing-macros (|\ref|, |\pageref|,\ldots{}) during
% the \LaTeX{}-run.
-%
% \item[-] During the \LaTeX{}-run, the \xfile{.aux} file gets rewritten.
-%
% \item[-] At the end of the \LaTeX{}-run, the \xfile{.aux} file (which was
% rewritten/newly created during the \LaTeX{}-run) is read in order
% to detect whether references have changed during the current
@@ -390,8 +341,8 @@ In memoriam
% \end{verbatim}
% So what do you need to do in order to override a label:
% \begin{description}
-% \item[-] First you need to write to the \xfile{.aux} file to silently undefine
-% the associated |\r@<label>|-macro if it is already defined.
+% \item[-] First you need to write to the \xfile{.aux} file to silently
+% undefine the associated |\r@<label>|-macro if it is already defined.
% That is why |\overridelabel| writes in terms of |\protected@write|
% to the \xfile{.aux} file:
% \begin{verbatim}
@@ -399,7 +350,6 @@ In memoriam
% \end{verbatim}
% |\undonewlabel| \textquotedblleft undefines\textquotedblright\ the
% |\r@<label>|-macro. (How this works will be explained below.)
-%
% \item[-] Then |\overridelabel| can call |\label{<label>}| again
% and thus produce another |\newlabel{<label>}|-entry to the
% \xfile{.aux} file.
@@ -421,21 +371,18 @@ In memoriam
%
% There is another issue left:
% \begin{description}
-% \item[-] It was said that \xfile{.aux} file is read at the beginning and at the
-% end of the \LaTeX{}-run for detecting whether references have changed.
-%
+% \item[-] It was said that \xfile{.aux} file is read at the beginning and
+% at the end of the \LaTeX{}-run for detecting whether references have changed.
% \item[-] When overriding a |<label>|, there will be several
% |\newlabel{<label>}|-calls associated to the same label-name in
% the \xfile{.aux} file.
-%
-% \item[-] At the beginning of the \LaTeX{}-run only the last one counts for
-% defining the associated |\r@<label>|-macro.
-%
-% \item[-] But at the end, when the new \xfile{.aux} file is read, they all count
-% and thus with all these entries but the last one, the
-% above-mentioned |\@testdef|-comparison will yield difference and thus
-% in any case cause a warning-message about references having
-% changed although that might not be a correct statement.
+% \item[-] At the beginning of the \LaTeX{}-run only the last one counts
+% for defining the associated |\r@<label>|-macro.
+% \item[-] But at the end, when the new \xfile{.aux} file is read,
+% they all count and thus with all these entries but the last one,
+% the above-mentioned |\@testdef|-comparison will yield difference
+% and thus in any case cause a warning-message about references
+% having changed although that might not be a correct statement.
% \end{description}
%
% \textbf{ULRICH DIEZ} decided to catch this up by his |\undolabl@testdef| command.
@@ -454,7 +401,6 @@ In memoriam
% |\undonewlabel| is |\let| equal to |\@gobble|.
%
% \section{Usage}
-%
% Load the package placing
% \begin{quote}
% |\usepackage{undolabl}|
@@ -468,12 +414,13 @@ In memoriam
% which would produce a\\
% |LaTeX Warning: Label `<label name>' multiply defined.|
%
-% \section{Example}
+% \newpage
%
+% \section{Example}
% \begin{macrocode}
%<*example>
-\documentclass[british]{article}[2007/10/19]% v1.4h
-\usepackage{undolabl}[2015/03/29]% v1.0l
+\documentclass[british]{article}[2022/07/02]% v1.4n
+\usepackage{undolabl}[2023-02-14]% v1.0m
%% There are no options for the undolabl package. %%
\usepackage[%
extension=pdf,%
@@ -484,62 +431,51 @@ In memoriam
pdftitle={undolabl package example},%
pdfauthor={H.-Martin Muench, after Ulrich Diez},%
pdfsubject={Example for the undolabl package},%
- pdfkeywords={LaTeX, undolabl, undolabel, H.-Martin Muench, Ulrich Diez},%
+ pdfkeywords={LaTeX, undolabl, undolabel},%
pdfview=FitH,%
pdfstartview=FitH,%
pdfpagelayout=OneColumn,%
bookmarksopen=true%
-]{hyperref}[2012/11/06]% v6.83m; when you want to use nameref
-\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
+]{hyperref}[2023-02-07]% v7.00v; when you want to use nameref
\listfiles
\begin{document}
\pagenumbering{arabic}
\section*{Example for undolabl}
-
This example demonstrates the use of package\newline
-\textsf{undolabl}, v1.0l as of 2015/03/29 (HMM).\newline
-For details please see the documentation!\newline
-
-\noindent Save per page about $200\unit{ml}$~water,
-$2\unit{g}$~CO$_{2}$ and $2\unit{g}$~wood:\newline
-Therefore please print only if this is really necessary.\newline
-I do NOT think, that it is necessary to print THIS file, really!
+\textsf{undolabl}, v1.0m as of 2023-02-14 (HMM).\newline
+For details please see the documentation!
\bigskip
\section{Test}
-
text \label{testlabel}\\
-page-reference: \pageref{testlabel}\\%% -> page 4
+page-reference: \pageref{testlabel}\\%% -> page 4
sectional-reference: \ref{testlabel}\\%% -> section 4
-name-reference: \nameref{testlabel}%% -> Still another test
+name-reference: \nameref{testlabel}%% -> Still another test
\newpage
\section{Another test}
-
text \overridelabel{testlabel}\\
-page-reference: \pageref{testlabel}\\%% -> page 4
+page-reference: \pageref{testlabel}\\%% -> page 4
sectional-reference: \ref{testlabel}\\%% -> section 4
-name-reference: \nameref{testlabel}%% -> Still another test
+name-reference: \nameref{testlabel}%% -> Still another test
\newpage
\section{Yet another test}
-
text \overridelabel{testlabel}\\
-page-reference: \pageref{testlabel}\\%% -> page 4
+page-reference: \pageref{testlabel}\\%% -> page 4
sectional-reference: \ref{testlabel}\\%% -> section 4
-name-reference: \nameref{testlabel}%% -> Still another test
+name-reference: \nameref{testlabel}%% -> Still another test
\newpage
\section{Still another test}
-
text \overridelabel{testlabel}\\
-page-reference: \pageref{testlabel}\\%% -> page 4
+page-reference: \pageref{testlabel}\\%% -> page 4
sectional-reference: \ref{testlabel}\\%% -> section 4
-name-reference: \nameref{testlabel}%% -> Still another test
+name-reference: \nameref{testlabel}%% -> Still another test
\end{document}
%</example>
@@ -547,12 +483,9 @@ name-reference: \nameref{testlabel}%% -> Still another test
%
% \StopEventually{}
%
-% \pagebreak
-%
% \section{The implementation}
-%
% For a somewhat longer description see section~\ref{sec:Introduction}.\\
-
+%
% We start off by checking that we are loading into \LaTeXe{} and
% announcing the name and version of this package.\\
%
@@ -561,26 +494,31 @@ name-reference: \nameref{testlabel}%% -> Still another test
% \end{macrocode}
%
% \begin{macrocode}
-\NeedsTeXFormat{LaTeX2e}[2014/05/01]
-\ProvidesPackage{undolabl}%
- [2015/03/29 v1.0l Overriding labels (HMM)]
-%% undolabl may work with earlier versions of LaTeX2e,
-%% but this was not tested. Please consider updating
-%% your LaTeX2e to the most recent version
-%% (if it is not already the most recent version).
+\NeedsTeXFormat{LaTeX2e}[2022-11-01]
+\ProvidesPackage{undolabl}[2023-02-14 v1.0m Overriding labels (HMM)]
+
+\@ifl@t@r\fmtversion{2022/11/01}{% would have understood
+ % \IfFormatAtLeastTF{2022-11-01}{<true code>}{<false code>}
+ }{\PackageError{undolabl}{%
+ Newer LaTeX format needed or older undolabl package%
+ }{Needed LaTeX format version: 2022-11-01 or newer.\MessageBreak%
+ Found\space\space LaTeX format version: \fmtversion.\MessageBreak%
+ Either update your TeX distribution\MessageBreak%
+ or use an archived version of undolabl\MessageBreak%
+ (see section History in the documentation).\MessageBreak%
+ }
+ }
% \end{macrocode}
%
-% \begin{macro}{\AtBeginDocument}
-%
-% |\AtBeginDocument| it is checked whether writing to files is allowed.
+% At |begindocument| it is checked whether writing to files is allowed.
% Some packages (e.\,g. \xpackage{tikz} and \xpackage{selectp}) sometimes prevent
% the output to the \xfile{aux} file. In that case a warning or an error message
% is issued. This is no problem as long as there is/was another compilation run
% where the labels can/could be processed via the \xfile{aux} file.
%
% \begin{macrocode}
-\AtBeginDocument{%
+\AddToHook{begindocument}{%
\if@filesw%
% \end{macrocode}
%
@@ -591,7 +529,7 @@ name-reference: \nameref{testlabel}%% -> Still another test
%
% \begin{macrocode}
\else%
- \@ifpackageloaded{tikz}{%
+ \IfPackageLoadedTF{tikz}{%
\PackageWarning{undolabl}%
{The undolabl package was not allowed to write to an\MessageBreak%
.aux file. This package does not work without access\MessageBreak%
@@ -612,8 +550,6 @@ name-reference: \nameref{testlabel}%% -> Still another test
\fi%
% \end{macrocode}
%
-% \newpage
-%
% The \textsf{undolabl} and the \textsf{acronym} packages shared some commands
% with the same names and where therefore incompatible. \textsc{Jan Heisswolf}
% (ITIV at KIT) reported this in 2014 (Thanks!). Changing the macros in the
@@ -625,9 +561,8 @@ name-reference: \nameref{testlabel}%% -> Still another test
% was just to check that no older acronym package is used:
%
% \begin{macrocode}
- \@ifpackageloaded{acronym}%
- {\@ifpackagelater{acronym}{2015/03/20}%
- {% later, OK
+ \IfPackageLoadedTF{acronym}%
+ {\IfPackageAtLeastTF{acronym}{2015/03/21}{% later, OK
}{\PackageError{undolabl}{Incompatible old acronym package detected}%
{The undolabl package is not compatible with the acronym package%
\MessageBreak%
@@ -640,8 +575,8 @@ name-reference: \nameref{testlabel}%% -> Still another test
}
% \end{macrocode}
-% \end{macro}
%
+% \begin{macro}{\overridelabel}
% \DescribeMacro{\overridelabel}
% In order to override a label, first one needs to write to the
% \xfile{.aux} file to silently undefine the associated |\r@<label>|-macro
@@ -666,22 +601,21 @@ name-reference: \nameref{testlabel}%% -> Still another test
% \begin{macrocode}
\label{#1}%
\fi%
- \@esphack%
- }
+\@esphack%
+}
% \end{macrocode}
-%
+% \end{macro}
+% \begin{macro}{\undonewlabel}
% \DescribeMacro{\undonewlabel}
-%
% \begin{macrocode}
\newcommand\undonewlabel{\@und@newl@bel r}
% \end{macrocode}
-%
+% \end{macro}
+% \begin{macro}{\@und@newl@bel}
% \DescribeMacro{\@und@newl@bel}
-%
% If |\r@<label>| is undefined, give an error message:
-%
% \begin{macrocode}
\newcommand\@und@newl@bel[2]{%
\@ifundefined{#1@#2}{%
@@ -690,12 +624,8 @@ name-reference: \nameref{testlabel}%% -> Still another test
A label which does not exist cannot be overridden.}%
}{%
% \end{macrocode}
-%
-% \pagebreak
-%
% \noindent otherwise:\newline
% Undefine |\r@label| via letting it equal to |\relax|:
-%
% \begin{macrocode}
\expandafter\global
\expandafter\let
@@ -704,11 +634,10 @@ name-reference: \nameref{testlabel}%% -> Still another test
}
% \end{macrocode}
-%
+% \end{macro}
+% \begin{macro}{\@overriddenmessage}
% \DescribeMacro{\@overriddenmessage}
-%
% Command for the notification of overriding a label:
-%
% \begin{macrocode}
\newcommand\@overriddenmessage[2]{%
\@ifundefined{#1@#2}{\global\@namedef{#1@#2}{i}}{%
@@ -718,9 +647,9 @@ name-reference: \nameref{testlabel}%% -> Still another test
}
% \end{macrocode}
-%
+% \end{macro}
+% \begin{macro}{\undolabl@testdef}
% \DescribeMacro{\undolabl@testdef}
-%
% \begin{macrocode}
\newcommand\undolabl@testdef[3]{%
\@ifundefined{s@#2}\@secondoftwo\@firstofone{%
@@ -734,23 +663,21 @@ name-reference: \nameref{testlabel}%% -> Still another test
}%
\expandafter\@gobble
\fi%
- }{\@testdef{#1}{#2}{#3}%
- }%
+ }{\@testdef{#1}{#2}{#3}%
+ }%
}
% \end{macrocode}
-%
-% \DescribeMacro{\protected@write\\@auxout}
-%
+% \end{macro}
+% \begin{macro}{\@auxout}
+% \DescribeMacro{\@auxout}
% \begin{macrocode}
-\if@filesw%
- \protected@write\@auxout{}{\string\reset@newl@bel}%
-\fi%
+\if@filesw\protected@write\@auxout{}{\string\reset@newl@bel}\fi
% \end{macrocode}
-%
+% \end{macro}
+% \begin{macro}{\reset@newl@bel}
% \DescribeMacro{\reset@newl@bel}
-%
% \begin{macrocode}
\newcommand\reset@newl@bel{%
\ifx\@newl@bel\@testdef%
@@ -760,17 +687,13 @@ name-reference: \nameref{testlabel}%% -> Still another test
}
% \end{macrocode}
-%
+% \end{macro}
% \begin{macrocode}
%</package>
% \end{macrocode}
%
-% \pagebreak
-%
% \section{Installation}
-%
-% \subsection{Downloads\label{ss:Downloads}}
-%
+% \subsection{Downloads}
% Everything is available at \url{https://www.ctan.org}
% but may need additional packages themselves.\\
%
@@ -778,15 +701,13 @@ name-reference: \nameref{testlabel}%% -> Still another test
% For unpacking the |undolabl.dtx| file and constructing the documentation
% it is required:
% \begin{description}
-% \item[-] \TeX{} Format \LaTeXe{}, \url{https://www.CTAN.org}
-%
-% \item[-] document class \xpackage{ltxdoc}, 2014/09/29, v2.0u,
+% \item[-] \TeX{} Format \LaTeXe{} [2022-11-01] (or newer),
+% \url{https://www.CTAN.org}
+% \item[-] document class \xpackage{ltxdoc}, 2022/06/22, v2.1i,
% \url{https://www.ctan.org/pkg/ltxdoc}
-%
-% \item[-] package \xpackage{holtxdoc}, 2012/03/21, v0.24,
+% \item[-] package \xpackage{holtxdoc}, 2019/12/09, v0.30,
% \url{https://www.ctan.org/pkg/holtxdoc}
-%
-% \item[-] package \xpackage{hypdoc}, 2011/08/19, v1.11,
+% \item[-] package \xpackage{hypdoc}, 2023-01-23, v1.18,
% \url{https://www.ctan.org/pkg/hypdoc}
% \end{description}
%
@@ -794,22 +715,23 @@ name-reference: \nameref{testlabel}%% -> Still another test
% The |undolabl.sty| for \LaTeXe{} (i.\,e.~each document using
% the \xpackage{undolabl} package) requires:
% \begin{description}
-% \item[-] \TeX{} Format \LaTeXe{}, \url{https://www.CTAN.org}
+% \item[-] \TeX{} Format \LaTeXe{} [2022-11-01] (or newer),
+% \url{https://www.CTAN.org}. Older versions of \pkg{undolabl}
+% work with older \LaTeXe{} distributions and have been archived,
+% see \nameref{History}.
% \end{description}
%
% \DescribeMacro{undolabl-example.tex}
% The |undolabl-example.tex| requires the same files as all
% documents using the \xpackage{undolabl} package and additionally:
% \begin{description}
-% \item[-] class \xpackage{article}, 2014/09/29, v1.4h,
+% \item[-] class \xpackage{article}, 2022/07/02, v1.4n,
% \url{https://www.ctan.org/pkg/article}
-%
-% \item[-] package \xpackage{hyperref}, 2012/11/06, v6.83m:
+% \item[-] package \xpackage{hyperref}, 2023-02-07, v7.00v,
% \url{https://www.ctan.org/pkg/hyperref},
% if |\nameref| shall be used (and when the references
% shall be hyperlinked, of course)
-%
-% \item[-] package \xpackage{undolabl}, 2015/03/29, v1.0l,
+% \item[-] package \xpackage{undolabl}, 2023-02-14, v1.0m,
% \url{https://www.ctan.org/pkg/undolabl}\\
% (Well, it is the example file for this package, and because you are reading
% the documentation for the \xpackage{undolabl} package, it can be assumed
@@ -822,28 +744,26 @@ name-reference: \nameref{testlabel}%% -> Still another test
% All packages of \textsc{Heiko Oberdiek}'s bundle `oberdiek'
% (especially \xpackage{holtxdoc} and \xpackage{hypdoc})
% are also available in a TDS compliant ZIP archive:\\
-% \url{http://mirrors.ctan.org/install/macros/latex/contrib/oberdiek.tds.zip}.\\
+% \url{https://mirror.ctan.org/install/macros/latex/contrib/oberdiek.tds.zip}.\\
% It is probably best to download and use this, because the packages in there
% are quite probably both recent and compatible among themselves.\\
%
% \DescribeMacro{hyperref}
% \xpackage{hyperref} is not included in that bundle and needs to be
% downloaded separately,\\
-% \url{http://mirror.ctan.org/install/macros/latex/contrib/hyperref.tds.zip}.\\
+% \url{https://mirror.ctan.org/install/macros/latex/contrib/hyperref.tds.zip}.\\
%
-% \DescribeMacro{M\"{u}nch}
+% \DescribeMacro{Münch}
% A hyperlinked list of my (other) packages can be found at\\
% \url{https://www.ctan.org/author/muench-hm}.
%
-% \pagebreak
-%
% \subsection{Package, unpacking TDS}
% \paragraph{Package.} This package is available at
% \url{https://www.ctan.org/pkg/undolabl}, especially
% the manual (README, undolabl.pdf), the example (source: undolabl-example.tex,
-% compiled: undolabl-example.pdf), and the undolabl.dtx.
+% compiled: undolabl-example.pdf), and the undolabl.dtx.
% There is also an undolabl.tds.zip available:
-% \url{http://mirrors.ctan.org/install/macros/latex/contrib/undolabl.tds.zip}
+% \url{https://mirror.ctan.org/install/macros/latex/contrib/undolabl.tds.zip}
% (everything in \xfile{TDS} compliant, compiled format),
% which additionally contains\\
% \begin{tabular}{ll}
@@ -944,9 +864,9 @@ name-reference: \nameref{testlabel}%% -> Still another test
%
% \subsection{Refresh file name databases}
%
-% If your \TeX{}~distribution (\teTeX{}, \mikTeX{},\dots{}) relies on file name
-% databases, you must refresh these. For example, \teTeX{} users run
-% \verb|texhash| or \verb|mktexlsr|.
+% If your \TeX~distribution (\TeX\,Live, \mikTeX, \dots) relies on
+% file name databases, you must refresh these. For example, \TeX\,Live\ users
+% run \verb|texhash| or \verb|mktexlsr|.
%
% \subsection{Some details for the interested}
%
@@ -994,34 +914,27 @@ name-reference: \nameref{testlabel}%% -> Still another test
% and first published in the \Newsgroup{comp.text.tex} newsgroup at\\
% \texttt{Sun,~20~Apr~2008~16:39:26~+0200}, with subject:\\
% \texttt{Re:~How~to~undefine/overwrite~a~label?} (see e.\,g.
-% \url{http://groups.google.de/group/comp.text.tex/msg/5ba8d4722e5cd326?dmode=source}
+% \url{https://groups.google.com/g/comp.text.tex/c/MBiR-EpPceo/m/2pdwkZP-bK8J}
% as well as \linebreak
-% \url{http://groups.google.de/group/comp.text.tex/msg/af6cfe93917097da?dmode=source}).\\
-% I (\textsc{H.-Martin M\"{u}nch}) would like to thank \textbf{ULRICH DIEZ}
+% \url{https://groups.google.com/g/comp.text.tex/c/0jzpQsn5dPs/m/Lrb45ByCZtMJ}).\\
+% I (\textsc{H.-Martin Münch}) would like to thank \textbf{ULRICH DIEZ}
% for this as well as for his permission to publish it on CTAN as well as
% for his bug reports.
% I also thank those anonymous people who had published the package somewhere else
% on the internet, where I found it first.
-% Further I would like to thank \textsc{Rainer Wintermute} for explaining the
-% |\CheckSum|, \textsc{Heiko Oberdiek} for providing a~lot~(!) of useful packages
-% (from which I also got everything I know about creating a file in \xfile{dtx} format,
-% OK, say it: copying), \textsc{Robin Fairbairns} and everybody of the CTAN team
-% for managing CTAN, and the \Newsgroup{comp.text.tex} and \Newsgroup{de.comp.text.tex}
+% Further I would like to thank \textsc{Heiko Oberdiek} for providing a~lot~(!) of useful
+% packages (from which I also got everything I know about creating a file in \xfile{dtx} format,
+% OK, say it: copying), and the \Newsgroup{comp.text.tex} and \Newsgroup{de.comp.text.tex}
% newsgroups for their help in all things \TeX{}.
%
-% \pagebreak
-%
+% \newpage
% \phantomsection
% \begin{History}\label{History}
-%
-% Some old versions have been archived at\\
-% \url{http://ctanhg.scharrer-online.de/pkg/undolabl.html}.
-%
% \begin{Version}{2008/04/20 v0.3(a)}
-% \item created by \textbf{ULRICH DIEZ}
+% \item Created by \textbf{ULRICH DIEZ}.
% \end{Version}
-% \begin{Version}{2010/04/08 v0.3b}
-% \item \xfile{.dtx} updated by \textsc{H.-Martin M\"{u}nch},
+% \begin{Version}{2010/04/08 v0.3b}
+% \item \xfile{.dtx} updated by \textsc{H.-Martin Münch},
% submitted to CTAN (no changes in the style code).
% \end{Version}
% \begin{Version}{2010/06/01 v1.0(a)}
@@ -1035,7 +948,7 @@ name-reference: \nameref{testlabel}%% -> Still another test
% I had to change author/maintainer of this package and resubmit it.
% \end{Version}
% \begin{Version}{2010/06/03 v1.0b}
-% \item Found an unchanged reference to the package author/maintainer.
+% \item Found an unchanged reference to the package authors/maintainer.
% \item Example adapted to other examples of mine.
% \item Updated references to other packages.
% \item \xfile{TDS} locations updated.
@@ -1053,17 +966,17 @@ name-reference: \nameref{testlabel}%% -> Still another test
% \item There was another update by \textbf{ULRICH DIEZ} on
% \Newsgroup{comp.text.tex} at
% \texttt{Mon,~21~Apr~2008~23:04:03~+0200}, see e.\,g.\\
-% \url{http://groups.google.de/group/comp.text.tex/msg/af6cfe93917097da?dmode=source},
+% \url{https://groups.google.com/g/comp.text.tex/c/MBiR-EpPceo/m/2pdwkZP-bK8J},
% which now has been included in this package.
% \item Put more emphasis on \textbf{ULRICH DIEZ} writing the initial code.
% \item Updated references to other packages and corrected the given location
-% of the \textsf{undolabl.tds.zip} file at CTAN.org.
+% of the \textsf{undolabl.tds.zip} file at \href{https://www.ctan.oeg/}{CTAN.org}.
% \end{Version}
% \begin{Version}{2010/07/25 v1.0e}
% \item Bugs reported by \textbf{ULRICH DIEZ} on \Newsgroup{comp.text.tex} at\\
% \texttt{Sat,~17~Jul~2010~12:27:10~+0200},
% subject \texttt{Re:~CTAN~Update:~undolabl}, see e.\,g.
-% \url{http://groups.google.com/group/comp.text.tex/msg/d366821ce4f8b62e?dmode=source},
+% \url{https://groups.google.com/g/comp.text.tex/c/0jzpQsn5dPs/m/Lrb45ByCZtMJ},
% eradicated.
% \item |\StopEventually| added and |\CheckSum| value corrected (was~$0$).
% \item Minor details.
@@ -1107,12 +1020,20 @@ name-reference: \nameref{testlabel}%% -> Still another test
% by \textsf{acronym} package, thanks! Check for older versions introduced.
% \item Introduced a check, whether writing to the \xfile{aux} file is allowed.
% \item Update of documentation, README, and \xfile{dtx} internals.
+% \item This version has been archived at\\
+% \url{https://web.archive.org/web/20190417090001/https://mirror.ctan.org/install/macros/latex/contrib/undolabl.tds.zip}
+% \end{Version}
+% \begin{Version}{2023-02-14 v1.0m}
+% \item Removed |\unit|.
+% \item Converted to UTF-8.
+% \item Updated to \LaTeX{} format 2022-11-01.
+% \item Documentation updated (there were lots of outdated urls).
% \end{Version}
% \end{History}
%
% \bigskip
%
-% \noindent When you find a mistake or have a suggestion for an improvement of this package,
+% When you find a mistake or have a suggestion for an improvement of this package,
% please send an e-mail to the maintainer, thanks! (Please see BUG REPORTS in the README.)
%
% \bigskip