BUNDLEDOC(1) BUNDLEDOC(1) (NAME) bundledoc - LaTeX (SYNOPSIS) bundledoc [--version] [--help] [--[no]verbose] [--texfile=file.tex] [--directory=directory] [--[no]localonly] [--exclude=string] [--include=filespec] [--manifest=file] [--listdeps=[yes|no|only|rel]...] [--[no]keepdirs] [--config=file.cfg] file.dep.SH " (DESCRIPTION)" bundledoc snapshot LaTeX . .dep snapshot ( .tar.gz) . LaTeX hello.tex : \RequirePackage{snapshot} % Needed by bundledoc \documentclass[11pt]{article} \begin{document} Hello, world! \end{document} "\RequirePackage{snapshot}" hello.dep . "hello.dep" bundledoc -- snapshot.sty article.cls size11.clo -- hello.tex MANIFEST ( << (OPTIONS)>> ) . (OPTIONS) somefile LaTeX ( ) . bundledoc snapshot ( somefile.dep ). ( .dep .) : --version bundledoc . ( ). --help . . --[no]verbose (: "noverbose") bundledoc . "--verbose" . --texfile=main .tex file (: somefile.tex) snapshot LaTeX ( latex ) . bundledoc snapshot .tex . "--texfile" . --directory=archive directory (: somefile) bundledoc ( .tar .zip) . somefile.dep somefile . "--directory" . --[no]localonly (: "nolocalonly") bundledoc .dep "--localonly" bundledoc .tex () . --exclude=string (: none) "--localonly" .tex "--exclude" . "--exclude" string . --include=filespec (: none) "--include" bundledoc filespec .dep . --manifest=manifest file (: MANIFEST) bundledoc <> . MANIFEST . <> "--manifest" . "--manifest=""" bundledoc . --listdeps=[yes|no|only|rel]...] (: "no") "--listdeps" "yes" "no" "only" "rel" . "no" bundledoc LaTeX . "rel" bundledoc . "only" bundledoc . --[no]keepdirs (: "nokeepdirs") bundledoc -- -- . "--keepdirs" . somefile.tex figures/somefigure.eps article.cls snapshot.sty somefile : o somefile/somefile.tex o somefile/figures/somefigure.eps o somefile/article.cls o somefile/snapshot.sty o somefile/MANIFEST "--keepdirs" somefile : o home/me/mydocs/somefile.tex o home/me/mydocs/figures/somefigure.eps o usr/share/texmf/tex/latex/base/article.cls o usr/share/texmf/tex/latex/snapshot/snapshot.sty "--keepdirs" "--directory" . . --config=configuration file (: ) "--config" bundledoc (.cfg) TeX . bundledoc . << (CONFIGURATION FILES)>> ( ) . .cfg ..SH " (CONFIGURATION FILES)" (Format) . "#" . . : variable: value bundledoc : bundle sink find () TeX. "\" . bundledoc : "BDBASE" somefile ( << (OPTIONS)>> ) "BDINPUTS" . "bundle" "BDINPUTS" . "find" "BDINPUTS" . (Examples) bundledoc TeX kpathsea Unix GNU gzip tar GNU : # "Default" configuration file # By Scott Pakin bundle: (tar -cvf - $BDINPUTS | compress > $BDBASE.tar.Z) sink: > /dev/null 2>&1 find: kpsewhich -progname=latex $BDINPUTS "bundle:" Unix . "sink:" ( ">" ). "BDBASE" "BDINPUTS" Unix "$" . . TeX Windows "%BDBASE%" "%BDINPUTS%" . "sink:" . "find:" TeX . "bundle:" . "bundle:" . shar Unix : bundle: (shar --archive-name="$BDBASE" $BDINPUTS > $BDBASE.sh) CAB Microsoft Windows : bundle: cabarc -r -p N %BDBASE%.cab %BDINPUTS% (EXAMPLES) myfile.dep myfile.tex . .zip TeX (MikTeX) Microsoft Windows : bundledoc --config=miktex.cfg myfile.dep : bundledoc --config=miktex myfile .tar.gz TeX Live . bundledoc (verbose) . myfile.tex <<.fd>> <<.cfg>> . .bib myfile.dep . MANIFEST . bundledoc --config=texlive-unix.cfg --verbose --localonly \ --exclude=.fd --exclude=.cfg --include="*.bib" --manifest="" \ myfile.dep snapshot.sty . bundledoc . ( << (CONFIGURATION FILES)>> .) bundledoc : texlive-unix.cfg TeX Live Unix Linux. TeX Live TeX kpathsea Unix Microsoft Windows . texlive-unix.cfg gzip .tar.gz . bundledoc kpsewhich LaTeX . miktex.cfg MikTeX. MikTeX TeX Microsoft Windows . miktex.cfg zip .zip . bundledoc kpsewhich LaTeX MikTeX initexmf . texlive-unix-arlatex.cfg texlive-unix.cfg gzip arlatex . arlatex bundledoc .tex "filecontents" LaTeX . (NOTES) (Including and excluding files) "--localonly" "--exclude" "--include" . "--exclude" "--include" . bundledoc : 1. .dep . 2. "--localonly" .tex . 3. "--exclude" . 4. "--include" . Microsoft Windows (Issues When Running Under Microsoft Windows) bundledoc Perl Windows : o "perl bundledoc" o bundledoc bundledoc.pl "bundledoc.pl". ( .pl .) o pl2bat ( ) bundledoc bundledoc.bat "bundledoc". ( ) . . Windows "UNC" . UNC bundledoc . ! (Testing Status) bundledoc Perl v5.6.0 : o Linux + TeX Live o Linux + teTeX o Windows NT + MiKTeX o Solaris + ( kpathsea) bundledoc . bundledoc ..SS " (Future Work)" bundledoc TeX . <> ( OS X ) texlive-unix.cfg miktex.cfg <> bundledoc ( ). bundledoc TeX bundledoc . bundledoc . .tfm .mf .pfb .ttf . (Acknowledgments) Fabien Vignes-Tourneret "--localonly" "--exclude" "--include" Marius Kleiner bundledoc Frank Mittelbach Kpathsea .cfg .cfg .dep . (SEE ALSO) arlatex(1) gzip(1) kpsewhich(1) latex(1) perl(1) zip(1) snapshot (AUTHOR) Scott Pakin, scott+bdoc@pakin.org v3.5 2025-02-26 BUNDLEDOC(1)