[latex3-commits] [git/LaTeX3-latex3-latex2e] master: small updates to documentation (7ad8f4f)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : master
Link       : https://github.com/latex3/latex2e/commit/7ad8f4fa763e565328421ce07b9977cc891f8917

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

commit 7ad8f4fa763e565328421ce07b9977cc891f8917
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Sun Dec 2 11:54:24 2018 +0100

    small updates to documentation


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

7ad8f4fa763e565328421ce07b9977cc891f8917
 doc/ltnews29.tex |   34 +++++++++++++++++++---------------
 1 file changed, 19 insertions(+), 15 deletions(-)

diff --git a/doc/ltnews29.tex b/doc/ltnews29.tex
index 3ede7a0..e9febb2 100644
--- a/doc/ltnews29.tex
+++ b/doc/ltnews29.tex
@@ -87,7 +87,7 @@ bug or problem.
 
 Initial experience with this system is good, with people who report
 problems following the guidelines and including helpful working
-example to show the problem---thanks for doing this.
+examples to show the problem---thanks for doing this.
 
 The detailed requirements and the workflow for reporting a bug in the
 core \LaTeX{} software is documented at
@@ -280,12 +280,12 @@ line, sticking out like the proverbial sore thumb, as exhibited in the
 question on StackExchange that triggered the correction.
 
 \LaTeX{} now takes care that there will be no protrusion happening on
-such lines, even if is generally enabled for the whole document.
+such lines, even if it is generally enabled for the whole document.
 %
 \sxissue{https://tex.stackexchange.com/q/172785}
 
 
-%%  LR-mode   OR   L-R mode   OR   ?? 
+
 \subsection{Start L-R mode for \cs{thinspace} and friends}
 
 In \LaTeX{}, commands that are intended only for paragraph (L-R) mode
@@ -366,30 +366,34 @@ explicitly reinserting that penalty if necessary.
 %
 \githubissue{53}
 
-\subsection{Extension to \cs{docolaction}}
+\subsection{Extension to \cs{docolaction} in \pkg{multicol}}
 
 The \cs{docolaction} command can be used used to carry out actions
-depending on the column you are currently in, i.e., the first, andy
-middle one (if more than two) or the last. However, if the action
-generates text then there is the question which point to use to
-determine the current column, before or after that generated
-text. This is now resolved as follows: if you use \cs{docolaction*}
-the test comes first and then the action is executed.  But if you use
-the command without the star then all material it generates will be
-before the test point to determine the current column.
+depending on the column you are currently in, i.e., first, any inner
+one (if more than two) or last. However, if the action generates text
+then there is the question: is this text part of the current column or
+the one after?  That is, do we test on the next run before that text
+or after it to determine in which column we are?
+
+This is now resolved as follows: if you use \cs{docolaction*} any
+generated text by the chosen action is considered to be after the test
+point.  But if you use the command without the star then all material
+it generates will be placed before the test point to determine the
+current column, i.e., the text will become part of the current column
+and may affect the test result on the next run.
 
 
 
 \subsection{Prevent color leak in \pkg{array}}
 
 In some cases the color used inside a \env{tabular} cell could ``leak
-out'' into the surrounding text.
+out'' into the surrounding text. This has been corrected.
 %
 \githubissue{72}
 
 \subsection{Support fragile commands in \texttt{array} or \texttt{tabular} column templates}
 
-The preamble specifiers \texttt{p}, \texttt{m} and \texttt{b} receives
+The preamble specifiers \texttt{p}, \texttt{m} and \texttt{b} each receives
 a user supplied argument: the width of the paragraph column. Normally
 that is something harmless, like a length or a simple length
 expression. But in more complicated settings involving the \pkg{calc}
@@ -436,7 +440,7 @@ These are:
     User’s Guide for the \pkg{amsmath}~\cite{amsldoc}.
 \end{itemize}
 They can be found on the website documentation page~\cite{site-doc}.
-You will now also find there a compiled version of the full \LaTeXe{}
+You will now also find there a typeset version of the full \LaTeXe{}
 source code (with index etc.\@) and a number of other goodies.