[latex3-commits] [latex3/latex2e] develop: minor tweaks by kb; explicit pagebreaks to preserve pagination in TUB (if possible) (809a9b75)

[github at latex-project.org]

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

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

commit 809a9b7559d62b9f81a2c4d3c4d2e1efeb69e427
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Mon Oct 30 23:35:10 2023 +0100

    minor tweaks by kb;
    explicit pagebreaks to preserve pagination in TUB (if possible)


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

809a9b7559d62b9f81a2c4d3c4d2e1efeb69e427
 base/doc/ltnews38.tex | 42 +++++++++++++++++++++++++++---------------
 1 file changed, 27 insertions(+), 15 deletions(-)

diff --git a/base/doc/ltnews38.tex b/base/doc/ltnews38.tex
index 0255f205..04ffe1a0 100644
--- a/base/doc/ltnews38.tex
+++ b/base/doc/ltnews38.tex
@@ -101,6 +101,8 @@
 \vbadness=1400  % accept slightly empty columns
 
 
+\let\finalpagebreak\pagebreak % for TUB (if they use it)
+
 \makeatletter
 % maybe not the greatest design but normally we wouldn't have subsubsections
 \renewcommand{\subsubsection}{%
@@ -166,7 +168,9 @@ at the top.
 In addition, a number of extension packages that go beyond Lamport are
 already supported, most importantly perhaps \pkg{amsmath} (providing
 extended math capabilities) and \pkg{hyperref} (enhancing \LaTeX{}
-with interactive hyperlinking features). Also already supported are
+with interactive hyperlinking features).
+\finalpagebreak
+Also already supported are
 some of the major bibliography support packages such as \pkg{natbib}
 and \pkg{biblatex}.
 
@@ -218,7 +222,9 @@ preamble) can safely add their own code to extend the functionality of
 existing commands and environments without the need to overwrite or
 patch them in incompatible ways. An important feature of such hooks is
 that the code chunks added by different packages can be ordered by
-rules, if necessary, thereby avoiding problems arising from
+rules, if necessary,
+\finalpagebreak
+thereby avoiding problems arising from
 differences in package loading order. See \LaTeX{} News issues
 32--34~\cite{38:ltnews} for more information.
 
@@ -236,8 +242,8 @@ the same point interfering with the algorithm.
 
 For these use cases we now introduce the concept of sockets and plugs.
 A socket is a place in the code into which one can put a plug (a
-chunk of code with a name) after which the socket is in use and to put
-a different plug in, the former one has to be taken out
+chunk of code with a name) after which the socket is in use; to put in
+a different plug, the former one has to be taken out
 first.\footnote{Think of electric outlets and plugging something into
 them.} A socket may or may not have inputs that can then be used by
 the plugs.
@@ -260,7 +266,7 @@ with the name \texttt{noop} for the socket and assigns it to the socket
 nothing\footnote{Sockets with one input also define an
 \texttt{identity} plug and initially assign that to the socket\Dash
 this means that their input is simply returned without processing.}
-until you assign it a different plug which is done with
+until you assign it a different plug, which is done with
 \cs{AssignSocketPlug}. This takes the current plug out and puts the
 new one in.
 %
@@ -274,10 +280,11 @@ altering their behavior if the tagging code is inactive. Activating
 one or the other form of tagging then just means to assign named plugs
 to the different sockets.
 
-This is just a brief introduction to the mechanism, for more detailed
+This is just a brief introduction to the mechanism; for more detailed
 documentation see \texttt{texdoc ltsockets-doc}.
 
 
+\finalpagebreak
 
 \section{Document properties and cross-referencing}
 
@@ -295,7 +302,7 @@ anywhere in the next run of the document) by use of the
 (non-expandable) commands \cs{ref} and \cs{pageref} using the
 \emph{key} that was specified as the argument to \cs{label} when
 recording these values.  This supported basic cross-referencing
