[latex3-commits] [git/LaTeX3-latex3-latex2e] gh920: ltnews entry (1f92e615)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : gh920
Link       : https://github.com/latex3/latex2e/commit/1f92e61503d7f865e5f6a893f8e6ebb2bfc5847f

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

commit 1f92e61503d7f865e5f6a893f8e6ebb2bfc5847f
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Wed Nov 9 19:20:50 2022 +0100

    ltnews entry


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

1f92e61503d7f865e5f6a893f8e6ebb2bfc5847f
 base/doc/ltnews37.tex | 24 ++++++++++++++++++++++++
 base/ltshipout.dtx    |  2 +-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/base/doc/ltnews37.tex b/base/doc/ltnews37.tex
index 3c686dc4..f1622515 100644
--- a/base/doc/ltnews37.tex
+++ b/base/doc/ltnews37.tex
@@ -159,6 +159,26 @@
 \githubissue{943}
 
 
+\subsection{A further hook for shipping out pages}
+
+Since October 2020 the shipout process offers a number of hooks to
+adjust what is happening before, during, and after the
+\cs{shipout}. For example, with the \hook{shipout/before} hook packages
+can reset code they have altered (e.g., \cs{catcode}s during verbatim
+like processing) and with \hook{shipout/background} and
+\hook{shipout/foreground} some material could be added to every
+page. Details are given in \cite{37:ltshipout-doc}. However, what was
+missing was a hook that allows a package writer to manipulate the
+complete page (with foreground and background attached) just before
+the actual shipout happens.
+
+For this we now provide the additional hook \hook{shipout}. One
+use case (sometimes needed in print production) is to mirror the
+whole page via \cs{reflectbox} including all the extra data that may
+have been added into the fore- or background.
+%
+\githubissue{920}
+
 
 
 \subsection{Displaying release information in the \texttt{.log}}
@@ -214,6 +234,10 @@ eventually be moved into \pkg{unicode-math}.
 
 \fontsize{9.3}{11.3}\selectfont
 
+\bibitem{37:ltshipout-doc} Frank Mittelbach, \LaTeX{}~Project~Team:
+  \emph{The \texttt{\upshape ltshipout} documentation}.\\
+  Run \texttt{texdoc} \texttt{ltshipout-doc} to view.
+
 %\bibitem{37: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/}
diff --git a/base/ltshipout.dtx b/base/ltshipout.dtx
index 24e47935..7a9cdaa2 100644
--- a/base/ltshipout.dtx
+++ b/base/ltshipout.dtx
@@ -75,7 +75,7 @@
 % \providecommand\pkg[1]{\texttt{#1}}
 %
 %
-% \title{The \texttt{ltshipout} package\thanks{This package has version
+% \title{The \texttt{ltshipout} documentation\thanks{This file has version
 %    \ltshipoutversion\ dated \ltshipoutdate, \copyright\ \LaTeX\
 %    Project.}}
 %