File: README.source

package info (click to toggle)
troffcvt 1.04-21
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd, wheezy
  • size: 2,232 kB
  • ctags: 27
  • sloc: makefile: 158
file content (41 lines) | stat: -rw-r--r-- 1,469 bytes parent folder | download | duplicates (5)
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.