diff --git a/l3kernel/doc/interface3.tex b/l3kernel/doc/interface3.tex index 01f9b3d7e5..3243a6e00e 100644 --- a/l3kernel/doc/interface3.tex +++ b/l3kernel/doc/interface3.tex @@ -28,7 +28,7 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % -% 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 @@ \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 43187b006d..60ca616620 100644 --- a/l3kernel/doc/source3.tex +++ b/l3kernel/doc/source3.tex @@ -28,7 +28,7 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % -% 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 @@ \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 2196813470..2f36e993ee 100644 --- a/l3kernel/doc/source3body.tex +++ b/l3kernel/doc/source3body.tex @@ -45,15 +45,30 @@ \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 @@ % 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 @@ \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 @@ \section{Documentation conventions} \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 @@ \section{Formal language conventions which apply generally} 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