[latex3-commits] [latex3/latex2e] ltmarks-multicol: mostly done (e0f4c8e77)

[github at latex-project.org]

Repository : https://github.com/latex3/latex2e
On branch  : ltmarks-multicol
Link       : https://github.com/latex3/latex2e/commit/e0f4c8e77f50d6dd2bd21751c519cb3602c882d4

>---------------------------------------------------------------

commit e0f4c8e77f50d6dd2bd21751c519cb3602c882d4
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Tue Nov 12 00:11:57 2024 +0100

    mostly done


>---------------------------------------------------------------

e0f4c8e77f50d6dd2bd21751c519cb3602c882d4
 base/ltmarks.dtx            | 10 ++++++++--
 required/tools/multicol.dtx | 10 +++++-----
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/base/ltmarks.dtx b/base/ltmarks.dtx
index 8f507e9e1..9a3ac17a4 100644
--- a/base/ltmarks.dtx
+++ b/base/ltmarks.dtx
@@ -697,12 +697,14 @@
 %  be taken care of---those are discussed in the implementation sections.
 %
 %
-% \section{Internal output routine functions}
+% \section{Internal functions for \LaTeX's standard output routine and \pkg{multicol}}
 %
 % The functions in this section are tied to the output routine and used in the
 % interface to \LaTeXe{} and perhaps at some later time within a new
 % output routine
-% for \LaTeX. They are not meant for general use and are therefore made internal.
+% for \LaTeX. They are not (yet) meant for general use and are
+% therefore made internal, even though we already use them in
+% \pkg{multicol}. 
 % Internal means that \verb|@@| automatically gets
 % replaced in the code (and in the documentation) so we have to give
 % it a suitable value.
@@ -734,6 +736,10 @@
 %   marks. It too is called as part of \cs{@opcol}.
 % \end{function}
 %
+% \subsection{Candidates for a public interface}
+%
+% The remaining functions in this section may get a public interface eventually.
+%
 % \begin{function}{\@@_update_structure_from_material:nn}
 %   \begin{syntax}
 %     \cs{@@_update_structure_from_material:nn} \Arg{region} \Arg{material with marks}
diff --git a/required/tools/multicol.dtx b/required/tools/multicol.dtx
index ca350b493..23d5f0e05 100644
--- a/required/tools/multicol.dtx
+++ b/required/tools/multicol.dtx
@@ -3731,7 +3731,7 @@
 % \end{multicols}
 %
 %
-% \begin{multicols*}{2}[\section{Further extensions}]
+% \section{Further extensions}
 %
 % This section does contain code for extensions added to this package
 % over time. Not all of them may be active, some might sit dormant and
@@ -4307,6 +4307,8 @@
 %  \end{macro}
 %
 %
+%
+%
 % \subsection{Using the new mark mechanism}
 %
 % \subsubsection{Helpers}
@@ -4460,8 +4462,8 @@
 %    We are only interested in the top, first, and last marks of each
 %    class regardless in which column they appeared, so we can copy
 %    all column boxes together and process them in one go. The result
-%    is returned in \cs{l_@@_first_marks_tl} and
-%    \cs{l_@@_last_marks_tl} in form of \cs{mark_insert:nn} statements
+%    is returned in \cs{\detokenize{l_@@_first_marks_tl}} and
+%    \cs{\detokenize{l_@@_last_marks_tl}} in form of \cs{\detokenize{mark_insert:nn}} statements
 %    so we can later execute such token lists directly (and if there
 %    were no marks they will be empty).
 %    \begin{macrocode}
@@ -4598,8 +4600,6 @@
 %
 %
 %
-% \end{multicols*}
-%
 % \Finale
 %
 \endinput