From 70e92d6d97ba47cf3e250096e53e6519680150d1 Mon Sep 17 00:00:00 2001 From: Joseph Wright Date: Mon, 3 Jun 2024 17:41:20 +0100 Subject: [PATCH] Correct mark-up for non-documented cmds --- base/changes.txt | 5 +++++ base/ltfilehook.dtx | 26 ++++++++++++-------------- base/ltshipout.dtx | 16 ++++++++-------- 3 files changed, 25 insertions(+), 22 deletions(-) diff --git a/base/changes.txt b/base/changes.txt index f30aa9113..32f558166 100644 --- a/base/changes.txt +++ b/base/changes.txt @@ -6,6 +6,11 @@ to completeness or accuracy and it contains some references to files that are not part of the distribution. ================================================================================ +2025-02-22 Joseph Wright + + * ltfilehook.dtx, ltshipout.dtx + Correct mark-up for commands with no documentation + 2025-02-21 Ulrike Fischer * lttagging.dtx: move declaration of marginpar sockets from latex-lab into lttagging. diff --git a/base/ltfilehook.dtx b/base/ltfilehook.dtx index e8f525700..0f0742507 100644 --- a/base/ltfilehook.dtx +++ b/base/ltfilehook.dtx @@ -34,7 +34,7 @@ %\iffalse %<*driver,structuredlog> %\fi -\def\ltfilehookdate{2025/01/25} +\def\ltfilehookdate{2025/02/22} \def\ltfilehookversion{v1.0o} %\iffalse % @@ -752,9 +752,9 @@ % \LaTeXe{} core commands, because of some circular dependencies in the % kernel we do this only now and not in \texttt{ltfiles}. % -% \begin{macro}{\InputIfFileExists} -% \begin{macro}{\@input@file@exists@with@hooks} -% \begin{macro}{\unqu@tefilef@und} +% \begin{macro}[no-user-doc]{\InputIfFileExists} +% \begin{macro}[int]{\@input@file@exists@with@hooks} +% \begin{macro}[int]{\unqu@tefilef@und} % \cs{InputIfFileExists} loads any file if it is available so we % have to add the hooks \hook{file/before} and % \hook{file/after} in the right places. If the file doesn't @@ -1059,8 +1059,8 @@ % % \subsection{Selecting a file (\cs{set@curr@file})} % -% \begin{macro}{\set@curr@file,\set@curr@file@nosearch} -% \begin{macro}{\@curr@file,\@curr@file@reqd} +% \begin{macro}[no-user-doc]{\set@curr@file,\set@curr@file@nosearch} +% \begin{macro}[int]{\@curr@file,\@curr@file@reqd} % \changes{v1.0f}{2021/01/31}{set \cs{protect} to \cs{string} gh/481} % Now we hook into \cs{set@curr@file} to resolve a possible file % substitution, and add \cs{@expl@@@filehook@set@curr@file@@nNN} @@ -1221,8 +1221,8 @@ % % % -% \begin{macro}{\@filehook@set@CurrentFile} -% \begin{macro}{\@kernel@make@file@csname,\@set@curr@file@aux} +% \begin{macro}[int]{\@filehook@set@CurrentFile} +% \begin{macro}[int]{\@kernel@make@file@csname,\@set@curr@file@aux} % % \fmi{This should get internalized using \texttt{@expl@} names} % \begin{macrocode} @@ -1277,14 +1277,12 @@ % \end{macro} % \end{macro} % -% % \begin{macrocode} %<@@=filehook> % \end{macrocode} % -% -% \begin{macro}{\@@_set_curr_file:nNN, -% \@@_set_curr_file_assign:nnnNN} +% \begin{macro}{\@@_set_curr_file:nNN} +% \begin{macro}{\@@_set_curr_file_assign:nnnNN} % When inputting a file, \cs{set@curr@file} does a file lookup % (in \cs{input@path} and \cs{l_file_search_path_seq}) and returns the % actual file name (\meta{base} plus \meta{ext}) in @@ -1316,7 +1314,7 @@ %<*2ekernel> % \end{macrocode} % \end{macro} -% +% \end{macro} % % % @@ -1808,7 +1806,7 @@ \newcommand\AtVeryVeryEnd {\AddToHook{enddocument/end}} % \end{macrocode} % -% \begin{macro}{\BeforeClearDocument} +% \begin{macro}[no-user-doc]{\BeforeClearDocument} % This one is the only one we don't implement or rather don't have % a dedicated hook in the code. % \begin{macrocode} diff --git a/base/ltshipout.dtx b/base/ltshipout.dtx index a15bbb88f..11ee4609d 100644 --- a/base/ltshipout.dtx +++ b/base/ltshipout.dtx @@ -34,7 +34,7 @@ %<*driver> % \fi \ProvidesFile{ltshipout.dtx} - [2024/10/22 v1.0n LaTeX Kernel (Shipout)] + [2025/02/22 v1.0n LaTeX Kernel (Shipout)] % \iffalse % \documentclass{l3doc} @@ -1144,7 +1144,7 @@ % % % -% \begin{macro}{\@kernel@after@shipout@lastpage, +% \begin{macro}[no-user-doc]{\@kernel@after@shipout@lastpage, % \@kernel@before@shipout@background, % \@kernel@after@shipout@background} % And here are the internal kernel hooks going before or after the @@ -1668,7 +1668,7 @@ % % % -% \begin{macro}{\@abspage@last} +% \begin{macro}[int]{\@abspage@last} % In \cs{@abspage@last} record the number of pages from the last % run. This is written to the \texttt{.aux} and this way made % available to the next run. In case there is no \texttt{.aux} file @@ -1683,7 +1683,7 @@ % \end{macro} % % -% \begin{macro}{\enddocument} +% \begin{macro}[no-user-doc]{\enddocument} % % Instead of using the hooks \hook{enddocument} and % \hook{enddocument/afterlastpage} we add this code to private @@ -1700,7 +1700,7 @@ % be wrong but then rerunning the document will give us the correct % value next time around. % -% \begin{macro}{\@kernel@after@enddocument} +% \begin{macro}[no-user-doc]{\@kernel@after@enddocument} % \begin{macrocode} \g@addto@macro \@kernel@after@enddocument { \int_compare:nNnT \@abspage@last = \maxdimen @@ -1714,7 +1714,7 @@ % \end{macrocode} % \end{macro} % -% \begin{macro}{\@kernel@after@enddocument@afterlastpage} +% \begin{macro}[no-user-doc]{\@kernel@after@enddocument@afterlastpage} % Once the \cs{clearpage} has done its work inside \cs{enddocument} % we know for sure how many pages this document has, so we record % that in the \texttt{.aux} file for the next run. @@ -1891,7 +1891,7 @@ %<@@=> % \end{macrocode} % -% \begin{macro}{\@expl@@@shipout@add@firstpage@material@@Nn, +% \begin{macro}[int]{\@expl@@@shipout@add@firstpage@material@@Nn, % \@expl@@@shipout@add@background@box@@n, % \@expl@@@shipout@add@foreground@box@@n, % \@expl@@@shipout@add@background@picture@@n, @@ -2152,7 +2152,7 @@ % \end{macro} % % -% \begin{macro}{\ShipoutBoxHeight,\ShipoutBoxWidth,\ShipoutBoxDepth} +% \begin{macro}[no-user-doc]{\ShipoutBoxHeight,\ShipoutBoxWidth,\ShipoutBoxDepth} % This is somewhat different from the original in \pkg{atbegshi} % where \cs{ShipoutBoxHeight} etc.\ only holds the % \verb=\the\ht= value. This may has some implications in some