[latex3-commits] [git/LaTeX3-latex3-latex3] xparse: Reorder xparse sections a bit [ci skip] (8ef0d54)

[Bruno Le Floch]

Repository : https://github.com/latex3/latex3
On branch  : xparse
Link       : https://github.com/latex3/latex3/commit/8ef0d5458bc5b04032f17aea9fd6055aab8e68d4

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

commit 8ef0d5458bc5b04032f17aea9fd6055aab8e68d4
Author: Bruno Le Floch <bruno at le-floch.fr>
Date:   Tue Feb 26 20:36:26 2019 +0100

    Reorder xparse sections a bit [ci skip]


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

8ef0d5458bc5b04032f17aea9fd6055aab8e68d4
 l3packages/xparse/xparse.dtx |   84 +++++++++++++++++++++---------------------
 1 file changed, 43 insertions(+), 41 deletions(-)

diff --git a/l3packages/xparse/xparse.dtx b/l3packages/xparse/xparse.dtx
index b74aa8c..9502dba 100644
--- a/l3packages/xparse/xparse.dtx
+++ b/l3packages/xparse/xparse.dtx
@@ -85,18 +85,18 @@
 % At present, the functions in \pkg{xparse} which are regarded as
 % \enquote{stable} are:
 % \begin{itemize}
-%   \item \cs{NewDocumentCommand}
-%   \item \cs{RenewDocumentCommand}
-%   \item \cs{ProvideDocumentCommand}
-%   \item \cs{DeclareDocumentCommand}
-%   \item \cs{NewDocumentEnvironment}
-%   \item \cs{RenewDocumentEnvironment}
-%   \item \cs{ProvideDocumentEnvironment}
-%   \item \cs{DeclareDocumentEnvironment}
-%   \item \cs{NewExpandableDocumentCommand}
-%   \item \cs{RenewExpandableDocumentCommand}
-%   \item \cs{ProvideExpandableDocumentCommand}
-%   \item \cs{DeclareExpandableDocumentCommand}
+%   \item \cs{NewDocumentCommand}\\
+%     \cs{RenewDocumentCommand}\\
+%     \cs{ProvideDocumentCommand}\\
+%     \cs{DeclareDocumentCommand}
+%   \item \cs{NewDocumentEnvironment}\\
+%     \cs{RenewDocumentEnvironment}\\
+%     \cs{ProvideDocumentEnvironment}\\
+%     \cs{DeclareDocumentEnvironment}
+%   \item \cs{NewExpandableDocumentCommand}\\
+%     \cs{RenewExpandableDocumentCommand}\\
+%     \cs{ProvideExpandableDocumentCommand}\\
+%     \cs{DeclareExpandableDocumentCommand}
 %   \item \cs{IfNoValue(TF)}
 %   \item \cs{IfValue(TF)}
 %   \item \cs{IfBoolean(TF)}
@@ -105,7 +105,7 @@
 % try all of the commands provided here, but be aware that the
 % experimental ones may change or disappear.
 %
-% \subsection{Specifying arguments}
+% \section{Specifying arguments}
 %
 % Before introducing the functions used to create document commands,
 % the method for specifying arguments with \pkg{xparse} will be
@@ -382,7 +382,34 @@
 % |-NoValue-| marker as a default for |_|. This allows mixing of explicit
 % defaults with testing for missing values.
 %
-% \subsection{Declaring commands and environments}
+% \subsection{Backwards Compatibility}
+% \label{sec:backwards}
+%
+% One role of \pkg{xparse} is to describe existing \LaTeX{} interfaces,
+% including some that are rather unusual in \LaTeX{} (as opposed to
+% formats such as plain \TeX{}) such as delimited arguments.  As such,
+% the package defines some argument specifiers that should largely be
+% avoided nowadays as using them in packages leads to inconsistent user
+% interfaces.  The simplest syntax is often best, with argument
+% specifications such as |mmmm| or |ommmm|, namely an optional argument
+% followed by some standard mandatory ones.  The optional argument can
+% be made to support key--value syntax using tools from \pkg{l3keys}.
+%
+% The argument types that are not recommended any longer are:
+% \begin{itemize}[font=\ttfamily]
+%   \item[l] A mandatory argument which reads everything up to the first
+%     begin-group token: in standard \LaTeX{} this is a left brace.
+%   \item[u] Reads a mandatory argument \enquote{until} \meta{tokens} are encountered,
+%     where the desired \meta{tokens} are given as an argument to the
+%     specifier: \texttt{u}\marg{tokens}.
+%   \item[g] An optional argument given inside a pair of \TeX{} group
+%     tokens (in standard \LaTeX{}, |{| \ldots |}|), which returns
+%     |-NoValue-| if not present.
+%   \item[G] As for \texttt{g} but returns \meta{default} if no value
+%     is given: \texttt{G}\marg{default}.
+% \end{itemize}
+%
+% \section{Declaring commands and environments}
 %
 % With the concept of an argument specifier defined, it is now
 % possible to describe the methods available for creating both
@@ -465,6 +492,8 @@
 %   The arguments will be given following \cs{begin}\Arg{environment}.
 % \end{function}
 %
+% \section{Other \pkg{xparse} commands}
+%
 % \subsection{Testing special values}
 %
 % Optional arguments created using \pkg{xparse} make use of dedicated
@@ -777,33 +806,6 @@
 % \end{verbatim}
 % each new, declared or renewed command or environment is logged.
 %
-% \section{Backwards Compatibility}
-% \label{sec:backwards}
-%
-% One role of \pkg{xparse} is to describe existing \LaTeX{} interfaces,
-% including some that are rather unusual in \LaTeX{} (as opposed to
-% formats such as plain \TeX{}) such as delimited arguments.  As such,
-% the package defines some argument specifiers that should largely be
-% avoided nowadays as using them in packages leads to inconsistent user
-% interfaces.  The simplest syntax is often best, with argument
-% specifications such as |mmmm| or |ommmm|, namely an optional argument
-% followed by some standard mandatory ones.  The optional argument can
-% be made to support key--value syntax using tools from \pkg{l3keys}.
-%
-% The argument types that are not recommended any longer are:
-% \begin{itemize}[font=\ttfamily]
-%   \item[l] A mandatory argument which reads everything up to the first
-%     begin-group token: in standard \LaTeX{} this is a left brace.
-%   \item[u] Reads a mandatory argument \enquote{until} \meta{tokens} are encountered,
-%     where the desired \meta{tokens} are given as an argument to the
-%     specifier: \texttt{u}\marg{tokens}.
-%   \item[g] An optional argument given inside a pair of \TeX{} group
-%     tokens (in standard \LaTeX{}, |{| \ldots |}|), which returns
-%     |-NoValue-| if not present.
-%   \item[G] As for \texttt{g} but returns \meta{default} if no value
-%     is given: \texttt{G}\marg{default}.
-% \end{itemize}
-%
 % \end{documentation}
 %
 % \begin{implementation}