[latex3-commits] [git/LaTeX3-latex3-latex2e] hotfix/latexrelease: added recent changes to latexchanges.tex (0aa7fb35)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : hotfix/latexrelease
Link       : https://github.com/latex3/latex2e/commit/0aa7fb358291c93765a54fb498ad77c1f997ea4f

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

commit 0aa7fb358291c93765a54fb498ad77c1f997ea4f
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Fri Jan 8 00:47:54 2021 +0100

    added recent changes to latexchanges.tex


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

0aa7fb358291c93765a54fb498ad77c1f997ea4f
 base/doc/latexchanges.tex | 97 +++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 81 insertions(+), 16 deletions(-)

diff --git a/base/doc/latexchanges.tex b/base/doc/latexchanges.tex
index dc8eb4be..11ffbd2c 100644
--- a/base/doc/latexchanges.tex
+++ b/base/doc/latexchanges.tex
@@ -38,10 +38,10 @@
 
 \title{Changes to the \LaTeXe{} format}
 
-\author{\copyright~Copyright 2015--2020, \LaTeX3 Project Team.\\
+\author{\copyright~Copyright 2015--2021, \LaTeX3 Project Team.\\
    All rights reserved.}
 
-\date{2020-02-02}
+\date{2021-01-08}
 
 % a few commands from doc
 \newcommand\Lpack[1]{\mbox{\textsf{#1}}}
@@ -75,16 +75,15 @@
      \url{https://tex.stackexchange.com/q/#1}}
 \fi
 
-\begin{document}
 
-\maketitle
+\setcounter{tocdepth}{1}  % don't show subsections
 
-\tableofcontents
 
-\newpage
+\begin{document}
 
-\section{Introduction}
+\maketitle
 
+\begin{abstract}
 This document describes changes that were made to the
 \LaTeX\ format since the  2014-05-01 \LaTeX\ releases.
 
@@ -99,13 +98,79 @@ As a summary of changes for a main release will always be available in
 but changes in any patch releases will be listed in more
 detail here.
 
-More  detailed change logs are available as
+More detailed change logs are available as
 \texttt{changes.txt} in the base distribution, and full code
   differences may be browsed via the code repository on GitHub
 see for example
 \url{https://github.com/latex3/latex2e/commits/master}.
+\end{abstract}
+
+\tableofcontents
+
+\newpage
+
+%\section{Introduction}
+
+
+
+\section{Changes introduced in 2020-10-01 patch~4}
+
+This patch fixed two bugs in the hook management: if debugging for the
+L3 programming layer was turned on it reported inconsistent use of
+local/global variables. This was a spurious warning but nevertheless
+disconcerting (\ghissue{463}). The other bug was more serious, in some
+situations a wrong value \verb=\CurrentFile= inside of file-related hooks
+could lead to errors (\ghissue{464}).
+
+We also added the documentation file \texttt{userguide3.pdf} which
+will become the main home for documenting new features of \LaTeX. At
+this point in time it covers the \Lpack{xparse} functionality that has
+been added to the kernel.
+
+\section{Changes introduced in 2020-10-01 patch~3}
+
+This patch fixed some rollback issues that prevented successful
+rollback to other release levels in some cases.  It also fixed an issue
+with file hooks involving files with explicit paths  (\ghissue{422}).
+
+One important change what to handle hook declarations done in the
+document preamble in a special way, e.g., those done with
+\verb=\AtBeginDocument=. They are now always executed last and are not
+subject to the normal code sorting for hooks, because they are nearly always
+needed to overwrite earlier settings made in packages.
+
+Finally, the NFSS series handling was slightly changed to
+automatically drop surplus ``\texttt{m}''s from series specifications
+when needed (and warn about them when encountered), e.g.,
+``\texttt{mc}'' automatically becomes ``\texttt{c}'' which is the
+official NFSS name for a \emph{medium compact} series (\ghissue{453}).
+This was done to improve the fix in 2020-02-02 PL~5.
+
+\section{Changes introduced in 2020-10-01 patch~2}
+
+This patch fixed the passing of options to packages and classes when
+if they are stored in a special place (denoted by \verb=\input at path=)
+instead of their normal location (\ghissue{414}). In that case the
+options got lost.
+
+\section{Changes introduced in 2020-10-01 patch~1}
+
+This patch fixed a file handling issue: to allow for spaces in file
+names quotes were used but this upsets Bib\TeX{} (\ghissue{400}).  In
+addition, two rollback issues got corrected.
+
+\section{Changes introduced in 2020-10-01}
 
+Major enhancements in this release include pre-loading of the
+\Lpack{xparse} package for producing document-level commands with more
+complicated argument signatures and the new hook management system for
+\LaTeX{} documented in \texttt{lthooks-doc.pdf},
+\texttt{ltfilehook-doc.pdf} and \texttt{ltshipout-doc.pdf}.
 
+In addition there have been many smaller fixes and enhancements.
+Please see \ltnewsissue{32} for an overview of the new features and
+the change log in \texttt{changes.txt} for a more detailed list of
+individual changes.
 
 \section{Changes introduced in 2020-02-02 patch~5}
 
@@ -167,7 +232,7 @@ Major enhancements in this release include pre-loading \Lpack{expl3}
 to improve startup times, especially with Lua\TeX\ and Xe\TeX, and
 extra features in the font selection mechanism. Please see
 \ltnewsissue{31}  for an overview of the new features and the change
-log in \texttt{changelog.txt} for a more detailed list of individual
+log in \texttt{changes.txt} for a more detailed list of individual
 changes.
 
 
@@ -248,7 +313,7 @@ counter prefix commands \verb|p at ...| so that they would take the counter
 value as an argument instead of just acting as a prefix to them. These
 packages also provided the \verb|\labelformat| macro to change the prefix
 macro and \verb|\Ref| so that using counters defined that way in the
-beginning of sentences would have the proper capitalisation. These features
+beginning of sentences would have the proper capitalization. These features
 were added to the \LaTeXe{} kernel.
 
 The kernel now says ``Trying to load\ldots''
@@ -283,7 +348,7 @@ provided as alias for the names based on the Adobe font names
 The use of potrusion in tables of contents is suppressed by default,
 see \sxquestion{172785}.
 
-The handling of visible space in verbation was adjusted for
+The handling of visible space in verbatim was adjusted for
 \ghissue{69} and \ghissue{70}.
 
 Spaces are removed from the argument passed to BiBTeX, \ghissue{88}.
@@ -295,7 +360,7 @@ levels of split hyperlinks, avoiding a fatal pdftex error. \ghissue{94}.
 
 
 \section{Changes  introduced in 2018-04-01 patch~5}
-Improved support for non ASCII filenames on the commandline on
+Improved support for non ASCII filenames on the command line on
 filesystems using legacy encodings.
 
 Adjusted the new package rollback code so that some edge cases where rollback
@@ -344,11 +409,11 @@ Lua\TeX, now at 1.04.
 
 Previously defining an encoding-specific composite with an undeclared
 accent (or an accent declared later) gave no error, but did nothing useful.
-\LaTeX\ will now detect this and give the accent comamnd a default definition
+\LaTeX\ will now detect this and give the accent command a default definition
 as an error, allowing the declared composite to work as intended.
 
 The definition of \verb|\-| is adjusted to match the comments in
-\gnatsissue{3855} to accomodate non standard settings of \verb|\hyphenchar|.
+\gnatsissue{3855} to accommodate non standard settings of \verb|\hyphenchar|.
 
 In parboxes and similar settings, \verb|\lineskiplimit| is now
 reset (to the existing default value, \verb|\normallineskiplimit|).
@@ -409,7 +474,7 @@ Load Unicode data from new generic \texttt{unicode-data} distribution.
 
 \section{Changes  introduced in 2015/10/01 patch~2}
 
-This release fixes the behaviour of the allocation mechanism if the switch
+This release fixes the behavior of the allocation mechanism if the switch
 from the standard to extended pool takes place within a group.
 
 \section{Changes  introduced in 2015/10/01 patch~1}
@@ -444,7 +509,7 @@ The command |\textcommabelow| has been added. This is mainly intended for Romani
 \textcommabelow{S}\,\textcommabelow{s}\,\textcommabelow{T}\,\textcommabelow{t}.
 
 \subsection{Unicode 8}
-The file |unicode-letters.def| used to initialise character data in
+The file |unicode-letters.def| used to initialize character data in
 Unicode \TeX\ variants has been regenerated from data files updated
 to Unicode~8.