Small doc changes, \changes entries, and step versions

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@aded\@currext\@currname{}{\reserved@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}

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}

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@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}

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}

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 }
@@ -4808,7 +4810,7 @@
 %
 %  \subsection{Messages}
 %
-%    Hook errors are LaTeX kernel errors:  
+%    Hook errors are LaTeX kernel errors:
 %    \begin{macrocode}
 \prop_gput:Nnn \g_msg_module_type_prop { hooks } { LaTeX }
 %    \end{macrocode}