← 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 20:52:54 UTC
  • mfrom: (5193.5.9 cleanup)
  • Revision ID: pqm@pqm.ubuntu.com-20100716205254-j0m65wckb90rj54w
(vila) Cleanup some bogus rest constructs in the doc. (Vincent Ladeuil)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/ppa.txt
13
13
 
14
14
  __ https://help.launchpad.net/PPAQuickStart
15
15
 
16
 
As of June 2008, there are three PPAs:
 
16
As of June 2010, there are three PPAs:
17
17
 
18
18
<https://launchpad.net/~bzr/+archive>
19
 
    Final released versions.
 
19
    Final released versions and updates.
20
20
 
21
21
<https://launchpad.net/~bzr-beta-ppa/+archive>
22
 
    Releases and release candidates.
 
22
    Beta releases.
23
23
 
24
24
<https://launchpad.net/~bzr-nightly-ppa/+archive>
25
25
    Automatic nightly builds from trunk.
27
27
We build packages for every supported Ubuntu release
28
28
<https://wiki.ubuntu.com/Releases>.  Packages need no longer be updated
29
29
when the release passes end-of-life because all users should
30
 
have upgraded by then.  (As of May 2008, Edgy Eft is no longer supported.)
 
30
have upgraded by then.  
31
31
 
32
 
We build a distinct package for each distrorelease.  As of bzr 1.5, Dapper
33
 
uses ``python-support`` and later distributions use ``python-central``.
 
32
We build a distinct package for each distrorelease.  
34
33
If you upload a release-specific version, you should add a suffix to the
35
34
package version, e.g. ``bzr.1.3-1~bazaar1~dapper1``.
36
35
 
 
36
Dapper uses the ``python-support`` framework and later distributions use
 
37
``python-central``.  This has little effect on everyday packaging but does
 
38
mean that some of the control files are quite different.
 
39
 
37
40
Every package is first uploaded into the beta ppa.  For final release
38
41
versions it is also copied to the main PPA.
39
42
 
44
47
<lp:~bzr/bzr/packaging-hardy>.  These branches are intended to be used
45
48
with the ``bzr-builddeb`` plugin.
46
49
 
 
50
**You should almost always upload to the beta ppa first** and then either 
 
51
upload again or copy the packages into the release ppa.  That reduces the 
 
52
risk of breaking the main archive from which people get bzr updates.
 
53
 
47
54
Preconditions
48
55
-------------
49
56
 
52
59
 
53
60
* You must have a GPG key registered to your Launchpad account.
54
61
 
55
 
* Configure ``dput`` to upload to our PPA with this section in your
56
 
  ``~/.dput.cf``::
57
 
 
58
 
    [bzr-beta-ppa]
59
 
    fqdn = ppa.launchpad.net
60
 
    method = ftp
61
 
    incoming = ~bzr-beta-ppa/ubuntu
62
 
    login = anonymous
63
 
    allow_unsigned_uploads = 0
64
 
 
65
 
    [bzr-ppa]
66
 
    fqdn = ppa.launchpad.net
67
 
    method = ftp
68
 
    incoming = ~bzr/ubuntu
69
 
    login = anonymous
70
 
    allow_unsigned_uploads = 0
71
 
 
72
 
  You may also want to add these lines to prevent inadvertently attempting
73
 
  to upload into Ubuntu or Debian, which will give a somewhat unclear
74
 
  error::
 
62
On reasonably recent versions of Ubuntu you no longer need special dput
 
63
configuration, because you can just say ::
 
64
 
 
65
  dput ppa:bzr/2.1-proposed <source.changes
 
66
  
 
67
 
 
68
However, you may still want to add these lines to ``~/.dput.cf`` prevent 
 
69
inadvertently attempting to upload into Ubuntu or Debian, which will
 
70
give a somewhat unclear error::
75
71
 
76
72
    [DEFAULT]
77
73
    default_host_main = notspecified
100
96
Packaging Bazaar
101
97
----------------
102
98
 
 
99
Overview of packaging with builddeb
 
100
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
101
 
 
102
* First update the oldest supported branch, using ``bzr merge-upstream``.
 
103
 
 
104
* Run ``bzr builddeb -S -- -sa`` to build a source package, then put 
 
105
  that into the ppa.  
 
106
  
 
107
  (``-S`` says to make a source-only upload, which is
 
108
  required for Launchpad's builders.  ``--sa`` says to include the
 
109
  ``.orig.tgz`` even if this doesn't seem to be the first upload for an
 
110
  upstream release: this is often needed when rebuilding something that's
 
111
  previously been uploaded to Debian or Ubuntu or into a different PPA.)
 
112
 
 
113
* Now merge across that change into each supported branch with a 
 
114
  simple ``bzr merge``.
 
115
  
 
116
Locally testing builds
 
117
~~~~~~~~~~~~~~~~~~~~~~
 
118
 
 
119
It may be useful to locally test builds inside pbuilder.  You may want to 
 
120
use the script from <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255165> 
 
121
to wrap it.
 
122
 
 
123
 
103
124
Short form
104
125
~~~~~~~~~~
105
126
 
282
303
summary of current package versions with::
283
304
 
284
305
  apt-cache madison bzr
 
306
  
 
307
  
 
308
  
 
309
Packaging dependencies
 
310
----------------------
 
311
 
 
312
Some of our updates to bzr in previous releases require backports of our
 
313
dependencies.  Specific branches holding these backports:
 
314
 
 
315
 * ``lp:~bzr/ubuntu/dapper/configobj/dapper-backport``
285
316
 
286
317
 
287
318
..