← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-07-16 14:02:58 UTC
  • mfrom: (5346.2.3 doc)
  • Revision ID: pqm@pqm.ubuntu.com-20100716140258-js1p8i24w8nodz6t
(mbp) developer docs about transports and symlinks (Martin Pool)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/ppa.txt
18
18
<https://launchpad.net/~bzr/+archive>
19
19
    Final released versions and updates.
20
20
 
21
 
<https://launchpad.net/~bzr/+archive/proposed>
22
 
    Proposed uploads to move into ~bzr, awaiting testing.
23
 
 
24
21
<https://launchpad.net/~bzr-beta-ppa/+archive>
25
22
    Beta releases.
26
23
 
27
24
<https://launchpad.net/~bzr-nightly-ppa/+archive>
28
25
    Automatic nightly builds from trunk.
29
26
 
 
27
We build packages for every supported Ubuntu release
 
28
<https://wiki.ubuntu.com/Releases>.  Packages need no longer be updated
 
29
when the release passes end-of-life because all users should
 
30
have upgraded by then.  
 
31
 
30
32
We build a distinct package for each distrorelease.  
31
33
If you upload a release-specific version, you should add a suffix to the
32
34
package version, e.g. ``bzr.1.3-1~bazaar1~dapper1``.
40
42
 
41
43
The packaging information is kept in branches of bzr on Launchpad, named
42
44
like
43
 
<https://code.launchpad.net/~bzr/ubuntu/hardy/bzr/bzr-ppa>.
 
45
<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.
44
46
or
45
 
<lp:~bzr/ubuntu/hardy/bzr/bzr-ppa>.  These branches are intended to be used
 
47
<lp:~bzr/bzr/packaging-hardy>.  These branches are intended to be used
46
48
with the ``bzr-builddeb`` plugin.
47
49
 
48
50
**You should almost always upload to the beta ppa first** and then either 
49
51
upload again or copy the packages into the release ppa.  That reduces the 
50
52
risk of breaking the main archive from which people get bzr updates.
51
53
 
52
 
 
53
 
Supported releases
54
 
------------------
55
 
 
56
 
We build packages for every supported Ubuntu release
57
 
<https://wiki.ubuntu.com/Releases>.  Packages need no longer be updated
58
 
when the release passes end-of-life because all users should
59
 
have upgraded by then.  
60
 
 
61
 
As of August 2010, the following releases are supported:
62
 
 
63
 
* Maverick 
64
 
* Lucid LTS
65
 
* Karmic
66
 
* Jaunty (support ends October 2010)
67
 
* Hardy LTS
68
 
* Dapper LTS (supported but no longer updated for new releases)
69
 
 
70
 
 
71
54
Preconditions
72
55
-------------
73
56
 
79
62
On reasonably recent versions of Ubuntu you no longer need special dput
80
63
configuration, because you can just say ::
81
64
 
82
 
  dput ppa:bzr/proposed <source.changes
 
65
  dput ppa:bzr/2.1-proposed <source.changes
83
66
  
84
67
 
85
68
However, you may still want to add these lines to ``~/.dput.cf`` prevent 
137
120
use the script from <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255165> 
138
121
to wrap it.
139
122
 
140
 
Update all packages in proposed before copping the main ppa
141
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
142
 
 
143
 
If one updates bzr, and there are plugins that are not compatible with the
144
 
new version of bzr, this can cause pain for users using the ppa. In order to
145
 
avoid this, we first get all packages up to date in the proposed ppa, and then
146
 
copy them to the main ppa.
147
 
 
148
123
 
149
124
Short form
150
125
~~~~~~~~~~
157
132
  export PACKAGE="bzr"
158
133
  export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
159
134
  ~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
160
 
  * Optionaly merge debian unstable. 
161
135
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh
162
136
  ~/dev/bzr/bzr.dev/tools/packaging/update-control.sh 1.16 1.17 1.18
163
137
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages.sh
164
 
  dput ppa:bzr/proposed ${PACKAGE}_$VERSION*.changes
 
138
  dput bzr-beta-ppa ${PACKAGE}_$VERSION*.changes
165
139
 
166
140
Rinse and repeat for all the plugins by changing VERSION and PACKAGE.
167
141
 
203
177
 
204
178
#. Checkout (or update) the packaging branch for each supported release::
205
179
 
206
 
      bzr co lp:~bzr/ubuntu/hardy/bzr/bzr-ppa
 
180
      bzr co lp:~bzr/bzr/packaging-hardy
207
181
 
208
182
   There is a script available to help::
209
183
 
210
184
      tools/packaging/update-packaging-branches.sh
211
185
 
212
 
#. Optionaly, merge the Debian unstable branch into each of the packaging
213
 
   branches. You can find the Debian unstable branch here:
214
 
   http://bzr.debian.org/pkg-bazaar/
215
 
 
216
186
#. The ``bzr-builddeb`` step will download the original tarball if you do
217
187
   not already have it, putting it into a ``tarballs`` directory.
218
188
 
268
238
 
269
239
#. Build the source packages::
270
240
 
271
 
      cd bzr-$DISTRO; bzr builddeb -S
 
241
      cd packaging-$DISTRO; bzr builddeb -S
272
242
 
273
243
   This will create a ``.changes`` file.  If you didn't configure builddeb
274
244
   to automatically sign them, you can use ::
282
252
 
283
253
      tools/packaging/build-packages.sh
284
254
 
285
 
#. Upload into the PPA for each release::
286
 
 
287
 
     dput dput ppa:bzr/proposed bzr*1.17-1*.changes
 
255
#. Upload into the beta PPA for each release::
 
256
 
 
257
     dput bzr-beta-ppa bzr*1.17-1*.changes
 
258
 
 
259
#. For final release versions, also copy it into the ``~bzr`` PPA::
 
260
 
 
261
     dput bzr-ppa ../bzr_1.17-1\~bazaar1\~hardy1\_source.changes
 
262
 
 
263
   Alternatively, you can use Launchpad's "copy" feature to copy the
 
264
   packages between repositories.
288
265
 
289
266
#. You should soon get an "upload accepted" mail from Launchpad, which
290
267
   means that your package is waiting to be built.  You can then track its