Improving an Example in lthooks-doc Documentation

[Sophanatprime]

I would like to report a potential improvement in the lthooks-doc documentation. The following example is currently included in the documentation:

\AddToHook{env/quote/before}{\small}
\begin{quote}
  A quote set in a smaller typeface
\end{quote}
...
\RemoveFromHook{env/quote/before}
... now back to normal for further quotes

the source code

latex2e/base/lthooks.dtx

Lines 441 to 452 in 5dbc00a

	% A useful application for this declaration inside the document body
	% is when one wants to temporarily add code to hooks and later remove
	% it again, e.g.,
	%\begin{verbatim}
	% \AddToHook{env/quote/before}{\small}
	% \begin{quote}
	% A quote set in a smaller typeface
	% \end{quote}
	% ...
	% \RemoveFromHook{env/quote/before}
	% ... now back to normal for further quotes
	%\end{verbatim}

The issue arises when users employ the above code. Even after using \RemoveFromHook to remove \small, subsequent text would remain in a smaller typeface. This can be confusing because env/quote/before is not limited to the quote environment but rather affects the global scope in this example. Users who are unaware of this behavior or have not yet read section 3.1.1 might mistakenly believe that \RemoveFromHook is not functioning correctly.

It would be beneficial to clarify this behavior in the documentation to prevent misunderstandings, or change env/quote/before to env/quote/begin.

[FrankMittelbach]

that's a clear documentation bug, thanks for pointing it out -- all the best for 2025