-(within a document) using these recorded values to provide both
+(within a document), using these recorded values to provide both
 page-related and counter-related information (such as the page xvii or
 the subsection number 4.5.2).\footnote{In the Spring 2023 release of
 \LaTeX{}, the \cs{label} command was extended to record, in addition,
@@ -339,6 +346,7 @@ number, for example, here is the declaration to use.
 \begin{verbatim}
   \NewProperty{chapter}{now}{?}{\thechapter}
 \end{verbatim}
+\par\finalpagebreak\noindent
 The second argument means that the property value will be recorded
 immediately (\enquote{now}), and not \enquote{during the next
   \cs{shipout}}.  The third argument sets a default to be used when,
@@ -410,6 +418,7 @@ For a more complete documentation, see \texttt{texdoc ltproperties-doc}.
 
 
 
+\finalpagebreak
 
 \section{New or improved commands}
 
@@ -444,7 +453,7 @@ just after the line which identifies the format (\texttt{LaTeX2e}, etc.).
 \cs{verb}, but was done in a way that meant that they remained as normal spaces
 even in \cs{verb*}, etc. We have now adjusted the code so that tabs are
 retained within the argument to \cs{verb} and \cs{verb*}, and the
-\env{verbatim} and \env{verbatim*} environments independently from
+\env{verbatim} and \env{verbatim*} environments, independently from
 spaces, and are set up to print in the same way spaces do. This means that they
 now generate visible spaces inside \cs{verb*} and \env{verbatim*}, and their
 behavior can be adjusted if required to be different from that of spaces.
@@ -453,8 +462,8 @@ behavior can be adjusted if required to be different from that of spaces.
 
 
 \subsection{Improved argument checking for box commands}
-Previously if an alignment option had an unexpected value such as
-\verb|\makebox[4cm][x]{text}|
+Previously if an alignment option had an unexpected value, such as
+\verb|\makebox[4cm][x]{text}|,
 no warning was given but the box content was silently discarded.
 This will now produce a warning and act like the default \texttt{c} alignment.
 \cs{framebox} and \cs{parbox} have a similar change.
@@ -471,6 +480,7 @@ independent of the engine in use. This has now been corrected: the definition
 of \verb|~| is an engine-protected one which gives the string version of the
 character if used inside a csname.
 
+\finalpagebreak
 
 \subsection{In the programming layer}
 
@@ -525,7 +535,7 @@ $
 
 Users will be able to access added functions without needing to use the
 \pkg{expl3} layer. It is possible that a future release of \LaTeX{} will
-add the ability to create and set floating point variables to the
+add the ability to create and set floating point variables at the
 document level: this will be examined based on feedback on the
 utility of the programming layer change.
 
@@ -544,6 +554,7 @@ not have been made available directly in the kernel.
 
 % \section{Bug fixes}
 
+\finalpagebreak
 
 \section{Changes to packages in the \pkg{tools} category}
 
@@ -560,6 +571,7 @@ the strut the same definition as \pkg{array}.
 \githubissue{1128}
 
 \medskip
+\tubcommand{\newpage}
 
 \begin{thebibliography}{9}
 
@@ -568,18 +580,18 @@ the strut the same definition as \pkg{array}.
 
 \bibitem{38:Lamport}
 Leslie Lamport.
-\newblock {\LaTeX}: {A} Document Preparation System: User's Guide and Reference
-  Manual.
+\newblock \emph{{\LaTeX}: {A} Document Preparation System: User's Guide and Reference
+  Manual}.
 \newblock \mbox{Addison}-Wesley, Reading, MA, USA, 2nd edition, 1994.
 \newblock ISBN 0-201-52983-1.
 \newblock Reprinted with corrections in 1996.
 
 
-\bibitem{38:ltnews} \LaTeX{} Project Team:
+\bibitem{38:ltnews} \LaTeX{} Project Team.
   \emph{\LaTeXe{} news 1--38}.\\
   \url{https://latex-project.org/news/latex2e-news/ltnews.pdf}
 
-\bibitem{38:blueprint} Frank Mittelbach and Chris Rowley:
+\bibitem{38:blueprint} Frank Mittelbach and Chris Rowley.
   \emph{\LaTeX{} Tagged PDF \Dash A blueprint for a large project}.\\
   \url{https://latex-project.org/publications/indexbyyear/2020/}