[latex3-commits] [git/LaTeX3-latex3-latex2e] copyedits-chris: Edits for ltcmd.dtx (92974948)

[Chris Rowley]

Repository : https://github.com/latex3/latex2e
On branch  : copyedits-chris
Link       : https://github.com/latex3/latex2e/commit/929749485aeed7870b6a561399c84c14d801bf60

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

commit 929749485aeed7870b6a561399c84c14d801bf60
Author: Chris Rowley <car222222 at users.noreply.github.com>
Date:   Wed Sep 8 11:57:02 2021 +0700

    Edits for ltcmd.dtx


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

929749485aeed7870b6a561399c84c14d801bf60
 base/ltcmd.dtx | 49 +++++++++++++++++++++++++------------------------
 1 file changed, 25 insertions(+), 24 deletions(-)

diff --git a/base/ltcmd.dtx b/base/ltcmd.dtx
index c8449fab..1c18c14e 100644
--- a/base/ltcmd.dtx
+++ b/base/ltcmd.dtx
@@ -1507,9 +1507,9 @@
 %
 % \begin{macro}{\@@_add_type_E:w}
 %   The \texttt{E}-type argument needs a special handling of default
-%   values.  It also needs, since each embellishment is a separate
-%   argument, to replicate the argument processors to each embellishment
-%   argument so the number of arguments and processors remains in sync.
+%   values.  Since each embellishment is a separate argument, it
+%   also needs to replicate the argument processors for each embellishment
+%   argument so that the numbers of arguments and processors remain in sync.
 % \changes{v1.0g}{2021/08/07}
 %         {Replicate argument processors for all embellishments (gh/639)}
 %    \begin{macrocode}
@@ -1554,7 +1554,7 @@
 %   \cs{l_@@_process_one_tl}, add copies of the processor as necessary,
 %   and then return the removed brace.  The function below does just
 %   that:  it defines \cs{l_@@_process_one_tl} starting with a |}|$_2$
