CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/filecontents

README
            +--------------------------------------------+
            |                FILECONTENTS                |
            |                                            |
            | Improved version of LaTeX2e's filecontents |
            |       and filecontents* environments       |
            |                                            |
            |      By Scott Pakin, scott+fc@pakin.org    |
            +--------------------------------------------+


Description
-----------

LaTeX2e's filecontents and filecontents* environments enable a LaTeX
source file to generate external files as it's run through latex.
However, there are two limitations of these environments: They refuse
to overwrite existing files; and, they can be used only before the
\documentclass declaration.  The filecontents package removes these
limitations, making it possible to overwrite existing files and to use
filecontents/filecontents* anywhere.


Installation
------------

There's nothing special about building filecontents:

    latex filecontents.ins     <== Generate filecontents.sty
    latex filecontents.dtx     <== Produce the documentation (filecontents.dvi)

If you're new to this, see https://texfaq.org/#installing for more
information on installing packages.


Copyright and license
---------------------

Copyright (C) 2011-2023 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.3c 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.3c or later is part of all distributions of LaTeX
version 2008/05/04 or later.

Download the contents of this package in one zip archive (282.9k).

filecontents – Create an external file from within a document

’s filecontents and filecontents* environments enable a source file to generate external files as it runs through . However, there are two limitations of these environments: they refuse to overwrite existing files, and they can only be used in the preamble of a document. The filecontents package removes these limitations, letting you overwrite existing files and letting you use filecontents/filecontents* anywhere.

As of September 2019 the author tells us: “This package is no longer necessary due to its functionality having moved into recent kernels. It’s probably better not to move the package to obsolete because users may need it to rebuild old documents. Version 1.5 provides full functionality when run with an older kernel but issues a warning message and disables itself when run with a newer kernel.”

Supply the overwrite option to ’s built-in filecontents environment to mimic this package’s behavior:

\begin{filecontents}[overwrite]{my-file}...\end{filecontents}

Packagefilecontents
Version1.5a 2023-04-02
LicensesThe Project Public License 1.3c
Copyright2011–2023 Scott Pakin
MaintainerScott Pakin
Contained inTeX Live as filecontents
MiKTeX as filecontents
TopicsFile management
...
Guest Book Sitemap Contact Contact Author