Skip to content

Commit

Permalink
Correct mark-up for non-documented cmds
Browse files Browse the repository at this point in the history
  • Loading branch information
josephwright committed Feb 22, 2025
1 parent 19b1327 commit 70e92d6
Show file tree
Hide file tree
Showing 3 changed files with 25 additions and 22 deletions.
5 changes: 5 additions & 0 deletions base/changes.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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 <Joseph.Wright@latex-project.org>

* ltfilehook.dtx, ltshipout.dtx
Correct mark-up for commands with no documentation

2025-02-21 Ulrike Fischer <Ulrike.Fischer@latex-project.org>
* lttagging.dtx: move declaration of marginpar sockets from latex-lab into lttagging.

Expand Down
26 changes: 12 additions & 14 deletions base/ltfilehook.dtx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
%\iffalse
%<*driver,structuredlog>
%\fi
\def\ltfilehookdate{2025/01/25}
\def\ltfilehookdate{2025/02/22}
\def\ltfilehookversion{v1.0o}
%\iffalse
%</driver,structuredlog>
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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}
Expand Down Expand Up @@ -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}
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -1316,7 +1314,7 @@
%<*2ekernel>
% \end{macrocode}
% \end{macro}
%
% \end{macro}
%
%
%
Expand Down Expand Up @@ -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}
Expand Down
16 changes: 8 additions & 8 deletions base/ltshipout.dtx
Original file line number Diff line number Diff line change
Expand Up @@ -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}
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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.
Expand Down Expand Up @@ -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,
Expand Down Expand Up @@ -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<box>= value. This may has some implications in some
Expand Down

0 comments on commit 70e92d6

Please sign in to comment.