[latex3-commits] [git/LaTeX3-latex3-latex3] master: Revert "s/LaTeX3/expl3/" (772697358)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : master
Link       : https://github.com/latex3/latex3/commit/77269735826f6ba0dc5ecab9ebfeb2f9f81fe754

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

commit 77269735826f6ba0dc5ecab9ebfeb2f9f81fe754
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Mon Feb 8 10:31:53 2021 +0000

    Revert "s/LaTeX3/expl3/"


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

77269735826f6ba0dc5ecab9ebfeb2f9f81fe754
 l3kernel/doc/interface3.tex  |  4 ++--
 l3kernel/doc/source3.tex     |  4 ++--
 l3kernel/doc/source3body.tex | 33 +++++++++++++++++++++++++--------
 3 files changed, 29 insertions(+), 12 deletions(-)

diff --git a/l3kernel/doc/interface3.tex b/l3kernel/doc/interface3.tex
index 01f9b3d7e..3243a6e00 100644
--- a/l3kernel/doc/interface3.tex
+++ b/l3kernel/doc/interface3.tex
@@ -28,7 +28,7 @@ for those people who are interested.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
-% This document typesets the expl3 interface descriptions a single document.
+% This document typesets the LaTeX3 interface descriptions a single document.
 % This produces quite a large file (more than 170 pages currently).
 %
 % There is also a full version of the sources (source3.tex) which additionally
@@ -45,7 +45,7 @@ for those people who are interested.
 
 \begin{document}
 
-\title{The \pkg{expl3} Interfaces}
+\title{The \LaTeX3 Interfaces}
 \author{%
  The \LaTeX{} Project\thanks
    {%
diff --git a/l3kernel/doc/source3.tex b/l3kernel/doc/source3.tex
index 43187b006..60ca61662 100644
--- a/l3kernel/doc/source3.tex
+++ b/l3kernel/doc/source3.tex
@@ -28,7 +28,7 @@ for those people who are interested.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
-% This document typesets the expl3 sources as a single document.
+% This document typesets the LaTeX3 sources as a single document.
 % This produces quite a large file (more than 780 pages).
 %
 % There is also a shorter version (interface3.tex) that only typesets the
@@ -44,7 +44,7 @@ for those people who are interested.
 
 \begin{document}
 
-\title{The \pkg{expl3} Sources}
+\title{The \LaTeX3 Sources}
 \author{%
  The \LaTeX{} Project\thanks
    {%
diff --git a/l3kernel/doc/source3body.tex b/l3kernel/doc/source3body.tex
index 219681347..2f36e993e 100644
--- a/l3kernel/doc/source3body.tex
+++ b/l3kernel/doc/source3body.tex
@@ -45,15 +45,30 @@ for those people who are interested.
 
 \noindent
 This is the reference documentation for the \pkg{expl3}
-programming environment. The \pkg{expl3} modules set up a
-naming scheme for coding, which allow the \LaTeX{} programmer
+programming environment. The \pkg{expl3} modules set up an experimental
+naming scheme for \LaTeX{} commands, which allow the \LaTeX{} programmer
 to systematically name functions and variables, and specify the argument
 types of functions.
 
 The \TeX{} and \eTeX{} primitives are all given a new name according to
 these conventions. However, in the main direct use of the primitives is
 not required or encouraged: the \pkg{expl3} modules define an
-independent programming language.
+independent low-level \LaTeX3 programming language.
+
+At present, the \pkg{expl3} modules are designed to be loaded on top of
+\LaTeXe{}. In time, a \LaTeX3 format will be produced based on this code.
+This allows the code to be used in \LaTeXe{} packages \emph{now} while a
+stand-alone \LaTeX3 is developed.
+
+\begin{bfseries}
+  While \pkg{expl3} is still experimental, the bundle is now regarded as
+  broadly stable. The syntax conventions and functions provided are now
+  ready for wider use. There may still be changes to some functions, but
+  these will be minor when compared to the scope of \pkg{expl3}.
+
+  New modules will be added to the distributed version of \pkg{expl3} as
+  they reach maturity.
+\end{bfseries}
 
 \end{abstract}
 
@@ -72,7 +87,9 @@ independent programming language.
 % Each of the following \DocInput lines includes a file with extension
 % .dtx. Each of these files may be typeset separately. For instance
 %   pdflatex l3box.dtx
-% will typeset the source of the LaTeX box commands.
+% will typeset the source of the LaTeX3 box commands. If you use the
+% Makefile, the index will be generated automatically; e.g.,
+%   make doc F=l3box
 %
 % If this file is processed, each of these separate dtx files will be
 % contained as a part of a single document.
@@ -91,7 +108,7 @@ independent programming language.
 \part{Introduction to \pkg{expl3} and this document}
 
 This document is intended to act as a comprehensive reference manual
-for the \pkg{expl3} language. A general guide to the \pkg{expl3}
+for the \pkg{expl3} language. A general guide to the \LaTeX3
 programming language is found in \href{expl3.pdf}{expl3.pdf}.
 
 \section{Naming functions and variables}
@@ -403,7 +420,7 @@ expected behaviour.
 
 \section{Formal language conventions which apply generally}
 
-As this is a formal reference guide for \pkg{expl3} programming, the descriptions
+As this is a formal reference guide for \LaTeX3 programming, the descriptions
 of functions are intended to be reasonably \enquote{complete}. However, there
 is also a need to avoid repetition. Formal ideas which apply to general
 classes of function are therefore summarised here.
@@ -416,10 +433,10 @@ and a predicate (|_p|) variant is available, the logical value determined by
 the test is left in the input stream: this will typically be part of a larger
 logical construct.
 
-\section{\TeX{} concepts not supported by \pkg{expl3}}
+\section{\TeX{} concepts not supported by \LaTeX3{}}
 
 The \TeX{} concept of an \enquote{\cs{outer}} macro is \emph{not supported}
-at all by \pkg{expl3}. As such, the functions provided here may break when
+at all by \LaTeX3{}. As such, the functions provided here may break when
 used on top of \LaTeXe{} if \cs{outer} tokens are used in the arguments.
 
 \DisableImplementation