[latex3-commits] [latex3/latex2e] develop: Apply suggestions from code review (3f54ac39)

[github at latex-project.org]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/3f54ac39307d7b8182f022a7ba2584a3e715ea1f

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

commit 3f54ac39307d7b8182f022a7ba2584a3e715ea1f
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Wed Oct 25 19:55:09 2023 +0200

    Apply suggestions from code review
    
    Co-authored-by: Yukai Chou <muzimuzhi at gmail.com>


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

3f54ac39307d7b8182f022a7ba2584a3e715ea1f
 base/doc/ltnews38.tex | 37 +++++++++++++++++++------------------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/base/doc/ltnews38.tex b/base/doc/ltnews38.tex
index 94e99b4b..01f5a901 100644
--- a/base/doc/ltnews38.tex
+++ b/base/doc/ltnews38.tex
@@ -194,15 +194,15 @@ Having all issues and discussions related to the project in a single
 place instead of being spread across multiple repositories such as
 \texttt{latex2e}, \texttt{latex3}, \texttt{tagpdf}, \texttt{hyperref},
 \texttt{pdfresources}, etc., help people to find information easily
-and report any issue related to the project without needing to knowing in which
+and report any issue related to the project without needing to know in which
 code repository the problematic code resides.
 
 You find this repository at
 \url{https://github.com/latex3/tagging-project} and the mentioned
-discussion on tabular syntax at
+discussion on \texttt{tabular} syntax at
 \url{https://github.com/latex3/tagging-project/discussions/1}.
 
-Your feedback is importand and reporting what doesn't yet work is
+Your feedback is important and reporting what doesn't yet work is
 beneficial to all users, so we hope to see you there and thank you for
 any contribution, whether it is an issue or a post on a discussion
 thread.
@@ -234,11 +234,11 @@ or not at all, but it can not have code from other packages added at
 the same point interfering with the algorithm.
 
 For these use cases we now introduce the concept of sockets and plugs.
-A socket is is a place in the code into which one can put a plug (a
+A socket is a place in the code into which one can put a plug (a
 chunk of code with a name) after which the socket is in use and to put
 a different plug in, the former one has to be taken out
 first.\footnote{Think of electric outlets and plugging something into
-them} A socket may or may not have inputs that can then be used by
+them.} A socket may or may not have inputs that can then be used by
 the plugs.
 %
 While this is technically not much different to putting a command in
@@ -249,13 +249,13 @@ supports tracing, etc.
 You declare a new socket and possibly some plugs for it with
 \begin{flushleft}
   \cs{NewSocket}\Arg{socket name}\Arg{\# of inputs} \\
-  \cs{NewSocketPug}\Arg{socket name}\Arg{plug name}\Arg{code}
+  \cs{NewSocketPlug}\Arg{socket name}\Arg{plug name}\Arg{code}
 \end{flushleft}
 For example, after the declaration \verb=\NewSocket{foo}{0}= you can
 immediately use this socket in your code with \verb=\UseSocket{foo}=.
 The \cs{NewSocket} declaration automatically defines a simple plug
-with the name \texttt{noop} for the socket and assigns it to it (plugs
-it in), thus your \cs{UseSocket} sits idle doing
+with the name \texttt{noop} for the socket and assigns it to the socket
+(plugs it in), thus your \cs{UseSocket} sits idle doing
 nothing\footnote{Sockets with one input also define an
 \texttt{identity} plug and initially assign that to the socket\Dash
 this means that their input is simply returned without processing.}
@@ -263,7 +263,7 @@ until you assign it a different plug which is done with
 \cs{AssignSocketPlug}. This takes the current plug out and puts the
 new one in.
 %
-All the declarations and commands are also available in the \LaTeX{}
+All the declarations and commands are also available in the \LaTeX3
 programming layer as \cs{socket\_new:nn}, \cs{socket\_new\_plug:nnn},
 etc.
 
@@ -330,26 +330,27 @@ The new module predeclares a set of generally useful properties:
 e.g., by \pkg{hyperref}), \texttt{pagetarget} (the name of target
 added each page by \pkg{hyperref}), \texttt{pagenum} (the page as an
 arabic number), \texttt{abspage} (the absolute page number),
-\texttt{counter} (the name of the current counter), \texttt{xpos} and
-\texttt{ypos} the position on the page as set by a previous
-\cs{pdfsavepos}.
+\texttt{counter} (the name of the current counter), and \texttt{xpos}
+and \texttt{ypos} (the position on the page as set by a previous
+\cs{pdfsavepos}).
   
-The module provides both \LaTeXe{} camel case commands and \LaTeX{} programming layer commands.    
+The module provides both \LaTeXe{} camel case commands and
+\LaTeX3 programming layer commands.    
 
 For documentation see \texttt{texdoc ltproperties-doc}. 
 
 \section{New or improved commands}
 
-\subsection{Testing for the \LaTeX{} programming layer version: \cs{IfExplAtLeastTF}}
+\subsection{Testing for the \LaTeX3 programming layer version: \cs{IfExplAtLeastTF}}
 
-The integration of \pkg{expl3} into the kernel (the \LaTeX{}
-programming layer) means that programmers can use all of the features
-available without needing to load explicitly. However, as \pkg{expl3}
+The integration of \pkg{expl3} (the \LaTeX3 programming layer)
+into the kernel means that programmers can use all of the features
+available without needing to load it explicitly. However, as \pkg{expl3}
 is not a separate package, the version can't be tested using
 \cs{IfPackageAtLeastTF}. To date, low-level methods have therefore
 been needed to check for the availability of features in
 \pkg{expl3}. We have now added \cs{IfExplAtLeastTF} as a test working
-in the same way as \cs{IfPackageAtLeastTF} but focussed on the
+in the same way as \cs{IfPackageAtLeastTF} but focused on the
 pre-loaded programming layer.  Programmers can check the date of
 \pkg{expl3} they are using in the \texttt{.log}, as it appears both at
 the start and end in the format