[latex3-commits] [git/LaTeX3-latex3-latex2e] apdf161: Step file date and document behaviour [ci skip] (630caf12)

[PhelypeOleinik]

Repository : https://github.com/latex3/latex2e
On branch  : apdf161
Link       : https://github.com/latex3/latex2e/commit/630caf1269894e7a8cc8c0ff5eb12e25b867ad2b

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

commit 630caf1269894e7a8cc8c0ff5eb12e25b867ad2b
Author: PhelypeOleinik <phelype.oleinik at latex-project.org>
Date:   Thu Sep 10 13:54:49 2020 -0300

    Step file date and document behaviour [ci skip]


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

630caf1269894e7a8cc8c0ff5eb12e25b867ad2b
 base/lthooks.dtx | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/base/lthooks.dtx b/base/lthooks.dtx
index af59ff8e..46c197a0 100644
--- a/base/lthooks.dtx
+++ b/base/lthooks.dtx
@@ -32,7 +32,7 @@
 %
 %    \begin{macrocode}
 \def\lthooksversion{v1.0a}
-\def\lthooksdate{2020/08/31}
+\def\lthooksdate{2020/09/10}
 %    \end{macrocode}
 %
 %<*driver>
@@ -351,6 +351,19 @@
 % \meta{label} throughout the sub-packages in order to avoid
 % that the labels change if you internally reorganize your code.
 %
+% Except for \cs{UseHook} and \cs{UseOneTimeHook} (and their \pkg{expl3}
+% interfaces \cs{hook_use:n} and \cs{hook_use_once:n}), all \meta{hook}
+% and \meta{label} arguments are processed in the same way: first,
+% spaces are trimmed around the argument, then it is fully expanded
+% until only character tokens remain.  If the full expansion of the
+% \meta{hook} or \meta{label} contains a non-expandable non-character
+% token, a low-level \TeX{} error is raised (namely, the \meta{hook} is
+% expanded using \TeX's \cs{csname}\ldots\cs{endcsname}, as such,
+% Unicode characters are allowed in \meta{hook} and \meta{label}
+% arguments).  The arguments of \cs{UseHook} and \cs{UseOneTimeHook} are
+% processed much in the same way except that spaces are not trimmed
+% around the argument, for better performance.
+%
 % It is not enforced, but highly recommended that the hooks defined by
 % a package, and the \meta{labels} used to add code to other hooks
 % contain the package name to easily identify the source of the code