TeX Live Package Contributions

This page gives some information about contributing packages to TeX Live (TL), and ways to make integrating your package easier for the TL maintainers.

First, the package must be free (as in freedom) software, available under, for example, the LaTeX Project Public License or GNU General Public License. Please state this explicitly in your package's README and/or other documentation, as well as in the source. Those licenses (and others) contain instructions for how to apply them to your code. The licensing conditions for TeX Live go into more detail.

The source for any generated documentation files (e.g., pdf) must also be available for the generated documentation to be included in TeX live. (We won't refuse to install the package itself, but we must refrain from installing documentation when there is no source. Free documentation is as important as free software.)

Next, virtually all TL packages come from CTAN. This is by far the easiest place to update from. So, if you haven't uploaded your package to CTAN, please do that. (Aside from TL, it's a good thing in general for CTAN to hold as much as possible.)

TeX-world packages - normal

Standard (La)TeX packages with a .ins file, .dtx, README, etc., don't need any special treatment; they can just have all the files at the top level. The TL scripts more or less automatically translate the CTAN package into the TDS arrangement used in TL.

Special case: if you are distributing LaTeX package containing any .tex files which should be installed in the tex/ subtree (that is, are not documentation), please be sure and state this in your README and ideally in the package announcement as well.

TeX-world packages - advanced

Many packages are more complex. If your package has many files in many different places, it is easiest to include TL if you distribute it as subdirectories of a texmf/ tree, with your files in the TDS places. Then all the scripts have to do is copy your tree. (See, for example, the lm and vntex packages.)

As a rule of thumb for LaTeX packages, only .dtx and .ins files go in source/; general auxiliary files can go in doc/. For packages that include fonts, please include .tfm files and .map files.

Packages with executable programs

If your package includes source files that actually have to be compiled into binary executables, such as C or C++, it is by far best to use the GNU configuration standards, typically via Autoconf or Automake. In particular, building in a directory other than the source directory (a standard feature of the GNU autotools), must be supported, as it is our standard build method.

Also, if your program needs to search for files, please use Kpathsea to find them. If your package is written in a script language such as Perl or Python and needs to search for files, you can use the kpsewhich executable.

Finally, please make any executables do something reasonable with the options --help and --version. Again, see the GNU standards.

If you have questions or suggestions, please email tex-live@tug.org.


$Date: 2008/08/15 00:43:00 $; TeX Live;