1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41
|
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.
|