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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
Packaging hints
===============
This packaging is maintained with the use of Git, using the following
branches:
upstream-git - master branch of upstream Git source
upstream - unpackaged upstream tarballs
pristine-tar - binary deltas to recreate pristine tarballs
master - Debian packaging
With the above, we can switch between working from upstream released
tarballs and syncing directly with upstream development, both using
git-buildpackage (with its default branch names).
Package sugar-base as example
-----------------------------
The rest of this document uses sugar-base as sample package, and some
old actual version numbers from that package - replace with your actual
package as needed...
Getting packaging source from Git repository
--------------------------------------------
The following commands (in an empty dir) fetch and build the package:
aptitude install git-buildpackage
git clone git://git.debian.org/git/collab-maint/sugar-base
cd sugar-base
git fetch origin upstream:upstream
git-buildpackage
Merging with newer upstream Git tree
------------------------------------
The following commands (inside Git repository) updates the local mirror
of upstream source, and merges with our packaging branch:
cd sugar-base
git checkout upstream-git
git pull
git fetch --tags
git checkout master
git pull . upstream-git
The following command shows upstream changes possibly relevant to
mention in changelog (replace "HEAD^" with a reference to actual sync
commit if not invoked right after sync'ing):
git log --pretty="format:%h %s" HEAD^..upstream-git
Doing a package release from upstream tarball
---------------------------------------------
The following command (inside Git repository) imports a downloaded
tarball into the "upstream" and pristine-tarball Git branches (taball
name is recorded too and used later, so make sure to first rename the
tarball to follow Debian naming convention {name}_{version}.orig.{ext}):
git-import-orig --pristine-tar --sign-tags path/to/sugar-base_0.79.0.orig.tar.gz
Check that all files are included in "upstream" branch (don't know why
this fails sometimes):
git status
If some files are "untracked", then do the following to manually add
untracked files to upstream branch and merge them with master branch
(the stash commands puts changelog update aside and restore it again
afterwards):
git stash
git checkout upstream
git add *
git commit -m "Add files mysteriously skipped by git-import-orig."
git checkout master
git pull . upstream
git stash apply
Comment out tarball hash in debian/control, test get-orig-source, and
enable hash line with new hash:
fakeroot debian/rules get-orig-source
Adjust changelog and package, and if satisfied with the result then tag
it, push Git sources and release the package:
git-buildpackage --git-tag --git-sign-tags
[test package...]
git push --all
git push --tags
cd ..
dput sugar-base_0.79.0-1_amd64.changes
Doing a package release from upstream Git snapshot
--------------------------------------------------
First, look at upstream development for a good place to release, and tag
by its date, replacing "~" with ".". Normally just tag the latest
upstream commit, to avoid simply including later upstream work in the
debian diff:
git log --abbrev-commit upstream-git
git tag -s -m "Tag upstream for package release." upstream/0.2.git20080130 61279f8
Adjust changelog and package, and if satisfied with the result then tag
it, push Git sources and release the package:
dch -r -v "0.2~git20080130-0~0jones1" "New upstream Git snapshot."
debcommit -r -a
git-buildpackage
[test package...]
git tag -s -m "Tag package release." debian/0.2.git20080130-0.0jones1
git push --all
git push --tags
cd ..
dput sugar-base_0.2~git20080130-0~0jones1_amd64.changes
-- Jonas Smedegaard <dr@jones.dk> Sat, 08 Mar 2008 01:08:36 +0100
|
