← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

Merge pt1 hooks branch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/ppa.txt
26
26
    A preserved copy of the final version of packages from ~bzr/ppa for
27
27
    obsolete Ubuntu series.
28
28
 
29
 
<https://launchpad.net/~bzr-beta-ppa/+archive/ppa>
 
29
<https://launchpad.net/~bzr/+archive/beta>
30
30
    Beta releases.
31
31
 
32
 
<https://launchpad.net/~bzr-beta-ppa/+archive/obsolete>
 
32
<https://launchpad.net/~bzr/+archive/beta-obsolete>
33
33
    A preserved copy of the final version of packages from
34
 
    ~bzr-beta-ppa/ppa for obsolete Ubuntu series.
 
34
    ~bzr/beta for obsolete Ubuntu series.
35
35
 
36
36
<https://launchpad.net/~bzr/+archive/daily>
37
37
    Automatic nightly builds from trunk.
44
44
``python-central``.  This has little effect on everyday packaging but does
45
45
mean that some of the control files are quite different.
46
46
 
47
 
Every package is first uploaded into the beta ppa.  For final release
48
 
versions it is also copied to the main PPA.
 
47
Beta releases of bzr and plugins are uploaded into the beta PPA.
 
48
 
 
49
Final release versions are first uploaded into the proposed PPA, which
 
50
serves as a staging area to allow for new packages to be tested, and also
 
51
so that a complete set of Bazaar core and plugin updated versions can be
 
52
prepared together, when negotiating an API version transition.
 
53
 
 
54
Once ready, packages can be copied from the proposed PPA to the main PPA
 
55
using the lp-promote-ppa script found within the hydrazine project.  This
 
56
procedure reduces the risk of broken packages or dependencies between
 
57
packages in the main PPA from which many people get bzr updates.
49
58
 
50
59
The packaging information is kept in branches of bzr on Launchpad, named
51
60
like
54
63
<lp:~bzr/ubuntu/hardy/bzr/bzr-ppa>.  These branches are intended to be used
55
64
with the ``bzr-builddeb`` plugin.
56
65
 
57
 
**You should almost always upload to the proposed or beta ppa first** and
58
 
then copy the packages into the release ppa.  That reduces the 
59
 
risk of breaking the main archive from which people get bzr updates.
 
66
The page <http://wiki.bazaar.canonical.com/PpaPackagingBranches> is a
 
67
reference to where the PPA packaging branches for each of the source
 
68
packages in the ``~bzr`` PPAs may be found.
60
69
 
61
70
 
62
71
Supported releases
82
91
Preconditions
83
92
-------------
84
93
 
85
 
* You must have a Launchpad account and be a member of the teams
86
 
  that own these PPAs (``~bzr``, ``~bzr-beta-ppa``).
 
94
* You must have a Launchpad account and be a member of the team
 
95
  that owns these PPAs (``~bzr``).
87
96
 
88
97
* You must have a GPG key registered to your Launchpad account.
89
98
 
100
109
    [DEFAULT]
101
110
    default_host_main = notspecified
102
111
 
103
 
* Configure ``bzr-builddeb`` to sign the package, which is required for
104
 
  Launchpad to build it.  Put this in ``~/.bazaar/builddeb.conf`` ::
105
 
 
106
 
      [BUILDDEB]
107
 
      builder = dpkg-buildpackage -rfakeroot
108
 
      source-builder= dpkg-buildpackage -rfakeroot -S -sa
109
 
 
110
112
* You need a Ubuntu (or probably Debian) machine, and ::
111
113
 
112
114
    sudo apt-get install build-essential devscripts dput quilt patch libcrypt-ssleay-perl debhelper cdbs python-docutils
114
116
  Please update this document if you encounter unmet dependencies or find a
115
117
  shorter way to express them.
116
118
 
117
 
* You will also want to have the `bzr-builddeb`_ plugin installed, which
118
 
  depends on `bzrtools`_.
 
119
* You will also want to have the `bzr-builddeb`_ plugin installed.
119
120
 
120
121
.. _`bzr-builddeb`: http://launchpad.net/bzr-builddeb
121
 
.. _`bzrtools`: http://launchpad.net/bzrtools
122
122
 
123
123
 
124
124
Packaging Bazaar
133
133
  that into the ppa.  
134
134
  
135
135
  (``-S`` says to make a source-only upload, which is
136
 
  required for Launchpad's builders.  ``--sa`` says to include the
 
136
  required for Launchpad's builders.  ``-sa`` says to include the
137
137
  ``.orig.tgz`` even if this doesn't seem to be the first upload for an
138
138
  upstream release: this is often needed when rebuilding something that's
139
139
  previously been uploaded to Debian or Ubuntu or into a different PPA.)
299
299
 
300
300
#. You should soon get an "upload accepted" mail from Launchpad, which
301
301
   means that your package is waiting to be built.  You can then track its
302
 
   progress in <https://launchpad.net/~bzr-beta-ppa/+archive> and
303
 
   <https://launchpad.net/~bzr-beta-ppa/+archive/+builds>.
 
302
   progress in <https://launchpad.net/~bzr/+archive/proposed> and
 
303
   <https://launchpad.net/~bzr/+archive/proposed/+builds>.
304
304
 
305
305
 
306
306
Packaging bzr-svn
327
327
   bzr-builddeb will automatically check out the appropriate tag from the
328
328
   main branch of bzr-svn, build, and package it.
329
329
 
330
 
#. ``dput bzr-beta-ppa ../bzr-svn_0.4.15-1~bazaar1~hardy1_source.changes``
 
330
#. ``dput ppa:bzr/proposed ../bzr-svn_0.4.15-1~bazaar1~hardy1_source.changes``
331
331
 
332
332
 
333
333
Monitoring the contents of PPAs
360
360
dependencies.  Specific branches holding these backports:
361
361
 
362
362
 * ``lp:~bzr/ubuntu/dapper/configobj/dapper-backport``
 
363
 * ``lp:~bzr/ubuntu/hardy/python-central-debhelper-sequence-addon/bzr-ppa``
363
364
 
364
365
 
365
366
..