[latex3-commits] [git/LaTeX3-latex3-latex2e] gh917+958: documentation updates (57f7ec40)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : gh917+958
Link       : https://github.com/latex3/latex2e/commit/57f7ec4085047969169088e3050bb690a1bdbcc6

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

commit 57f7ec4085047969169088e3050bb690a1bdbcc6
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Wed Nov 16 16:28:14 2022 +0100

    documentation updates


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

57f7ec4085047969169088e3050bb690a1bdbcc6
 base/changes.txt      |  6 ++++++
 base/doc/ltnews37.tex | 17 +++++++++++++++++
 base/ltclass.dtx      |  6 +++++-
 3 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/base/changes.txt b/base/changes.txt
index 10dd3636..bf417774 100644
--- a/base/changes.txt
+++ b/base/changes.txt
@@ -11,6 +11,12 @@ All changes above are only part of the development branch for the next release.
 ================================================================================
 
 
+2022-11-16  Frank Mittelbach  <Frank.Mittelbach at latex-project.org>
+
+	* ltclass.dtx:
+	Introduce key 'silent' on filecontents (gh/958)
+	Do not show "current dir" in message (gh/917)
+
 2022-11-13  Frank Mittelbach  <Frank.Mittelbach at latex-project.org>
 
 	* doc.dtx:
diff --git a/base/doc/ltnews37.tex b/base/doc/ltnews37.tex
index f22a0be5..bac0d96c 100644
--- a/base/doc/ltnews37.tex
+++ b/base/doc/ltnews37.tex
@@ -194,6 +194,23 @@ desired effect.
 \githubissue{953}
 
 
+\subsection{New key for \env{filecontents}}
+
+The \env{filecontents} environment warns on the terminal if a file
+gets overwritten even if that is intentional,
+e.g., when you write a temporary file over and over again.  To make
+the warning less noisy in this case we added a new \texttt{silent} key
+that redirects the overwriting warning to the transcript file. We
+think that some record of the action is still required to help with
+debugging, thus it is not completely silenced. The warning that
+nothing gets written, because the file aready exists (and the
+\texttt{force} key was not used), is not altered and still shows up on
+the terminal.
+%
+\githubissue{958}
+
+
+
 \subsection{A further hook for shipping out pages}
 
 Since October 2020 the shipout process offers a number of hooks to
diff --git a/base/ltclass.dtx b/base/ltclass.dtx
index 3221ee51..3c0d112d 100644
--- a/base/ltclass.dtx
+++ b/base/ltclass.dtx
@@ -33,7 +33,7 @@
 %<*driver>
 % \fi
 \ProvidesFile{ltclass.dtx}
-             [2022/10/22 v1.5e LaTeX Kernel (Class & Package Interface)]
+             [2022/11/16 v1.5f LaTeX Kernel (Class & Package Interface)]
 % \iffalse
 \documentclass{ltxdoc}
 \GetFileInfo{ltclass.dtx}
@@ -2813,6 +2813,7 @@
 %    unknown option.
 % \changes{v1.3h}{2020/01/28}{Allow spaces in option string and display
 %     only unknown options not the whole option list (gh/256)}
+% \changes{v1.5f}{2022/11/16}{Introduce key 'silent' on filecontents (gh/958)}
 %    \begin{macrocode}
 \def\filec at ntents@opt[#1]{%
   \edef\@fortmp{\zap at space#1 \@empty}%
@@ -2851,6 +2852,7 @@
 %    \end{macrocode}
 %    Option \texttt{silent} does not show any warning on the terminal
 %    but still writes it to the \texttt{.log}.
+% \changes{v1.5f}{2022/11/16}{Introduce key 'silent' on filecontents (gh/958)}
 %    \begin{macrocode}
 \def\filec at ntents@silent{%
   \let\filec at ntents@warning\@latex at note@no at line
@@ -2936,6 +2938,8 @@
 %    on the terminal.
 % \changes{v1.3g}{2020/01/27}{Fix typo in error message}
 % \changes{v1.3j}{2020/02/20}{Fix missing quotes around file name (gh/284)}
+% \changes{v1.5f}{2022/11/16}{Introduce key 'silent' on filecontents (gh/958)}
+% \changes{v1.5f}{2022/11/16}{Do not show "current dir" in message (gh/917)}
 %    \begin{macrocode}
       \ch at ck7\reserved at c\write\relax%
       \if at filesw%  % Foul ... trying to overwrite \jobname!