File: README.source

package info (click to toggle)
cjk 4.8.2%2Bgit20090105-5
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 5,016 kB
  • ctags: 553
  • sloc: lisp: 12,038; sh: 3,626; ansic: 2,523; perl: 1,816; makefile: 360
file content (44 lines) | stat: -rw-r--r-- 1,863 bytes parent folder | download
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
42
43
44
cjk for Debian
--------------

1. Getting the source file
--------------------------

The upstream source tarball is created each time you build the package using the
`get-orig-source' target in debian/rules.  This target will look at the `debian/
changelog' file and use the ISO date that is provided in the package version
numbering.

For instance, if the first line of the Debian changelog files looks like:
cjk (4.8.2+git20090105-1) unstable; urgency=medium
then it will strip off `4.8.2+git' and `-1' from the version, so you get the
date `20090105'.

The `get-orig-source' target will now transform that date into Unix time, and
use this to fetch a tarball from the upstream GIT server up to 5 January 2009.

You may ask yourself why I bother using this mechanism.  I find it often quite
cumbersome to recreate the original source tarball for each and every release.
There are naming conventions to abide by, and I keep forgetting them.  Hence
this system in which I just have to modify the Debian version in the changelog
to get an updated upstream tarball, completely according to the conventions that
apply on Debian.


2. Patching
-----------

The Debian source package of `cjk' uses dpatch as patching mechanism.

In debian/patches you have a `00list' file in which you define all the dpatch
files that need to be applied at build time.  The .dpatch files themselves are
just diff files with a few extra header files on top, e.g. a few descriptive
lines, author, etc.

To add a patch, simply rename your diff file with a .dpatch suffix, add the
header files on top, and add the filename to the `00list' file.

Be careful that the diff line numbering is based on the original upstream
source and possible patches from dpatch files that come earlier in the chain.

 -- Danai SAE-HAN (韓達耐) <danai.sae-han@edpnet.be>, Tue, 25 Aug 2009 23:27:38 +0200