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

SYNOPSIS
   latexpand [options] FILE...

 Options:
           --verbose        show what's going on
           --keep-comments  don't strip comments (comments are lines
                            starting with %, and anything below
                            \end{document})
           --empty-comments keep empty comments (i.e. % at end of lines) for clarity
           --keep-includes  don't expand \input and \include directives
           --expand-usepackage
                            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
                            biber+biblatex).
           --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
           --graphics_extensions
                            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.
                            Example:
                            --in-encoding 'encoding(UTF-8)'
                            The default is 'bytes' and should always work.

USES
   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.

GETTING LATEXPAND
   The latest version of latexpand is available here:

     https://gitlab.com/latexpand/latexpand

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

     http://www.ctan.org/pkg/latexpand

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

     https://gitlab.com/latexpand/latexpand/issues

 Known bugs
  Verbatim
   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

           foo%
           \begin{comment}

   will produce the incorrect

           foo\begin{comment}

   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,
   like

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

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

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

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

   https://lacl.fr/~caubert/notes/portabilite-du-tex.html#dependances

VERSION
   This is latexpand version v1.7.2.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.