[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: Add description for selectfont hook (9e035ecc)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/9e035ecc05539b76b0863a820600bfea6d3d8b20

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

commit 9e035ecc05539b76b0863a820600bfea6d3d8b20
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Sun Jul 18 21:56:22 2021 +0200

    Add description for selectfont hook


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

9e035ecc05539b76b0863a820600bfea6d3d8b20
 base/lthooks.dtx | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/base/lthooks.dtx b/base/lthooks.dtx
index b383758d..2a6a114e 100644
--- a/base/lthooks.dtx
+++ b/base/lthooks.dtx
@@ -32,7 +32,7 @@
 %
 %    \begin{macrocode}
 \def\lthooksversion{v1.0n}
-\def\lthooksdate{2021/06/30}
+\def\lthooksdate{2021/07/18}
 %    \end{macrocode}
 %
 %<*driver>
@@ -1794,6 +1794,21 @@
 %       These two hooks are like the previous ones but used in
 %      \cs{mdseries} command.
 %
+%    \item[\hook{selectfont}]
+%
+%      This hook is executed inside \cs{selectfont} after the current
+%      values for \textit{encoding}, \textit{family}, \textit{series},
+%      \textit{shape}, and \textit{size} are evaluated and the new font
+%      is selected (and if necessary loaded). After the hook has
+%      executed, NFSS will still do any updates necessary for a new
+%      \textit{size} (such as changing the size of \cs{strut}) and any
+%      updates necessary to a change in \textit{encoding}.
+%
+%      This hook is intended for use cases where in parallel to a
+%      change in the main font some other fonts need to be altered in
+%      parallel, e.g., in CJK processing where you deal with several
+%      different  alphabets in parallel.
+%
 %    \end{description}
 %
 %