[latex3-commits] [git/LaTeX3-latex3-latex2e] gh648: Small doc changes, \changes entries, and step versions (8852e061)

[PhelypeOleinik]

Repository : https://github.com/latex3/latex2e
On branch  : gh648
Link       : https://github.com/latex3/latex2e/commit/8852e06105156cd733387ded5409d8a1aa3b095c

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

commit 8852e06105156cd733387ded5409d8a1aa3b095c
Author: PhelypeOleinik <phelype.oleinik at latex-project.org>
Date:   Thu Aug 26 00:30:01 2021 -0300

    Small doc changes, \changes entries, and step versions


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

8852e06105156cd733387ded5409d8a1aa3b095c
 base/ltclass.dtx    |  5 ++++-
 base/ltcmdhooks.dtx |  5 +++--
 base/ltfilehook.dtx | 20 ++++++++------------
 base/ltfiles.dtx    |  5 ++++-
 base/lthooks.dtx    |  8 +++++---
 5 files changed, 24 insertions(+), 19 deletions(-)

diff --git a/base/ltclass.dtx b/base/ltclass.dtx
index b7e32567..a6c846d2 100644
--- a/base/ltclass.dtx
+++ b/base/ltclass.dtx
@@ -33,7 +33,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{ltclass.dtx}
-             [2021/07/23 v1.4e LaTeX Kernel (Class & Package Interface)]
+             [2021/08/25 v1.4f LaTeX Kernel (Class & Package Interface)]
 % \iffalse
 \documentclass{ltxdoc}
 \GetFileInfo{ltclass.dtx}
@@ -68,6 +68,7 @@
 % \changes{v1.0z}{1998/03/21}{Added to documentation of filecontents}
 % \changes{v1.1c}{1998/08/17}{(RmS) Minor documentation fixes.}
 % \changes{v1.3o}{2020/08/21}{Integration of new hook management interface}
+% \changes{v1.4f}{2021/08/25}{Standardise generic hook names (gh/648)}
 %
 %
 % \section{Introduction}
@@ -2447,6 +2448,8 @@
   \@ifl at aded\@currext\@currname{}{\reserved at a}}
 %    \end{macrocode}
 %
+% \changes{v1.4f}{2021/08/25}{Declare non-generic package and class hooks}
+%   Now declare the non-generic package and class hooks used above:
 %    \begin{macrocode}
 \NewHook{package/before}
 \NewHook{class/before}
diff --git a/base/ltcmdhooks.dtx b/base/ltcmdhooks.dtx
index 15398430..ac1ab900 100644
--- a/base/ltcmdhooks.dtx
+++ b/base/ltcmdhooks.dtx
@@ -13,8 +13,8 @@
 %
 %%% From File: ltcmdhooks.dtx
 %
-\def\ltcmdhooksversion{v1.0c}
-\def\ltcmdhooksdate{2021/07/20}
+\def\ltcmdhooksversion{v1.0d}
+\def\ltcmdhooksdate{2021/08/25}
 %
 %
 %
@@ -406,6 +406,7 @@
 %   added to a generic |cmd| hook is newly declared.  It checks either
 %   tries to patch or delay patching to |\begin{document}| if in the
 %   preamble.
+% \changes{v1.0d}{2021/08/25}{Simplify generic hook detection}
 %    \begin{macrocode}
 %<latexrelease>\IncludeInRelease{2021/11/15}{\@@_try_put_cmd_hook:n}%
 %<latexrelease>                 {Standardise~generic~hook~names}
diff --git a/base/ltfilehook.dtx b/base/ltfilehook.dtx
index c311cbed..d25f3d64 100644
--- a/base/ltfilehook.dtx
+++ b/base/ltfilehook.dtx
@@ -31,8 +31,8 @@
 %%% From File: ltfilehook.dtx
 %
 %    \begin{macrocode}
-\providecommand\ltfilehookversion{v1.0k}
-\providecommand\ltfilehookdate{2021/07/23}
+\providecommand\ltfilehookversion{v1.0l}
+\providecommand\ltfilehookdate{2021/08/25}
 %    \end{macrocode}
 %
 %<*driver>
@@ -719,16 +719,10 @@
 %
 % \subsection{Declaring the file-related hooks}
 %
