[latex3-commits] [git/LaTeX3-latex3-latex3] xparse: In xparse, add reference to environ package and clarify nesting [ci skip] (9e8e3bc)

[Bruno Le Floch]

Repository : https://github.com/latex3/latex3
On branch  : xparse
Link       : https://github.com/latex3/latex3/commit/9e8e3bc5b70732b9208ccfeb95362df01fb43aaa

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

commit 9e8e3bc5b70732b9208ccfeb95362df01fb43aaa
Author: Bruno Le Floch <bruno at le-floch.fr>
Date:   Wed Feb 27 00:51:53 2019 +0100

    In xparse, add reference to environ package and clarify nesting [ci skip]


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

9e8e3bc5b70732b9208ccfeb95362df01fb43aaa
 l3packages/xparse/xparse.dtx |   13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/l3packages/xparse/xparse.dtx b/l3packages/xparse/xparse.dtx
index f308584..9add449 100644
--- a/l3packages/xparse/xparse.dtx
+++ b/l3packages/xparse/xparse.dtx
@@ -398,7 +398,13 @@
 % useful to have the body as a standard argument.
 %
 % This is achieved in \pkg{xparse} by ending the argument specification
-% with \texttt{b}\marg{code}.  For instance
+% with \texttt{b}\marg{code}. The approach taken in \pkg{xparse} is
+% different from the earlier packages \pkg{environ} or \pkg{newenviron}:
+% the body of the environment is provided to the code part as a usual
+% argument |#1|, |#2| etc.\@, rather than stored in a macro such as
+% \cs[no-index]{BODY}.
+%
+% For instance
 % \begin{verbatim}
 %   \NewDocumentEnvironment { twice }
 %     { O{\ttfamily} +b{} }
@@ -429,6 +435,11 @@
 % \meta{start code}.  Nevertheless this (empty) \meta{end code} must be
 % provided.
 %
+% Environments that use this feature can be nested.
+%
+% Users should note that this feature is somewhat experimental. Feedback
+% is therefore very welcome on the \texttt{LaTeX-L} mailing list.
+%
 % \subsection{Backwards Compatibility}
 % \label{sec:backwards}
 %