-%   and ending with a |{|$_11$, so that it adds as many processors as
+%   and ending with a |{|$_1$, so that it adds as many processors as
 %   needed when |x|-expanded.
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_replicate_processor:nn #1 #2
@@ -1942,13 +1942,13 @@
 %    \end{macrocode}
 %
 % \changes{v1.0h}{2021/08/30}{Added support for \cs{NewCommandCopy}}
-% Since the 2020-10-01 \LaTeXe{} release, support for copying and
-% showing the definition of robust commands is available, but the
-% specifics of each command is implemented separately.  Here we'll add
+% Since the 2020-10-01 \LaTeXe{} release, support for copying, and
+% showing the definition of, robust commands has been available, but the
+% specifics of each command are implemented separately.  Here we'll add
 % support for copying and showing \pkg{ltcmd} definitions.
 %
 % To fully support copying, we need two commands:  a conditional to test
-% if a command is in fact a \pkg{ltcmd} command, and another to
+% if a command is in fact a \pkg{ltcmd} command, and another command to
 % actually copy the command.  The conditional is defined later as
 % \cs{__kernel_cmd_if_xparse:NTF}, so now to the copying:
 %
@@ -2049,13 +2049,13 @@
 %   \cs{\meta{cmd}\textvisiblespace} for grabbing delimited arguments,
 %   and possibly another auxiliary
 %   \cs{\meta{cmd}\textvisiblespace\textvisiblespace}, if the command
-%   has both long and short arguments.  Then, its signature has also
-%   several specific bits that are unique to that command, contrary to
-%   non-expandable commands which use a common set of parsing functions.
+%   has both long and short arguments.  Then, its signature also has
+%   several specific bits that are unique to that command; this is in contrast to
+%   non-expandable commands, which use a common set of parsing functions.
 %
-%   We'll start by copying the basics, then call
+%   We start by copying the basics, then call
 %   \cs{@@_copy_expandable_signature:NnNNNNnnn} to parse the signature
-%   of the command and make the modified copy in a temporary token list,
+%   of the command and build up the modified copy in a temporary token list,
 %   then we call \cs{@@_copy_expandable:NnNNNNnnn} that will copy the
 %   top-level definition of the command, with the proper internal
 %   renames.
@@ -2099,7 +2099,7 @@
 %   follows this macro depends on the \meta{type}.  We'll start a loop
 %   through the signature, and at each argument grabber, we'll step the
 %   argument count, and look for the \meta{type} with
-%   \cs{@@_copy_parse_grabber:w} so we know which
+%   \cs{@@_copy_parse_grabber:w} so that we know which
 %   \cs{@@_copy_grabber_\meta{type}:w} to call next.
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_copy_expandable_signature:NnNNNNnnn
@@ -2162,7 +2162,7 @@
   { \@@_copy_grabber_D:w {#1} {#2} {#3} {#4} { } }
 %    \end{macrocode}
 %
-%   |R|, as far as copying is concerned, is identical to |D|:
+%   As far as copying is concerned, |R| is identical to |D|:
 %    \begin{macrocode}
 \cs_new_eq:NN \@@_copy_grabber_R:w \@@_copy_grabber_D:w
 \cs_new_eq:NN \@@_copy_grabber_R_alt:w \@@_copy_grabber_D_alt:w
@@ -2345,8 +2345,8 @@
   { \@@_show_command_aux:nNNn { expandable~document~command } #8 #5 {#2} }
 %    \end{macrocode}
 %
-%   Now just print everything in the wanted format.  The auxiliary
-%   \cs{@@_split_signature:n} stores a ready-to-print token list into
+%   Now just print everything in the required format.  The auxiliary
+%   \cs{@@_split_signature:n} stores a ready-to-print token list in
 %   \cs{l_@@_tmpa_tl}, so we ust use that here:
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_show_command_aux:nNNn #1 #2 #3 #4
@@ -2424,7 +2424,8 @@
 %
 % \begin{macro}{\@@_split_signature_loop:Nw}
 %   This is the main chunk of the loop:  it starts an item with
-%   \cs{@@_split_start_item:} (adds indentation and whatnot to
+%   \cs{@@_split_start_item:} 
+%   (this adds indentation and the argument number to
 %   \cs{l_@@_tmpb_tl}), then checks if a special token list
 %   \cs[no-index]{c_@@_show_type_\meta{type}_tl} exists.  If it doesn't,
 %   the current argument is a ``simple'' type which needs no extra
@@ -2460,7 +2461,7 @@
 %     \c_@@_show_type_>_tl,
 %   }
 %   The token lists \cs[no-index]{c_@@_show_type_\meta{type}_tl} exist
-%   for nontrivial (for printing) \meta{types} which requires special
+%   for nontrivial (for printing) \meta{types} that require special
 %   parsing (like delimiters or optional arguments).  Values from~0 to~7
 %   are assigned to each type:
 %   \begin{enumerate}
@@ -2488,14 +2489,14 @@
 %     \@@_show_e:Nw,\@@_show_E:Nw,
 %     \@@_show_prefix:Nw,\@@_show_processor:Nw,
 %   }
-%   Now, based on each type we know how to act.  In mosty cases it is
-%   just a matter of feeding the grabbed arguments and resuming the
+%   Now, based on each type we know how to act.  In most cases it is
+%   just a matter of feeding in the grabbed arguments and resuming the
 %   loop.  The embellishments require a bit more attention:  the
 %   |e|-type loops through the list of embellishments and adds each to
-%   the token list as separate arguments.  The |E|-type does more or
+%   the token list as a separate argument.  The |E|-type does more or
 %   less the same, but uses \cs{@@_tl_mapthread_function:nnN} to map
 %   over two lists simultaneously, adding each token and default to the
-%   token list to print.
+%   token list for printing.
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_show_delim:Nw #1 #2
   { \@@_split_end_item:n { #1 #2 } \@@_split_signature_loop:Nw }
@@ -2549,7 +2550,7 @@
 %   And now the auxiliaries that store the strings to be printed.
 %   \cs{@@_split_start_item:} starts an item from scratch,
 %   \cs{@@_split_add_item:n} adds tokens to an item without adding a
-%   newline, and \cs{@@_split_add_item:n} adds tokens, terminates the
+%   newline, and \cs{@@_split_end_item:n} adds tokens, terminates the
 %   item with a newline, and steps the argument count.
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_split_start_item: