[latex3-commits] [latex3/latex2e] ltmarks-multicol: a few more docu corrections (1dff28719)

[github at latex-project.org]

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

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

commit 1dff28719e0e67c0f13ff738e75649e2c8deda9a
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Mon Nov 18 14:19:21 2024 +0100

    a few more docu corrections


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

1dff28719e0e67c0f13ff738e75649e2c8deda9a
 base/ltmarks.dtx | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/base/ltmarks.dtx b/base/ltmarks.dtx
index 537b8e56b..1e1c5c7fb 100644
--- a/base/ltmarks.dtx
+++ b/base/ltmarks.dtx
@@ -702,10 +702,10 @@
 %
 % \section{Public interfaces for packages such as \pkg{multicol}}
 %
-% The function in this section are public so that packages can make
-% use of them. However, this has to happen with great care, e.g.,
+% The functions in this section are public so that packages can make
+% use of them. However, this must be done with great care, e.g.,
 % \cs{mark_update_structure_from_material:nn} updates the global mark
-% structure and can therefore be used only in in places where such an
+% structure and can therefore be used only in places where such an
 % update is meaningful, e.g., in special output routines. Elsewhere, a
 % change to the mark structure would break the whole mechanism and
 % querying the marks would return incorrect data.
@@ -768,8 +768,8 @@
 %   \end{syntax}
 %   Helper function that sets all mark values in the \meta{region} to
 %   empty. This is currently used for \texttt{column} when a multicol
-%   environment starts because it wouldn't make sense if the top mark
-%   in the first column would return the last mark from a previous
+%   environment starts; this is because it wouldn't make sense if the top mark
+%   in the first column returned the last mark from a previous
 %   multicol (which may have been much earlier, with intermediate
 %   material).
 % \end{function}
@@ -947,7 +947,7 @@
   \@@_init_region:nn {last-column}{#1}
 %    \end{macrocode}
 %    To support multiple columns produced by the \pkg{multicol}
-%    package, we preallocate twenty alias regions (since this is the number of columns what
+%    package, we preallocate twenty alias regions (since this is the number of columns that
 %    \pkg{multicol} supports as a maximum). They are filled by copying
 %    the current \texttt{column} into the appropriate \texttt{mcol-...}.  
 %    \begin{macrocode}
@@ -1549,7 +1549,7 @@
 %
 %  \begin{macro}{\mark_clear_structure:n}
 %    This function sets the structure of one region back to an initial
-%   state, i.e., all classes return an empty value if queried.
+%   state, so that all classes return an empty value if queried.
 % \changes{v1.1a}{2024/11/09}{}
 %    \begin{macrocode}
 \cs_new_protected:Npn \mark_clear_structure:n #1 {
@@ -1931,7 +1931,7 @@
    \@@_region_status:nnn  {#2}{ column~ (first) }   { first-column }
    \@@_region_status:nnn  {#2}{ column~ (last)~ }   { last-column }
 %    \end{macrocode}
-%    then finish  by displaying a subset of the \texttt{mcol-...} regions: none (\texttt{0})
+%    Then finish  by displaying a subset of the \texttt{mcol-...} regions: none (\texttt{0})
 %    in the standard \LaTeX{} output routine and \cs{col at number}
 %    within a \env{multicols} environment.
 %    \begin{macrocode}
@@ -1946,8 +1946,8 @@
 %
 %  \begin{macro}{\@@_region_status:nnn}
 %    
-%    Display, top, first, and last mark of a region unless none of
-%    them exist. Or all of them are empty.
+%    Display the top, first, and last mark of a region unless none of
+%    them exist or all of them are empty.
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_region_status:nnn #1#2#3 {
   \group_begin: