diff options
author | Karl Berry <karl@freefriends.org> | 2020-12-04 22:23:08 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-12-04 22:23:08 +0000 |
commit | 308fffa9446e3b5d28b6e48b89be81575b565c70 (patch) | |
tree | b33f5e1cf009bf510dd974451299d08dc0ffab2a /Master/texmf-dist/doc/latex/l3kernel/source3body.tex | |
parent | c4c23071af2870bf72f421f1aae5c9544ff3a87d (diff) |
l3kernel (4dec20)
git-svn-id: svn://tug.org/texlive/trunk@57066 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/l3kernel/source3body.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/l3kernel/source3body.tex | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex index 5586d73799c..483054416e9 100644 --- a/Master/texmf-dist/doc/latex/l3kernel/source3body.tex +++ b/Master/texmf-dist/doc/latex/l3kernel/source3body.tex @@ -192,10 +192,22 @@ following argument specifiers: \emph{weird} arguments. This covers everything else, but mainly applies to delimited values (where the argument must be terminated by some specified string). - \item[\texttt{D}] The \texttt{D} specifier means \emph{do not use}. + \item[\texttt{D}] The \texttt{D} stands for \textbf{Do not use}. All of the \TeX{} primitives are initially \cs{let} to a \texttt{D} - name, and some are then given a second name. Only the kernel - team should use anything with a \texttt{D} specifier! + name, and some are then given a second name. + These functions have no standardized syntax, they are engine + dependent and their name can change without warning, thus their + use is \emph{strongly discouraged} in package code: programmers + should instead use the interfaces documented in + \href{interface3.pdf}{interface3.pdf}%^^A + \footnote{If a primitive offers a functionality not yet in the + kernel, programmers and users are encouraged to write to the + \texttt{LaTeX-L} mailing list + (\url{mailto:LATEX-L@listserv.uni-heidelberg.de}) describing + their use-case and intended behaviour, so that a possible + interface can be discussed. Temporarily, while an interface is + not provided, programmers may use the procedure described in the + \href{l3styleguide.pdf}{l3styleguide.pdf}.}. \end{description} Notice that the argument specifier describes how the argument is processed prior to being passed to the underlying function. For example, |