summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/filecontents
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/filecontents')
-rw-r--r--Master/texmf-dist/source/latex/filecontents/filecontents.dtx54
-rw-r--r--Master/texmf-dist/source/latex/filecontents/filecontents.ins32
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