From 12f48e1d4530378c42f400053e03ef4d5b34ddcc 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 | 29 +++++++++++++++-------------- base/ltshipout.dtx | 16 ++++++++-------- 3 files changed, 28 insertions(+), 22 deletions(-) diff --git a/base/changes.txt b/base/changes.txt index 37d22f6a3..3bc8c9638 100644 --- a/base/changes.txt +++ b/base/changes.txt @@ -10,6 +10,11 @@ not part of the distribution. All changes above are only part of the development branch for the next release. ================================================================================ +2024-06-03 Joseph Wright + + * ltfilehook.dtx, ltshipout.dtx + Correct mark-up for commands with no documentation + ######################### # 2024-06-01 Release ######################### diff --git a/base/ltfilehook.dtx b/base/ltfilehook.dtx index 02e95d0f8..126ab2b71 100644 --- a/base/ltfilehook.dtx +++ b/base/ltfilehook.dtx @@ -34,7 +34,7 @@ %\iffalse %<*driver,structuredlog> %\fi -\def\ltfilehookdate{2024/03/13} +\def\ltfilehookdate{2024/06/03} \def\ltfilehookversion{v1.0o} %\iffalse % @@ -750,9 +750,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 @@ -1057,8 +1057,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} @@ -1219,8 +1219,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} @@ -1275,10 +1275,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 @@ -1294,7 +1296,6 @@ %\IncludeInRelease{2020/10/01}% % {@@_set_curr_file:nNN}{Set curr file}% \ExplSyntaxOn -%<@@=filehook> \cs_new_protected:Npn \@@_set_curr_file:nNN #1 { \exp_args:Nf \@@_file_parse_full_name:nN {#1} @@ -1311,7 +1312,7 @@ %<*2ekernel> % \end{macrocode} % \end{macro} -% +% \end{macro} % % % @@ -1803,7 +1804,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 0c9113ce9..63a13c640 100644 --- a/base/ltshipout.dtx +++ b/base/ltshipout.dtx @@ -34,7 +34,7 @@ %<*driver> % \fi \ProvidesFile{ltshipout.dtx} - [2024/02/11 v1.0n LaTeX Kernel (Shipout)] + [2024/06/03 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