add a comment about commands defined elsewhere

latex3 · Jan 24, 2025 · 1fddf57 · 1fddf57
1 parent 1180e26
commit 1fddf57
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 2 deletions.
diff --git a/base/ltdefns.dtx b/base/ltdefns.dtx
@@ -32,7 +32,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{ltdefns.dtx}
-             [2024/09/06 v1.5t LaTeX Kernel (definition commands)]
+             [2025/01/24 v1.5t LaTeX Kernel (definition commands)]
 % \iffalse
 \documentclass{ltxdoc}
 \GetFileInfo{ltdefns.dtx}
@@ -943,6 +943,15 @@
 % \end{macro}
 % \end{macro}
 %
+% There are also \cs{@gobble@om}, \cs{@gobble@som},
+% \cs{@gobble@with@sphack@om}, and \cs{@gobble@with@sphack@som}. They
+% accept an optional and a mandatory argument, possibly preceeded by a
+% star. In all cases the expansion is empty or just manipulates the
+% spaces around the command.  Used to disable commands such as
+% \cs{index} or \cs{label} in certain situations.  Since they are
+% defined with \cs{DeclareDocumentCommand}, which is not yet available
+% at this point, the actual definition happens in \texttt{ltsect.dtx}.
+%
 % \begin{macro}{\@firstofone}
 % \begin{macro}{\@firstoftwo}
 % \begin{macro}{\@secondoftwo}

diff --git a/base/ltsect.dtx b/base/ltsect.dtx
@@ -823,7 +823,8 @@
 %
 %    Each of these four commands accepts an optional and a mandatory
 %    argument, possibly preceeded by a star. In all cases the
-%    expansion is empty.  Used to disable commands such as \cs{index}
+%    expansion is empty or just manipulates the spaces around the command.
+%    Used to disable commands such as \cs{index}
 %    or \cs{label} in certain situations.
 %    \begin{macrocode}
 %</2ekernel>