[latex3-commits] [git/LaTeX3-latex3-latex2e] gh625: Doc fixes (15524260)

[PhelypeOleinik]

Repository : https://github.com/latex3/latex2e
On branch  : gh625
Link       : https://github.com/latex3/latex2e/commit/15524260847b7ac98f5b0fdc0593f112c536ae49

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

commit 15524260847b7ac98f5b0fdc0593f112c536ae49
Author: PhelypeOleinik <phelype.oleinik at latex-project.org>
Date:   Tue Jul 27 06:26:12 2021 -0300

    Doc fixes
    
    And remove one unused variant


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

15524260847b7ac98f5b0fdc0593f112c536ae49
 base/lthooks.dtx | 41 ++++++++++++++++++++++++++---------------
 1 file changed, 26 insertions(+), 15 deletions(-)

diff --git a/base/lthooks.dtx b/base/lthooks.dtx
index 0f719bf6..d95b5838 100644
--- a/base/lthooks.dtx
+++ b/base/lthooks.dtx
@@ -1910,13 +1910,6 @@
 %    \end{macrocode}
 %  \end{macro}
 %
-% \begin{macro}{\g_@@_removal_list_prop}
-%   A token list to hold delayed removals.
-%    \begin{macrocode}
-\tl_new:N \g_@@_removal_list_tl
-%    \end{macrocode}
-% \end{macro}
-%
 % \begin{macro}{\l_@@_cur_hook_tl}
 %   Stores the name of the hook currently being sorted.
 %    \begin{macrocode}
@@ -2712,10 +2705,13 @@
 % \subsection{Adding or removing hook code}
 %
 % \begin{macro}{\hook_gput_code:nnn}
-% \begin{macro}{\@@_gput_code:nnn,\@@_gput_code:nxv,\@@_hook_gput_code_do:nnn}
+% \begin{macro}{\@@_gput_code:nnn,\@@_hook_gput_code_do:nnn}
 %
+%    \begin{macrocode}
 %<latexrelease>\IncludeInRelease{2021/11/15}%
 %<latexrelease>                 {\hook_gput_code:nnn}{Do~not~queue~removals}
+%    \end{macrocode}
+%
 %    With \cs{hook_gput_code:nnn}\Arg{hook}\Arg{label}\Arg{code} a
 %    chunk of \meta{code} is added to an existing \meta{hook} labeled
 %    with \meta{label}.
@@ -2766,10 +2762,22 @@
       }
   }
 %    \end{macrocode}
+%
+%    \begin{macrocode}
 %<latexrelease>\EndIncludeInRelease
 %
 %<latexrelease>\IncludeInRelease{2020/10/01}%
 %<latexrelease>                 {\hook_gput_code:nnn}{Do~not~queue~removals}
+%    \end{macrocode}
+%
+% \begin{macro}{\g_@@_removal_list_prop}
+%   A token list to hold delayed removals.
+%    \begin{macrocode}
+%<latexrelease>\tl_new:N \g_@@_removal_list_tl
+%    \end{macrocode}
+% \end{macro}
+%
+%    \begin{macrocode}
 %<latexrelease>\cs_new_protected:Npn \@@_gput_code:nnn #1 #2 #3
 %<latexrelease>  {
 %<latexrelease>    \prop_if_in:NnTF \g_@@_execute_immediately_prop {#1}
@@ -2792,9 +2800,6 @@
 %<latexrelease>      }
 %<latexrelease>  }
 %<latexrelease>\EndIncludeInRelease
-%
-%    \begin{macrocode}
-\cs_generate_variant:Nn \@@_gput_code:nnn { nxv }
 %    \end{macrocode}
 %
 %    This macro will unconditionally add a chunk of code to the given hook.
@@ -2927,7 +2932,7 @@
 %
 %    \begin{macrocode}
 %<latexrelease>\IncludeInRelease{2021/06/01}%
-%<latexrelease>         {\@@_try_declaring_generic_hook:wn}{Support~cmd~hooks}
+%<latexrelease>        {\@@_try_declaring_generic_hook:wn}{Support~cmd~hooks}
 \prg_new_protected_conditional:Npnn \@@_try_declaring_generic_hook:wn
     #1 / #2 / #3 / #4 \scan_stop: #5 { TF }
   {
@@ -2975,7 +2980,7 @@
 %
 %    \begin{macrocode}
 %<latexrelease>\IncludeInRelease{2020/10/01}%
-%<latexrelease>         {\@@_try_declaring_generic_hook:wn}{Support~cmd~hooks}
+%<latexrelease>        {\@@_try_declaring_generic_hook:wn}{Support~cmd~hooks}
 %<latexrelease>
 %<latexrelease>\prg_new_protected_conditional:Npnn \@@_try_declaring_generic_hook:wn
 %<latexrelease>    #1 / #2 / #3 / #4 \scan_stop: #5 { TF }
@@ -3102,8 +3107,11 @@
 % \begin{macro}{\hook_gremove_code:nn}
 % \begin{macro}{\@@_gremove_code:nn}
 %
+%    \begin{macrocode}
 %<latexrelease>\IncludeInRelease{2021/11/15}%
 %<latexrelease>                 {\hook_gremove_code:nn}{Do~not~queue~removals}
+%    \end{macrocode}
+%
 %    With \cs{hook_gremove_code:nn}\Arg{hook}\Arg{label} any code
 %    for \meta{hook} stored under \meta{label} is removed.
 % \changes{v1.0o}{2021/07/22}{Do not queue removals (gh/625)}
@@ -3160,8 +3168,10 @@
       { \msg_error:nnnn { hooks } { cannot-remove } {#1} {#2} }
   }
 %    \end{macrocode}
-%<latexrelease>\EndIncludeInRelease
 %
+%    \begin{macrocode}
+%<latexrelease>\EndIncludeInRelease
+%<latexrelease>
 %<latexrelease>\IncludeInRelease{2020/10/01}%
 %<latexrelease>                 {\hook_gremove_code:nn}{Do~not~queue~removals}
 %<latexrelease>\cs_gset_protected:Npn \@@_gremove_code:nn #1 #2
@@ -3191,6 +3201,7 @@
 %<latexrelease>  }
 %<latexrelease>\cs_gset_protected:Npn \@@_gremove_code_do:nn #1 #2
 %<latexrelease>  { \prop_gremove:cn { g_@@_#1_code_prop } {#2} }
+%    \end{macrocode}
 % \end{macro}
 % \end{macro}
 %
@@ -3248,9 +3259,9 @@
 %    \begin{macrocode}
 %<latexrelease>\cs_new:Npn \@@_removal_tl:nn #1 #2
 %<latexrelease>  { & \tl_to_str:n {#2} $ \tl_to_str:n {#1} $ }
+%<latexrelease>\EndIncludeInRelease
 %    \end{macrocode}
 % \end{macro}
-%<latexrelease>\EndIncludeInRelease
 %
 %
 % \begin{macro}{