[latex3-commits] [git/LaTeX3-latex3-latex2e] develop, ltpara: small docu fixes [ci skip] (05d90cde)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branches: develop,ltpara
Link       : https://github.com/latex3/latex2e/commit/05d90cded9b8c90547d13726057f1ac4f7d0fff9

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

commit 05d90cded9b8c90547d13726057f1ac4f7d0fff9
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Thu Feb 18 22:46:45 2021 +0100

    small docu fixes [ci skip]


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

05d90cded9b8c90547d13726057f1ac4f7d0fff9
 base/doc/ltnews33.tex |  2 +-
 base/ltpara.dtx       | 13 +++++++++++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/base/doc/ltnews33.tex b/base/doc/ltnews33.tex
index 0170652c..c890392d 100644
--- a/base/doc/ltnews33.tex
+++ b/base/doc/ltnews33.tex
@@ -118,7 +118,7 @@ Largely triggered by the need for better control of paragraph text
 processing, in particular when producing tagged PDF output (see
 \cite{33:blueprint}), we have extended the paragraph processing of
 \LaTeX{} so that the kernel gains control both at the start and the
-end of each paragraph. This is is done in a manner that is (or should
+end of each paragraph. This is done in a manner that is (or should
 be) transparent to packages and user documents.
 
 Beside the internal control points for exclusive use of the \LaTeX{}
diff --git a/base/ltpara.dtx b/base/ltpara.dtx
index 0f7d1d2a..1a3df95a 100644
--- a/base/ltpara.dtx
+++ b/base/ltpara.dtx
@@ -430,6 +430,12 @@
 %    The \pkg{expl3} name for the functionality is \cs{para_end:}.
 % \end{function}
 %
+% \begin{quote}
+%    \textbf{Note:} \em The next two commands are still under
+%    discussion and may slightly change their semantics (as described
+%    in the document) and/or their names between now and the 2021
+%    Spring release!
+% \end{quote}
 %
 % \begin{function}{\SuppressIndentationBox,\para_suppress_indentation:}
 %    Inside the \hook{para/begin} hook one can use this command to
@@ -539,8 +545,9 @@
 %    We also typeset again a tiny red number with that value, this
 %    time sticking out to the right.\footnote{Note that this can alter
 %    the document pagination, because a paragraph ending in a display
-%    (e.g., an equation) will get an extra line---then our tiny number
-%    has an effect after all!}
+%    (e.g., an equation) will get an extra line---in that case our tiny number
+%    has an effect even though it doesn't take up any space, because
+%    it paragraph is no longer empty and thus isn't dropped!}
 %    We also decrement the level counter since our level has finished.
 %\begin{verbatim}
 %    \rlap{\color{red}\tiny\ \paracntvalue}%
@@ -563,6 +570,8 @@
 %    \AddToHookNext{para/end}{\color{black}}%
 %  }
 %\end{verbatim}
+%    As a result the first paragraph of each \env{itemize} will appear
+%    in blue.
 %
 %
 % \StopEventually{\setlength\IndexMin{200pt}  \PrintIndex  }