-%  All hooks starting with \texttt{file/} \texttt{include/},
-%  \texttt{class/} or \texttt{package/} are generic and will be
-%  allocated if code is added to them. Thus there is no need to
-%  explicitly declare any hook in the code below.
-%
-%  Furthermore, those named \texttt{.../after} or \texttt{.../end} are
-%  automatically declared as reversed hooks if filled with code, so this
-%  is also automatically taken care of.
-%
-%
+%  Three-part hooks starting with \texttt{file/} \texttt{include/},
+%  \texttt{class/} or \texttt{package/} and ending with \texttt{/before}
+%  or \texttt{/after} (or \texttt{/end} in case of \texttt{include/})
+%  are generic and will be allocated if code is added to them.
 %
 %
 % \subsection{Patching \LaTeX{}'s \cs{InputIfFileExists} command}
@@ -848,6 +842,8 @@
 \def\unqu at tefilef@und"#1" \@nil{#1}
 %    \end{macrocode}
 %
+% \changes{v1.0l}{2021/08/25}{Declare non-generic file hooks}
+%   Now declare the non-generic file hooks used above:
 %    \begin{macrocode}
 \NewHook{file/before}
 \NewReversedHook{file/after}
diff --git a/base/ltfiles.dtx b/base/ltfiles.dtx
index c18f1f44..aea14e9c 100644
--- a/base/ltfiles.dtx
+++ b/base/ltfiles.dtx
@@ -32,7 +32,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{ltfiles.dtx}
-             [2021/07/23 v1.2n LaTeX Kernel (File Handling)]
+             [2021/08/25 v1.2o LaTeX Kernel (File Handling)]
 % \iffalse
 \documentclass{ltxdoc}
 \GetFileInfo{ltfiles.dtx}
@@ -851,6 +851,7 @@
 %    Execute the \texttt{before} hooks just after we switched the
 %    \texttt{.aux} file \ldots
 % \changes{v1.2n}{2021/07/23}{Make include/name/before a one-time hook}
+% \changes{v1.2o}{2021/08/25}{Standardise generic hook names (gh/648)}
 %    \begin{macrocode}
     \UseHook{include/before}%
     \UseOneTimeHook{include/#1/before}%
@@ -894,6 +895,8 @@
   \let\@auxout\@mainaux}
 %    \end{macrocode}
 %
+% \changes{v1.2o}{2021/08/25}{Declare non-generic include hooks}
+%   Now declare the non-generic include hooks used above:
 %    \begin{macrocode}
 \NewHook{include/before}
 \NewReversedHook{include/end}
diff --git a/base/lthooks.dtx b/base/lthooks.dtx
index a0787500..38b2d0d1 100644
--- a/base/lthooks.dtx
+++ b/base/lthooks.dtx
@@ -31,8 +31,8 @@
 %%% From File: lthooks.dtx
 %
 %    \begin{macrocode}
-\def\lthooksversion{v1.0o}
-\def\lthooksdate{2021/08/12}
+\def\lthooksversion{v1.0p}
+\def\lthooksdate{2021/08/25}
 %    \end{macrocode}
 %
 %<*driver>
@@ -2901,6 +2901,7 @@
 %   next-execution hooks does the same: it defers the code to
 %   \cs{hook_gput_next_code:nn} if the generic hook was declared, or
 %   to \cs{@@_gput_next_do:nn} otherwise.
+% \changes{v1.0p}{2021/08/25}{Standardise generic hook names (gh/648)}
 %    \begin{macrocode}
 %<latexrelease>\IncludeInRelease{2021/11/15}{\@@_try_declaring_generic_hook:nnn}
 %<latexrelease>                 {Standardise~generic~hook~names}
@@ -4763,7 +4764,8 @@
 % \begin{macro}[pTF]{\@@_if_generic:n}
 % \begin{macro}[pTF]{\@@_if_deprecated_generic:n}
 %   An internal conditional that checks if a name belongs to a generic
-%   hook.
+%   hook.  The deprecated version needs to check if |#3| is empty to
+%   avoid returning true on \hook{file/before}, for example.
 %    \begin{macrocode}
 \prg_new_conditional:Npnn \@@_if_generic:n #1 { TF }
   { \@@_if_generic:w #1 / / / \s_@@_mark }