NAME
   texdirflatten - Collects all components of a (La)TeX file in a single
   output directory -- i.e., flattens its hierarchy.

SYNOPSIS
   texdirflatten [-1|--onetex] [-f|--file input.tex] [-o outputdir]
   [--imgexts .ext1,.ext2,...] [--debug] [-V|--version] [-?|--help]

DESCRIPTION
   This Perl script parses a LaTeX file recursively, scanning all child
   files, and collects details of any included and other data files, such
   as graphics and BiBTeX bibliography files. These component files, are
   then all put into a single directory (thus "flattening" the document's
   directory tree). This is useful in distributing manuscripts to
   collaborators or in submitting to journals.

OPTIONS
   --file, -f *input.tex*
       Specifies input (La)TeX file.

   --onetex, -1
       If specified, produces a single TeX file by expanding all \input and
       \include commands in place.

   --output, -o *outputdir*
       Directory to collect all files. texdirflatten will copy each source
       file, graphics and bibliography file to this directory. It will be
       created if it is unexistent. If unspecified, it defaults to "flat/".

   --imgexts *.ext1,.ext2[,...]*
       Prepends to the prioritized list of image extensions to search when
       trying to find the image to copy to output folder. The first file
       with the extension found will be copied and search stopped. Default
       order is "", ".eps", ".pdf", ".pstex" (note that it includes files
       with no extension). If using pdflatex, one may want to add PDF
       before EPS with "--imgexts .pdf". Don't forget the dot before the
       extension!

   --debug
       Enables copious amounts of debugging output - useful if something is
       going wrong.

   --version, -V
       Displays the current version number and the usage and exits.

   --help, -?
       Show this manual page.

EXAMPLES
   The following example scans "manuscript.tex" in the current directory
   and gathers it and all its components in the "submit_01/" directory:

    $ texdirflatten -f manuscript.tex -o submit_01

CAVEATS
   Please take backups before running this command. No warranties
   whatsoever provided.

   You may need to run "epstopdf" on EPS files if you are using "pdflatex":

    $ for i in *.eps; do epstopdf $i; done

BUGS
   Bug reports and patches are welcome.

AUTHOR
   Cengiz Gunay <cengique<AT>users.sf.net>

COPYRIGHT AND LICENSE
   Copyleft 2003-2017, Cengiz Gunay

   This library is free software; you may redistribute it and/or modify it
   under the same terms as Perl itself.