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
|
------------------------------------------------------
README.source - for Debian/Ubuntu modemmanager
Author: Mathieu Trudel-Lapierre <mathieu-tl@ubuntu.com>
------------------------------------------------------
Content:
I. Packaging overview
II. Upstream (orig.tar.gz)
III. Efficient Upstream orig.tar.gz production
IV. Patching
------
I. Packaging overview
+ Obtaining latest packaging:
bzr branch lp:~modemmanager/modemmanager/ubuntu
+ this gives you a debian/ only bzr branch
+ the suggested way to build is using bzr-builddeb; for that
1. put the orig.tar.gz matching your debian/changelog in --orig-dir
of bzr-builddeb (default: ..)
2. run: bzr bd --dont-purge
3. this gives you a build tree and the results in --build-dir
and --result-dir
+ if all you want to do is check the current package with full source, run:
./debian/rules get-current-source
bzr bd-do
II. Upstream (orig.tar.gz)
The package provides means to easily grab the _current_ and the latest
upstream snapshot of ModemManager.
./debian/rules gets the pristine upstream snapshot for you then packs
things up in a tarball orig.tar.gz.
The nested tarball is packed using _gz_.
Examples on how to get orig.tar.gz for snapshots:
+ get latest upstream snapshot:
./debian/rules get-orig-source
+ get current upstream snapshot (by changelog):
./debian/rules get-current-source
III. Efficient Upstream orig.tar.gz production
The packaging provides a feature to speed up the orig.tar.gz production by
keeping a local mirror of the NetworkManager checkouts; this reduces the
network overhead considerably and allows you to regularly create tarballs
rather quickly. To do that, append LOCAL_BRANCH=/local/MM/checkout
to your debian/rules invocation, e.g.
+ produce latest upstream snapshot:
./debian/rules get-orig-source LOCAL_BRANCH=~/ModemManager/
+ produce current upstream snapshot (by changelog):
./debian/rules get-current-source LOCAL_BRANCH=~/ModemManager/
V. Patching
We use quilt for the sake of efficiency to code and update patches.
if you want to create a patch or write a patch, you can quickly get
ready by first getting the orig.tar.gz, then using bzr-builddeb like
so:
bzr bd-do
Make sure your QUILT_PATCHES is set appropriately:
QUILT_PATCHES=debian/patches
and start working on quilt patches as usual, e.g.
quilt push -a
quilt applied
quilt pop
quilt refresh
...
|