troffcvt source package handling
================================

troffcvt is shipped by upstream as several tarballs, resulting in a rather
arcane source package.

This is rather a mess, and should be redone with a packaged system instead
of rolling our own.

Generating fully-patched source
-------------------------------

  debian/rules patch

This produces the source code, in the form that will be built, under a
collection of SUBPACKAGE or SUBPACKAGE-VERSION directories.

Making source modifications
---------------------------

To make modifications to the source code, first take a copy of the
subpackage (e.g. 'cp -a troffcvt-1.04 troffcvt-1.04.orig'), edit the files
in the unpacked subpackage directory, and then run 'diff -Nurp
troffcvt-1.04.orig troffcvt-1.04 > patches/NAME.diff' (or similar) to save
the patch for later application. NAME *must* be identical to the name of the
subpackage directory (e.g. emt or troffcvt-1.04).

Remove the .orig directory when you're finished.

Removing source modifications
-----------------------------

Simply remove the file under patches/, or move it to a different location.

Upgrading to a new upstream version
-----------------------------------

Replace the tarballs in tarballs/, adjust patches/* as necessary, construct
a new .orig.tar.gz consisting of just the tarballs/ directory (compare the
construction of the current .orig.tar.gz) and bump the upstream part of the
version number in debian/changelog.
