[latex3-commits] [git/LaTeX3-latex3-latex3] main: Add a note about (u)pTeX and \codepoint_generate:nn (428132c39)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/428132c391968bc5728d37adfaed94c24db70f57

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

commit 428132c391968bc5728d37adfaed94c24db70f57
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Mon Feb 13 08:41:44 2023 +0000

    Add a note about (u)pTeX and \codepoint_generate:nn


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

428132c391968bc5728d37adfaed94c24db70f57
 l3kernel/l3unicode.dtx | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/l3kernel/l3unicode.dtx b/l3kernel/l3unicode.dtx
index 425fd5cf0..da60f5f25 100644
--- a/l3kernel/l3unicode.dtx
+++ b/l3kernel/l3unicode.dtx
@@ -83,6 +83,13 @@
 %   $13$); for codepoints in the ASCII range, the given \meta{catcode}
 %   will be used. To allow the result of this function to be used
 %   inside a expansion context, the result is protected by \cs{exp_not:n}.
+%
+%   \begin{texnote}
+%     Users of (u)p\TeX{} note that these engines are treated as $8$-bit in
+%     this context. In particular, for up\TeX{}, irrespective of the
+%     \tn{kcatcode} of the \meta{codepoint}, any value outside the ASCII range
+%     will result in a series of active bytes being generated.
+%   \end{texnote}
 % \end{function}
 %
 % \begin{function}[EXP, added = 2022-10-09]