Skip to content

Commit

Permalink
Revert "s/LaTeX3/expl3/"
Browse files Browse the repository at this point in the history
  • Loading branch information
josephwright committed Feb 8, 2021
1 parent dd006d7 commit 7726973
Show file tree
Hide file tree
Showing 3 changed files with 29 additions and 12 deletions.
4 changes: 2 additions & 2 deletions l3kernel/doc/interface3.tex
Expand Up @@ -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
Expand All @@ -45,7 +45,7 @@

\begin{document}

\title{The \pkg{expl3} Interfaces}
\title{The \LaTeX3 Interfaces}
\author{%
The \LaTeX{} Project\thanks
{%
Expand Down
4 changes: 2 additions & 2 deletions l3kernel/doc/source3.tex
Expand Up @@ -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
Expand All @@ -44,7 +44,7 @@

\begin{document}

\title{The \pkg{expl3} Sources}
\title{The \LaTeX3 Sources}
\author{%
The \LaTeX{} Project\thanks
{%
Expand Down
33 changes: 25 additions & 8 deletions l3kernel/doc/source3body.tex
Expand Up @@ -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}

Expand All @@ -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.
Expand All @@ -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}
Expand Down Expand Up @@ -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.
Expand All @@ -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
Expand Down

0 comments on commit 7726973

Please sign in to comment.