summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/filecontents/filecontents.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/filecontents/filecontents.dtx')
-rw-r--r--macros/latex/contrib/filecontents/filecontents.dtx48
1 files changed, 35 insertions, 13 deletions
diff --git a/macros/latex/contrib/filecontents/filecontents.dtx b/macros/latex/contrib/filecontents/filecontents.dtx
index 40ad96f26d..372a96166d 100644
--- a/macros/latex/contrib/filecontents/filecontents.dtx
+++ b/macros/latex/contrib/filecontents/filecontents.dtx
@@ -1,6 +1,6 @@
% \iffalse meta-comment
%
-% Copyright (C) 2001-2019 Scott Pakin <scott+fc@pakin.org>
+% Copyright (C) 2001-2023 Scott Pakin <scott+fc@pakin.org>
% --------------------------------------------------------
%
% This package may be distributed and/or modified under the
@@ -22,12 +22,13 @@
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{filecontents}
%<*package>
- [2019/09/20 v1.5 Create an external file from within a LaTeX document]
+ [2023/04/02 v1.5a Create an external file from within a LaTeX document]
%</package>
%
%<*driver>
\documentclass{ltxdoc}
\usepackage{color}
+\usepackage{microtype}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
@@ -69,6 +70,7 @@
% \changes{v1.1a}{2006/03/11}{%
% Clarified/corrected the \texttt{\string\string\string\documentclass}
% restriction as per Robin Fairbairns's suggestion}
+% \changes{v1.5a}{2023/04/02}{Documentation updates; no code changes}
%
% ^^A The following were copied verbatim from source2e.tex.
% \DoNotIndex{\def,\long,\edef,\xdef,\gdef,\let,\global}
@@ -124,19 +126,38 @@
% }^^A
% }
%
+% \newsavebox{\obsoletenotice}
+% \begin{lrbox}{\obsoletenotice}
+% \begin{minipage}[t]{0.75\linewidth}
+% \color{red}
+% \centerline{\textsc{Notice}}
+% \smallskip
+% The version of \LaTeX\ released in Fall 2019 incorporates all of
+% this package's functionality (and more) into the \LaTeX\ kernel
+% itself. As a result, there is no longer a need for the
+% |filecontents| package. Please use instead the new, built-in
+% |filecontents| environment. Supply the |overwrite| option to
+% mimic this package's behavior:
+%
+% \bigskip
+% \quad
+% \begin{tabular}[t]{@{}l@{}}
+% |\begin{filecontents}[overwrite]{|\meta{filename}|}| \\
+% \multicolumn{1}{@{}c@{}}{$\vdots$} \\
+% |\end{filecontents}|
+% \end{tabular}
+% \bigskip
+%
+% See
+% \href{https://www.latex-project.org/news/latex2e-news/ltnews30.pdf}{^^A
+% \LaTeXe\ News, Issue 30} (1-Oct-2019) for the announcement of the
+% new kernel functionality.
+% \end{minipage}
+% \end{lrbox}
+%
% \begin{center}
% \color{red}
-% \fbox{^^A
-% \begin{minipage}{0.75\linewidth}
-% \centerline{\textsc{Notice}}
-% \smallskip
-% The version of \LaTeX\ released in Fall 2019 incorporates all of
-% this package's functionality (and more) into the \LaTeX\ kernel
-% itself. As a result, there is no longer a need for the
-% |filecontents| package. Please use the new, built-in
-% |filecontents| environment instead.
-% \end{minipage}^^A
-% }
+% \fbox{\usebox{\obsoletenotice}}
% \end{center}
%
%
@@ -227,6 +248,7 @@
%
% \StopEventually{^^A
% \PrintChanges
+% \clearpage
% \PrintIndex
% }
%