CTAN Comprehensive TeX Archive Network

Directory support/latexpand

    latexpand - Flatten LaTeX file by expanding \include and \input, ... and
    remove comments

    latexpand [options] FILE...

            --verbose        show what's going on
            --keep-comments  don't strip comments (comments are lines
                             starting with %, and anything below
            --empty-comments keep empty comments (i.e. % at end of lines) for clarity
            --keep-includes  don't expand \input and \include directives
                             Expand \usepackage{...} directives if the
                             corresponding .sty file is found in
                             $TEXINPUTS (or the current directory if
                             $TEXINPUTS is not set)
            --expand-bbl FILE
                             Expand the bibliography by inlining FILE
                             (should be a *.bbl file)
            --biber FILE     Include \bibliography{} with FILE's content,
                             as needed by biblatex with the biber backend.
                             (similar to --expand-bbl FILE, but for
            --help           this help message
            --define <key>=<val>, -d <key>=<val>
                             defines a macro key to be replaced by value, e.g.,
                             when called with -d foo=bar would replace all occurences
                             of \foo in the code with bar. Can be supplied multiple times.
            --output <file>, -o <file>
                             generate output in <file>
            --explain        generate explanatory comments in output
            --show-graphics  show included graphics
                             colon-separated list of possible graphics extensions
                             (used by --show-graphics to find the actual graphics files)
            --fatal          Die in case a file can't be found.
            --makeatletter   Insert a \makeatletter in the preamble. In some
                             rare cases it may break your document, but it
                             may help fixing bad interactions between
                             @-commands and inclusion (see BUGS section).
            --in-encoding FMT, --out-encoding FMT
                             File encoding used by input and output files.
                             This uses the same syntax as PerlIO's layers.
                             --in-encoding 'encoding(UTF-8)'
                             The default is 'bytes' and should always work.

    The most common use of latexpand is to simplify distribution of source
    LaTeX files, typically to satisfy the requirement of editors and
    archival sites (springer, arXiv.org, ...) who force the authors to
    submit sources. One does not necessarily want to submit sources with
    comments, and uploading a document made of several files including each
    other is a bit painful. By default, latexpand answers both problems by
    outputing a single LaTeX file that contain no comment.

    The latest version of latexpand is available here:


    Versions are uploaded to ctan.org from time to time:


    Please, report bugs on the issue tracker on the project site:


  Known bugs
    latexpand currently ignores \begin{verbatim} ... \end{verbatim}, and
    will therefore process any \include, \input, ... directives that appear
    within verbatim environments (while it shouldn't).

    LaTeX comments inside verbatim environments are also incorrectly
    stripped. You can use --keep-comments as a workaround to avoid this.

   Comment environment
    It would be nice to remove code between \begin{comment} and
    \end{comment} too if \usepackage{comment} is used.

    Code like


    will produce the incorrect


    A workaround is to use --empty-comments when such tricky usage of the
    comments package is done.

   \makeatletter and use with transfig/xfig with \scalebox{}
    If \input{} or \include{} appears as argument to a command, and the file
    included contains \makeatletter, then after expansion, the \makeatletter
    and the @-command appear as argument to the command, which is forbidden
    because the argument is parsed (and the @-command badly tokenized)
    before being executed.

    This happens with

            \scalebox{ \input{file-generated-by-xfig.pdf_t} }

    Workaround: add \makeatletter before the scalebox manually in your code,

            \scalebox{ \input{file-generated-by-xfig.pdf_t} }

    In the case of xfig generated files, it is necessary only for the first

    A more brute-force workaround is to use latexpand --makeatletter.

    Instructions to include only the relevant .bib items (french):


    This is latexpand version v1.7.2.

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

latexpand – Expand \input and \include in a document

Latexpand is a Perl script that simply replaces \input and \include commands with the content of the input or included file. The script does not deal with \includeonly commands.

Version1.7.2 2023-02-27
Licenses3-clause BSD License
Copyright2012–2023 Matthieu Moy
MaintainerMatthieu Moy
Matthew Lovell (inactive)
David J. Musliner (inactive)
Contained inTeX Live as latexpand
MiKTeX as latexpand
TopicsFile management
Guest Book Sitemap Contact Contact Author