[latex3-commits] [git/LaTeX3-latex3-latex2e] gh648: Add ltnews34 entry (f318b827)

[PhelypeOleinik]

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

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

commit f318b827d367b7a18fccfdbbb0812cedcb1cd2ef
Author: PhelypeOleinik <phelype.oleinik at latex-project.org>
Date:   Thu Aug 26 17:09:24 2021 -0300

    Add ltnews34 entry


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

f318b827d367b7a18fccfdbbb0812cedcb1cd2ef
 base/doc/ltnews34.tex | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/base/doc/ltnews34.tex b/base/doc/ltnews34.tex
index 02176725..02de5d25 100644
--- a/base/doc/ltnews34.tex
+++ b/base/doc/ltnews34.tex
@@ -48,6 +48,8 @@
 \usepackage{lmodern,url,hologo}
 
 \usepackage{csquotes}
+\usepackage{booktabs}
+\usepackage{array}
 \usepackage{multicol}
 
 \providecommand\hook[1]{\texttt{#1}}
@@ -178,6 +180,46 @@ before.
 \githubissue{623}
 
 
+\subsection{Standardizing generic hook names}
+
+The initial set of generic hooks provided by the \LaTeXe{} kernel had
+two patterns of hook names:  ones like
+\verb|env/|\meta{name}\verb|/after|, with the variable (\meta{name})
+part in the middle position, and ones like
+\verb|file/after/|\meta{name}, with the variable part in the third
+position.  The coexistence of these two types caused confusion, because
+the user had to remember in which position was the variable part
+supposed to go, and made the code more complicated and slower.
+
+The file-related hooks have been renamed so that the variable part of
+their is in the middle, as with other hooks.  The changes were:
+\begin{center}
+  \small\ttfamily
+  \begin{tabular}{l@{\;$\rightarrow$\;}l}
+    \toprule
+    \multicolumn{1}{l}{Old name} & \rmfamily New name \\
+    \midrule
+    file/before/\meta{name}    & file/\meta{name}/before \\
+    file/after/\meta{name}     & file/\meta{name}/after \\
+    package/before/\meta{name} & package/\meta{name}/before \\
+    package/after/\meta{name}  & package/\meta{name}/after \\
+    class/before/\meta{name}   & class/\meta{name}/before \\
+    class/after/\meta{name}    & class/\meta{name}/after \\
+    include/before/\meta{name} & include/\meta{name}/before \\
+    include/end/\meta{name}    & include/\meta{name}/end \\
+    include/after/\meta{name}  & include/\meta{name}/after \\
+    \bottomrule
+  \end{tabular}
+\end{center}
+
+Since this is a breaking change, the old names will still work for a
+while, so that users and package authors have enough time to adjust, and
+a warning will be issued when the old names are used.  Eventually the
+deprecated names will be turned into errors and then removed completely.
+%
+\githubissue{648}
+
+