Menu
CTAN
Comprehensive TeX Archive Network
Home Upload Browse

Direc­tory tex-archive/support/bundledoc

       #########################################################
       # Bundle all the files needed to build a LaTeX document #
       # By Scott Pakin, scott+bdoc@pakin.org                  #
       #########################################################


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

bundledoc is a post-processor for the snapshot package that bundles
together all the classes, packages, and files needed to build a given
LaTeX document.  It reads the .dep file that snapshot produces, finds
each of the files mentioned therein, and archives them into a single
.tar.gz (or .zip, or whatever) file, suitable for moving across
systems, transmitting to a colleague, etc.

As an added bonus, this distribution includes a small script called
arlatex.  arlatex is a LaTeX-specific archiving program that combines
a bunch of files into a single .tex file.  When the .tex file is run
through latex, all of the original files are recreated and the LaTeX
document is built.  bundledoc can be easily configured to use arlatex
as its archiver in place of tar, zip, etc.


Files
-----

-rwxrwxr-x 1 pakin users  9595 May  1 15:24 arlatex
-rw-rw-r-- 1 pakin users 10063 May  2 08:06 arlatex.1
-rw-rw-r-- 1 pakin users  9551 May  2 08:06 arlatex.pdf
-rwxrwxr-x 1 pakin users 28763 May  2 07:57 bundledoc
-rw-rw-r-- 1 pakin users 22574 May  2 08:06 bundledoc.1
-rw-rw-r-- 1 pakin users 21959 May  2 08:06 bundledoc.pdf
-rw-rw-r-- 1 pakin users   344 Mar 11  2006 miktex.cfg
-rw-rw-r-- 1 pakin users  4361 May  2 08:06 README
-rw-rw-r-- 1 pakin users   230 Apr  9  2010 texlive-unix.cfg


Requirements
------------

bundledoc and arlatex are both Perl scripts, so you naturally need
Perl installed on your system.  bundledoc relies on the snapshot
package, which is available from CTAN (http://www.ctan.org).  Before
running bundledoc, you must have used snapshot to produce a dependency
list for your document.  Finally, bundledoc requires that you have
some program for archiving a bunch of files into a single file
(e.g. tar, shar, zip, or arlatex) and some program that can search
your TeX tree(s) for a given file (e.g., kpsewhich or initexmf).


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

Installation is fairly flexible.  The bundledoc and arlatex scripts
should be put somewhere in your executable search path (e.g.,
/usr/local/bin on a typical Unix-like system).  The Unix man pages,
bundledoc.1 and arlatex.1, should be put in the corresponding man
directory (e.g., /usr/local/man/man1) -- or discarded, if you're not
on a Unix-like system and therefore have no interest in having a man
page.

The *.cfg files can go anywhere -- just don't forget where you put
them. ;-)  I guess I'd recommend .../texmf/tex/latex/bundledoc (where
"..." is /usr/share or wherever your TeX tree is rooted), assuming
your TeX distribution follows the TDS directory structure (meaning, it
*has* a .../texmf/tex/latex directory).

bundledoc.pdf and arlatex.pdf are pretty-printed PDF versions of
bundledoc.1 and arlatex.1 and can also go anywhere.  If you want
printed documentation, these PDF files will give the nicest results.
Just note that they're formatted for U.S. Letter-sized paper, so you
may need to scale them slightly to print on A4 paper.

Note that it's possible to produce documentation in other formats.
The bundledoc and arlatex scripts contain documentation in POD format.
You can therefore extract the documentation into your favorite format --
LaTeX, HTML, plain text, etc. -- using the various pod2*** tools that
come with Perl.


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

    bundledoc
    Copyright (C) 2011 Scott Pakin

    This program 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.

    This program consists of the file bundledoc and all the files listed
    in the Files section of the associated README file.

The license basically says that you can do whatever you want with
bundledoc, as long as you give me credit for writing it.  Also, if you
modify any of the files, you have to call your modified version
something other than "bundledoc".

Files

Name Size Date Notes
README 4361 2011-05-02 04:06:13
arlatex 9595 2011-05-01 11:24:29
arlatex.1 10063 2011-05-02 04:06:12
arlatex.pdf 9551 2011-05-02 04:06:13
bundledoc 28763 2011-05-02 03:57:07
bundledoc.1 22574 2011-05-02 04:06:11
bundledoc.pdf 21959 2011-05-02 04:06:12
miktex.cfg 344 2006-03-12 02:44:08
texlive-unix.cfg 230 2010-04-10 12:45:19

Down­load the con­tents of this pack­age in one zip archive (52.8k).

bun­dle­doc – Bun­dle to­gether all the files needed to build a LaTeX doc­u­ment

The bun­dle­doc pack­age is a post-pro­ces­sor for the snap­shot pack­age that bun­dles to­gether all the classes, pack­ages and files needed to build a given LaTeX doc­u­ment. It reads the .dep file that snap­shot pro­duces, finds each of the files men­tioned therein, and archives them into a sin­gle .tar.gz (or .zip, or what­ever) file, suit­able for mov­ing across sys­tems, trans­mit­ting to a col­league, etc.

A script, ar­la­tex, pro­vides an al­ter­na­tive “archiv­ing” mech­a­nism, cre­at­ing a sin­gle LaTeX file that con­tains all of the an­cil­lary files of a LaTeX doc­u­ment, to­gether with the doc­u­ment it­self, us­ing the file­con­tents* en­vi­ron­ment.

Doc­u­men­ta­tion
Ver­sion3.1
Li­censeThe LaTeX Project Public Li­cense
Main­tainerScott Pakin
Con­tained inTeXlive as bun­dle­doc
MikTeX as bun­dle­doc
Topics pack files up for dis­tri­bu­tion or archiv­ing
Guest Book Sitemap Contact 2014-04-23 13:26 CEST