[latex3-commits] [git/LaTeX3-latex3-latex2e] ltpara: updated docu on \RawIndent, etc (dea012d5)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : ltpara
Link       : https://github.com/latex3/latex2e/commit/dea012d562ca075dc15e649364553ceda378174f

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

commit dea012d562ca075dc15e649364553ceda378174f
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Wed Apr 14 12:02:10 2021 +0200

    updated docu on \RawIndent, etc


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

dea012d562ca075dc15e649364553ceda378174f
 base/ltpara.dtx | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/base/ltpara.dtx b/base/ltpara.dtx
index d9c35d64..cc7b87b1 100644
--- a/base/ltpara.dtx
+++ b/base/ltpara.dtx
@@ -15,7 +15,7 @@
 %
 %    \begin{macrocode}
 \def\ltparaversion{v1.0e}
-\def\ltparadate{2021/04/13}
+\def\ltparadate{2021/04/14}
 %    \end{macrocode}
 %<*driver>
 \documentclass{l3doc}
@@ -466,11 +466,19 @@
 %   \cs{RawNoindent} \textit{hmode material} \cs{RawParEnd}
 % \end{syntax}
 %
-%    The commands \cs{RawIndent} and \cs{RawNoindent}
-%    are like the primitives \cs{indent} and \cs{noindent} (that is
-%    they execute no hooks other than \cs{everypar}) except that
-%    they can only be used in vertical mode and generate an error if
-%    found elsewhere.
+%    The commands \cs{RawIndent} and \cs{RawNoindent} are not meant
+%    for normal paragraph building (where the result is a textual
+%    paragraph in the the traditional meaning of the word), but for
+%    special cases where \TeX{}'s low-level algorithm is used to
+%    achieve special effects, but where the result is not a
+%    \enquote{paragraph}.
+%
+%    They are called \enquote{raw}, because they bypass \LaTeX{}'s
+%    hook mechanism for paragraphs and simply invoke the low-level
+%    \TeX{} algorithm.  I.e., they are like the original \TeX{}
+%    primitives \cs{indent} and \cs{noindent} (that is they execute no
+%    hooks other than \cs{everypar}) except that they can only be used
+%    in vertical mode and generate an error if found elsewhere.
 %
 %    To avoid issues a paragraph started by them should always be
 %    ended by \cs{RawParEnd} and not by