[latex3-commits] [latex3/latex2e] develop: updated documentation for #1292 also fixed type in in change entry for amsmath (f4624209)

[github at latex-project.org]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/f4624209517979a53f09b3d8db5666b396127491

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

commit f4624209517979a53f09b3d8db5666b396127491
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Wed Mar 13 11:54:53 2024 +0100

    updated documentation for #1292
    also fixed type in in change entry for amsmath


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

f4624209517979a53f09b3d8db5666b396127491
 base/changes.txt             |  5 +++++
 base/ltfilehook.dtx          | 12 ++++++++----
 required/amsmath/amsmath.dtx |  4 ++--
 3 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/base/changes.txt b/base/changes.txt
index 1e76ddf9..ec41dc90 100644
--- a/base/changes.txt
+++ b/base/changes.txt
@@ -6,6 +6,11 @@ to completeness or accuracy and it contains some references to files that are
 not part of the distribution.
 ================================================================================
 
+2024-03-13  Frank Mittelbach  <Frank.Mittelbach at latex-project.org>
+	* ltfilehook.dtx (subsection{Kernel, class, and package interfaces for \LaTeX{}}):
+	Clarify that the commands in this section are meant to be usable
+	by the kernel and in classes or packages (gh/1292)
+
 2024-02-15 Joseph Wright  <Joseph.Wright at latex-project.org>
 	* lttemplates.dtx
 	Re-introduce \IfInstanceExist(TF)
diff --git a/base/ltfilehook.dtx b/base/ltfilehook.dtx
index 831d633e..02e95d0f 100644
--- a/base/ltfilehook.dtx
+++ b/base/ltfilehook.dtx
@@ -34,7 +34,7 @@
 %\iffalse
 %<*driver,structuredlog>
 %\fi
-\def\ltfilehookdate{2024/02/11}
+\def\ltfilehookdate{2024/03/13}
 \def\ltfilehookversion{v1.0o}
 %\iffalse
 %</driver,structuredlog>
@@ -381,7 +381,7 @@
 %
 %
 %
-% \subsection{Internal interfaces for \LaTeX{}}
+% \subsection{Kernel, class, and package interfaces for \LaTeX{}}
 %
 % \begin{function}{\declare at file@substitution,\undeclare at file@substitution}
 %   \begin{syntax}
@@ -399,6 +399,8 @@
 %    example, or to provide a version that makes use of new kernel
 %    functionality while the original package remains available for
 %    use with older releases.
+%    As such it is mainly meant for use in the \LaTeX{} kernel but
+%    other use cases are conceivable.
 %
 %    The \cs{undeclare at file@substitution} declaration undoes a
 %    substitution made earlier.
@@ -416,7 +418,7 @@
 %     \cs{disable at package@load}  \Arg{package} \Arg{alternate-code}
 %     \cs{reenable at package@load} \Arg{package}
 %   \end{syntax}
-%    If \meta{package} is requested do not load it but instead run
+%    If \meta{package} is requested, do not load it but instead run
 %    \meta{alternate-code} which could issue a warning, error or any
 %    other code.
 %
@@ -427,7 +429,9 @@
 %    are not available.
 %
 %    The function is only implemented for packages not for arbitrary
-%    files.
+%    files and again it should only be applied if there are good
+%    reasons for doing this.\footnote{Just to be sure: \enquote{I don't
+%    like this package by somebody else} is not a good one :-)}
 %  \end{function}
 %
 %
diff --git a/required/amsmath/amsmath.dtx b/required/amsmath/amsmath.dtx
index ef199266..d0ed1318 100644
--- a/required/amsmath/amsmath.dtx
+++ b/required/amsmath/amsmath.dtx
@@ -86,7 +86,7 @@ Bug reports can be opened (category \texttt{#1}) at\\%
 %    \end{macrocode}
 %
 %    \begin{macrocode}
-\ProvidesPackage{amsmath}[2024/03/11 v2.17p AMS math features]
+\ProvidesPackage{amsmath}[2024/03/13 v2.17p AMS math features]
 %    \end{macrocode}
 %
 % \section{Catcode defenses}
@@ -4156,7 +4156,7 @@ and fix things up.}
 %    \end{macrocode}
 %    Also reset \cs{lineht@} to avoid that this is incorrectly picked
 %    up by a following environment, such as \env{align}.
-% \changes{v2.17p}{2024/03/11}{Reset \cs{lineht} (gh/1289)}
+% \changes{v2.17p}{2024/03/11}{Reset \cs{lineht@} (gh/1289)}
 %    \begin{macrocode}
     \global\lineht@\z@
     \cr