Rev 3771: (mbp) updated ppa documentation in file:///home/pqm/archives/thelove/bzr/%2Btrunk/
Canonical.com Patch Queue Manager
pqm at pqm.ubuntu.com
Thu Oct 9 23:27:12 BST 2008
At file:///home/pqm/archives/thelove/bzr/%2Btrunk/
------------------------------------------------------------
revno: 3771
revision-id: pqm at pqm.ubuntu.com-20081009222709-e64jq9sfyzvqjbn2
parent: pqm at pqm.ubuntu.com-20081008020104-e68hyxx45qo19nzx
parent: mbp at sourcefrog.net-20081009214813-6440j5zyl4lmxhfb
committer: Canonical.com Patch Queue Manager <pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Thu 2008-10-09 23:27:09 +0100
message:
(mbp) updated ppa documentation
modified:
doc/developers/ppa.txt ppa.txt-20080722055539-606u7t2z32t3ae4w-1
------------------------------------------------------------
revno: 3749.2.2
revision-id: mbp at sourcefrog.net-20081009214813-6440j5zyl4lmxhfb
parent: mbp at sourcefrog.net-20081009091718-1b4ejhseb5bq4gt4
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Fri 2008-10-10 08:48:13 +1100
message:
typo
modified:
doc/developers/ppa.txt ppa.txt-20080722055539-606u7t2z32t3ae4w-1
------------------------------------------------------------
revno: 3749.2.1
revision-id: mbp at sourcefrog.net-20081009091718-1b4ejhseb5bq4gt4
parent: pqm at pqm.ubuntu.com-20080927233809-mlgk5zkwowkb8q8z
committer: Martin Pool <mbp at sourcefrog.net>
branch nick: doc
timestamp: Thu 2008-10-09 20:17:18 +1100
message:
Updated PPA documentation
modified:
doc/developers/ppa.txt ppa.txt-20080722055539-606u7t2z32t3ae4w-1
=== modified file 'doc/developers/ppa.txt'
--- a/doc/developers/ppa.txt 2008-08-25 21:50:11 +0000
+++ b/doc/developers/ppa.txt 2008-10-09 21:48:13 +0000
@@ -13,7 +13,7 @@
__ https://help.launchpad.net/PPAQuickStart
-As of June 2008, there are two PPAs:
+As of June 2008, there are three PPAs:
<https://launchpad.net/~bzr/+archive>
Final released versions.
@@ -21,6 +21,9 @@
<https://launchpad.net/~bzr-beta-ppa/+archive>
Releases and release candidates.
+<https://launchpad.net/~bzr-nightly-ppa/+archive>
+ Automatic nightly builds from trunk.
+
We build packages for every supported Ubuntu release
<https://wiki.ubuntu.com/Releases>. Packages need no longer be updated
when the release passes end-of-life because all users should
@@ -34,11 +37,12 @@
Every package is first uploaded into the beta ppa. For final release
versions it is also copied to the main PPA.
-The ``debian/`` directory containing the packaging information is kept in
-branches on Launchpad, named like
+The packaging information is kept in branches of bzr on Launchpad, named
+like
<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.
or
-<lp:~bzr/bzr/packaging-hardy>.
+<lp:~bzr/bzr/packaging-hardy>. These branches are intended to be used
+with the ``bzr-builddeb`` plugin.
Preconditions
-------------
@@ -72,11 +76,22 @@
[DEFAULT]
default_host_main = notspecified
+* Configure ``bzr-builddeb`` to sign the package, which is required for
+ Launchpad to build it. Put this in ``~/.bazaar/builddeb.conf`` ::
+
+ [BUILDDEB]
+ builder = dpkg-buildpackage -rfakeroot
+ source-builder= dpkg-buildpackage -rfakeroot -S -sa
+
* You need a Ubuntu (or probably Debian) machine, and ::
sudo apt-get install build-essential devscripts dput quilt patch
-* You will also want to have the ``bzr-builddeb`` plugin installed.
+* You will also want to have the `bzr-builddeb`_ plugin installed, which
+ depends on `bzrtools`_.
+
+.. _`bzr-builddeb`: http://launchpad.net/bzr-builddeb
+.. _`bzrtools`: http://launchpad.net/bzrtools
Packaging Bazaar
@@ -93,7 +108,7 @@
~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh 1.6~beta3-1~bazaar1
~/dev/bzr/bzr.dev/tools/packaging/build-packages
- dput bzr-beta-ppa build-area/bzr_1.6~beta3~bazaar1*.changes
+ dput bzr-beta-ppa bzr_1.6~beta3-1~bazaar1*.changes
Long Form
~~~~~~~~~
@@ -105,8 +120,8 @@
bzr-1.6~beta3-1~bazaar1~hardy1
- There are three hyphen-separated parts: the *package name*, the *upstream
- version*, and the *packaging version*.
+ **Note:** There are three hyphen-separated parts: the *package name*,
+ the *upstream version*, and the *packaging version*.
**Caution:** Upstream betas or release candidates must insert a tilde
to make them sort before the final release, like this:
@@ -128,7 +143,7 @@
tools/packaging/update-packaging-branches.sh
#. The ``bzr-builddeb`` step will download the original tarball if you do
- not already have it. Putting it into a ``tarballs`` directory.
+ not already have it, putting it into a ``tarballs`` directory.
#. For Bazaar plugins, change the ``debian/control`` file to express a
dependency on the correct version of ``bzr``.
@@ -179,28 +194,20 @@
cd packaging-$DISTRO; bzr builddeb -S
- This will create a ``.changes`` file in ``build-area``. You will need
- to sign it with::
-
- debsign -m$UID build-area/*.changes
-
- Where ``$UID`` is the gpg key you want to use to sign the changes.
- Alternatively, you can configure ``~/.bazaar/builddeb.conf`` with::
-
- [BUILDDEB]
- builder = dpkg-buildpackage -rfakeroot
- source-builder= dpkg-buildpackage -rfakeroot -S -sa
-
- Which tells ``bzr builddeb`` to automatically sign the package with the
- key associated with the user who created the changelog entry.
-
+ This will create a ``.changes`` file. If you didn't configure builddeb
+ to automatically sign them, you can use ::
+
+ debsign -m$UID *.changes
+
+ where ``$UID`` is the gpg key you want to use to sign the changes.
+
#. Upload into the beta PPA for each release::
- dput bzr-beta-ppa build-area/*.changes
+ dput bzr-beta-ppa bzr_1.6-1*.changes
#. For final release versions, also copy it into the ``~bzr`` PPA::
- dput bzr-ppa ../bzr__1.6-1\~bazaar1\~hardy1\_source.changes
+ dput bzr-ppa ../bzr_1.6-1\~bazaar1\~hardy1\_source.changes
Alternatively, you can use Launchpad's "copy" feature to copy the
packages between repositories.
More information about the bazaar-commits
mailing list