diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/filecontents')
-rw-r--r-- | Master/texmf-dist/source/latex/filecontents/filecontents.dtx | 54 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/filecontents/filecontents.ins | 32 |
2 files changed, 52 insertions, 34 deletions
diff --git a/Master/texmf-dist/source/latex/filecontents/filecontents.dtx b/Master/texmf-dist/source/latex/filecontents/filecontents.dtx index 730a9615d3c..09c421bc605 100644 --- a/Master/texmf-dist/source/latex/filecontents/filecontents.dtx +++ b/Master/texmf-dist/source/latex/filecontents/filecontents.dtx @@ -1,15 +1,17 @@ % \iffalse meta-comment % -% Copyright (C) 2004 Scott Pakin <scott+fc@pakin.org> +% Copyright (C) 2006 Scott Pakin <scott+fc@pakin.org> % ------------------------------------------------------- % % This package may be distributed and/or modified under the -% conditions of the LaTeX Project Public License, either version 1.2 +% conditions of the LaTeX Project Public License, either version 1.3b % of this license or (at your option) any later version. % The latest version of this license is in +% % http://www.latex-project.org/lppl.txt -% and version 1.2 or later is part of all distributions of LaTeX -% version 1999/12/01 or later. +% +% and version 1.3b or later is part of all distributions of LaTeX +% version 2006/01/07 or later. % % \fi % @@ -20,11 +22,12 @@ %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01] %<package>\ProvidesPackage{filecontents} %<*package> - [2004/08/16 v1.1 Create an external file from within a LaTeX document] + [2006/03/11 v1.1a Create an external file from within a LaTeX document] %</package> % %<*driver> \documentclass{ltxdoc} +\input{filecontents.inc} \EnableCrossrefs \CodelineIndex \RecordChanges @@ -63,6 +66,9 @@ % \maketitle % % \changes{v1.0}{2001/07/31}{Initial version} +% \changes{v1.1a}{2006/03/11}{% +% Clarified/corrected the \texttt{\string\string\string\documentclass} +% restriction as per Robin Fairbairns's suggestion} % % ^^A The following were copied verbatim from source2e.tex. % \DoNotIndex{\def,\long,\edef,\xdef,\gdef,\let,\global} @@ -84,10 +90,10 @@ % % ^^A The following are specific to filecontents.dtx. % \DoNotIndex{\@currenvir,\@gobble,\@gobblefour,\@ifundefined,\@makeother} -% \DoNotIndex{\@undefined,\day,\do,\E,\end,\I,\if@tempswa,\L,\LaTeX,\loop} -% \DoNotIndex{\MessageBreak,\month,\newenvironment,\number,\repeat} -% \DoNotIndex{\reserved@b,\reserved@c,\two@digits,\year} -% \DoNotIndex{\*,\^} +% \DoNotIndex{\@undefined,\active,\chardef,\day,\do,\dospecials,\E,\end,\I} +% \DoNotIndex{\if@tempswa,\L,\LaTeX,\loop,\MessageBreak,\month} +% \DoNotIndex{\newenvironment,\number,\repeat,\reserved@b,\reserved@c} +% \DoNotIndex{\two@digits,\year,\*,\^} % % ^^A Define some commands to help delineate my changes. % \newcommand{\startfcchanges}{^^A @@ -145,18 +151,26 @@ % into the file. % \end{quotation} % +% \noindent +% (The comment about |filecontents| being valid only before +% |\documentclass| is, in fact, untrue. |filecontents| is allowed +% anywhere in the document's preamble.) +% +% \bigskip +% % The \textsf{filecontents} package provides a hacked-up version of the % |filecontents| and |filecontents*| environments that lifts the two % restrictions stated above, namely that existing files are never % overwritten and that |filecontents| must be used before the -% |\documentclass| declaration. \textsf{filecontents} is therefore a -% more convenient way to write external files from within a \LaTeX\ -% document than is provided by default by the \LaTeXe\ kernel. +% |\documentclass| declaration (really, the |\begin{document}|). +% \textsf{filecontents} is therefore a more convenient way to write +% external files from within a \LaTeX\ document than is provided by +% default by the \LaTeXe\ kernel. % % % \paragraph{Sample usage} % |filecontents| works much like |verbatim|, except that it takes -% a (mandatory) filename argument: +% a mandatory filename argument: % % \begin{verbatim} % \begin{filecontents}{myfile.tex} @@ -184,16 +198,16 @@ % |filecontents*| is therefore useful for writing non-\LaTeX\ files such as % Encapsulated PostScript files. % -% If you use the \textsf{ltxtable} package, you may find +% If you use the \textsf{ltxtable} package you may find % \textsf{filecontents} particularly useful. \textsf{ltxtable} is a % crude conglomeration of \textsf{longtable}, which allows tables to % cross page boundaries, and \textsf{tabularx}, which enables tables to % stretch to a specified width. \textsf{ltxtable}'s interface is a bit % cumbersome, however; it requires that the |longtable| environment be -% contained in a separate file. With the \textsf{filecontents} package, -% you can create this file right before the |\LTXtable| invocation, -% which is far more convenient than having to place the table manually -% within a separate file. +% contained in a separate file. With the \textsf{filecontents} package +% you can create this file right before the |\LTXtable| invocation---a +% far more convenient alternative than having to manually place the +% table within a separate file. % % % \StopEventually{^^A @@ -237,8 +251,8 @@ % \end{macrocode} % % \startfcchanges -% In the original code, a pre-existing file would not be overwritten. -% In the new version, the file existence check is used solely to decide +% In the original code a pre-existing file would not be overwritten. +% In the new version the file existence check is used solely to decide % whether to output ``\texttt{Writing file `\textrm{\meta{filename}}'}'' % or ``\texttt{Overwriting file `\textrm{\meta{filename}}'}''. Control % flow then always falls through to what used to be the |\ifeof| case diff --git a/Master/texmf-dist/source/latex/filecontents/filecontents.ins b/Master/texmf-dist/source/latex/filecontents/filecontents.ins index a88cd8a68d3..5800b1bfd20 100644 --- a/Master/texmf-dist/source/latex/filecontents/filecontents.ins +++ b/Master/texmf-dist/source/latex/filecontents/filecontents.ins @@ -3,16 +3,18 @@ %% driver files from the doc files in this package when run through %% LaTeX or TeX. %% -%% Copyright (C) 2004 Scott Pakin <scott+fc@pakin.org> +%% Copyright (C) 2006 Scott Pakin <scott+fc@pakin.org> %% ------------------------------------------------------- %% -%% This package may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.2 -%% of this license or (at your option) any later version. -%% The latest version of this license is in +%% This package may be distributed and/or modified under the conditions +%% of the LaTeX Project Public License, either version 1.3b of this +%% license or (at your option) any later version. The latest version of +%% this license is in +%% %% http://www.latex-project.org/lppl.txt -%% and version 1.2 or later is part of all distributions of LaTeX -%% version 1999/12/01 or later. +%% +%% and version 1.3b or later is part of all distributions of LaTeX +%% version 2006/01/07 or later. %% %% --------------- start of docstrip commands ------------------ %% @@ -26,16 +28,18 @@ This is a generated file. -Copyright (C) 2004 Scott Pakin <scott+fc@pakin.org> +Copyright (C) 2006 Scott Pakin <scott+fc@pakin.org> ------------------------------------------------------- -This package may be distributed and/or modified under the -conditions of the LaTeX Project Public License, either version 1.2 -of this license or (at your option) any later version. -The latest version of this license is in +This package may be distributed and/or modified under the conditions +of the LaTeX Project Public License, either version 1.3b of this +license or (at your option) any later version. The latest version of +this license is in + http://www.latex-project.org/lppl.txt -and version 1.2 or later is part of all distributions of LaTeX -version 1999/12/01 or later. + +and version 1.3b or later is part of all distributions of LaTeX +version 2006/01/07 or later. \endpreamble |