diff options
author | Norbert Preining <norbert@preining.info> | 2020-12-05 03:00:47 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2020-12-05 03:00:47 +0000 |
commit | 042d4edb85997e17a0b71f0f584e7c6371b2bf39 (patch) | |
tree | 5f4c6f9d7566fa96afec11e038da430979c6a4b1 /macros/latex/contrib/l3kernel/source3body.tex | |
parent | c21dfc1b6264e70868fc851d90a124d5b1d9c341 (diff) |
CTAN sync 202012050300
Diffstat (limited to 'macros/latex/contrib/l3kernel/source3body.tex')
-rw-r--r-- | macros/latex/contrib/l3kernel/source3body.tex | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/macros/latex/contrib/l3kernel/source3body.tex b/macros/latex/contrib/l3kernel/source3body.tex index 5586d73799..483054416e 100644 --- a/macros/latex/contrib/l3kernel/source3body.tex +++ b/macros/latex/contrib/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, |