← 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-02-11 04:02:41 UTC
  • mfrom: (5017.2.2 tariff)
  • Revision ID: pqm@pqm.ubuntu.com-20100211040241-w6n021dz0uus341n
(mbp) add import-tariff tests

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/ppa.txt
19
19
    Final released versions.
20
20
 
21
21
<https://launchpad.net/~bzr-beta-ppa/+archive>
22
 
    Releases and release candidates.    
 
22
    Releases and release candidates.
23
23
 
24
24
<https://launchpad.net/~bzr-nightly-ppa/+archive>
25
25
    Automatic nightly builds from trunk.
38
38
versions it is also copied to the main PPA.
39
39
 
40
40
The packaging information is kept in branches of bzr on Launchpad, named
41
 
like 
 
41
like
42
42
<https://code.launchpad.net/~bzr/bzr/packaging-hardy>.
43
43
or
44
44
<lp:~bzr/bzr/packaging-hardy>.  These branches are intended to be used
46
46
 
47
47
Preconditions
48
48
-------------
49
 
  
50
 
* You must have a Launchpad account and be a member of the teams 
 
49
 
 
50
* You must have a Launchpad account and be a member of the teams
51
51
  that own these PPAs (``~bzr``, ``~bzr-beta-ppa``).
52
52
 
53
53
* You must have a GPG key registered to your Launchpad account.
75
75
 
76
76
    [DEFAULT]
77
77
    default_host_main = notspecified
78
 
  
 
78
 
79
79
* Configure ``bzr-builddeb`` to sign the package, which is required for
80
80
  Launchpad to build it.  Put this in ``~/.bazaar/builddeb.conf`` ::
81
81
 
107
107
release packages is as simple as::
108
108
 
109
109
  cd ~/dev/bzr/releases/packaging
110
 
  ln ~/dev/bzr/releases/bzr-1.6.tar.gz ./bzr_1.6.orig.tar.gz
111
 
  export UBUNTU_RELEASES="dapper feisty gutsy hardy intrepid"
 
110
  export VERSION="1.17~rc1-1~bazaar1"
 
111
  export PACKAGE="bzr"
 
112
  export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
112
113
  ~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
113
 
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh 1.6~beta3-1~bazaar1
114
 
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages
115
 
  dput bzr-beta-ppa bzr_1.6~beta3-1~bazaar1*.changes
 
114
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh
 
115
  ~/dev/bzr/bzr.dev/tools/packaging/update-control.sh 1.16 1.17 1.18
 
116
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages.sh
 
117
  dput bzr-beta-ppa ${PACKAGE}_$VERSION*.changes
 
118
 
 
119
Rinse and repeat for all the plugins by changing VERSION and PACKAGE.
116
120
 
117
121
Long Form
118
122
~~~~~~~~~
121
125
   release. Such as ``~/dev/bzr/releases/packaging/hardy``. In each of these
122
126
   branches, you will produce the package for the release.
123
127
 
 
128
   The scripts will also create the branches and produce packages for
 
129
   bzrtools and bzr-svn.
 
130
 
124
131
#. Decide on the final version number.  It should be of this form::
125
132
 
126
 
     bzr-1.6~beta3-1~bazaar1~hardy1
 
133
     bzr-1.17~rc1-1~bazaar1~hardy1
127
134
 
128
135
   **Note:** There are three hyphen-separated parts: the *package name*,
129
136
   the *upstream version*, and the *packaging version*.
130
137
 
131
138
   **Caution:** Upstream betas or release candidates must insert a tilde
132
139
   to make them sort before the final release, like this:
133
 
   ``bzr-1.6~beta3-1~bazaar1~hardy1``.
 
140
   ``bzr-1.17~rc1-1~bazaar1~hardy1``.
134
141
 
135
142
   Final releases will use a release string of the form:
136
 
   ``bzr-1.6-1~bazaar1~hardy1``
 
143
   ``bzr-1.17-1~bazaar1~hardy1``
 
144
 
 
145
   Set this base of this up as a usable environment variable::
 
146
 
 
147
      export VERSION="1.17~rc1-1~bazaar1"
137
148
 
138
149
#. Export the distroreleases that you will be packaging for::
139
150
 
140
 
      export UBUNTU_RELEASES="dapper feisty gutsy hardy intrepid jaunty"
 
151
      export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
 
152
 
 
153
#. Export the program you are packaging::
 
154
 
 
155
      export PACKAGE="bzr"
141
156
 
142
157
#. Checkout (or update) the packaging branch for each supported release::
143
158
 
155
170
 
156
171
   For bzrtools this is typically::
157
172
 
158
 
      Build-Depends-Indep: bzr (>= 1.6~), rsync
159
 
      Depends: ${python:Depends}, bzr (>= 1.6~), bzr (<< 1.7~), patch
 
173
      Build-Depends-Indep: bzr (>= 1.17~), rsync
 
174
      Depends: ${python:Depends}, bzr (>= 1.17~), bzr (<< 1.18~), patch
 
175
 
 
176
   There is a helper script which will update the control file and commit it
 
177
   for all of your ``$UBUNTU_RELEASES``. It is available as::
 
178
 
 
179
    tools/packaging/update-control.sh
 
180
 
 
181
   You must supply the versions as arguments as follows
 
182
   OLD_VERSION CURRENT_VERSION NEXT_VERSION, such as::
 
183
 
 
184
    tools/packaging/update-control.sh 1.16 1.17 1.18
160
185
 
161
186
#. Make a new ``debian/changelog`` entry for the new release,
162
187
   either by using ``dch`` or just editing the file::
163
188
 
164
 
      dch -v '1.6~beta3-1~bazaar1~hardy1' -D hardy
 
189
      dch -v '1.17~rc1-1~bazaar1~hardy1' -D hardy
165
190
 
166
191
   dch will default to the distro you're working in and this isn't checked
167
 
   against the version number (which is just our convention), so make sure 
 
192
   against the version number (which is just our convention), so make sure
168
193
   to specify it.
169
194
 
170
195
   Make sure you have the correct email address for yourself (you may need
171
196
   export DEBEMAIL=`bzr whoami` if it isn't already set), version number, and
172
197
   distribution.  It should look something like this::
173
198
 
174
 
       bzr (1.6~beta3-1~bazaar1~hardy1) hardy; urgency=low
175
 
     
 
199
       bzr (1.17~rc1-1~bazaar1~hardy1) hardy; urgency=low
 
200
 
176
201
        * New upstream release.
177
 
     
 
202
 
178
203
       -- John Sample <sample@example.com>  Mon, 31 Mar 2008 12:36:27 +1100
179
204
 
180
205
   If you need to upload the package again to fix a problem, normally you
185
210
 
186
211
   You will also want to commit these changes into the packaging branch.
187
212
 
188
 
   There is a helper script which will update the changelog and commit it
 
213
   There is a helper script which will build all the packages
189
214
   for all of your ``$UBUNTU_RELEASES``. It is available as::
190
215
 
191
216
      tools/packaging/update-changelogs.sh
192
217
 
193
 
   You must supply the release string, such as::
194
 
 
195
 
      tools/packaging/update-changelogs.sh 1.6~beta3-1~bazaar1
196
 
 
197
 
   It will automatically append the distro numbering on the end.
198
 
 
199
218
#. Build the source packages::
200
219
 
201
220
      cd packaging-$DISTRO; bzr builddeb -S
207
226
 
208
227
   where ``$UID`` is the gpg key you want to use to sign the changes.
209
228
 
 
229
   There is a helper script which will build the package
 
230
   for all of your ``$UBUNTU_RELEASES``. It is available as::
 
231
 
 
232
      tools/packaging/build-packages.sh
 
233
 
210
234
#. Upload into the beta PPA for each release::
211
235
 
212
 
     dput bzr-beta-ppa bzr_1.6-1*.changes
 
236
     dput bzr-beta-ppa bzr*1.17-1*.changes
213
237
 
214
238
#. For final release versions, also copy it into the ``~bzr`` PPA::
215
239
 
216
 
     dput bzr-ppa ../bzr_1.6-1\~bazaar1\~hardy1\_source.changes
 
240
     dput bzr-ppa ../bzr_1.17-1\~bazaar1\~hardy1\_source.changes
217
241
 
218
242
   Alternatively, you can use Launchpad's "copy" feature to copy the
219
243
   packages between repositories.
227
251
Packaging bzr-svn
228
252
~~~~~~~~~~~~~~~~~
229
253
 
230
 
bzr-svn uses a packaging branch that contains both the source 
 
254
bzr-svn uses a packaging branch that contains both the source
231
255
(including any changes against upstream) and the ``debian/`` directory.
232
256
 
233
257
To build bzr-svn:
234
258
 
235
259
#. Get a checkout of ``lp:~bzr/bzr-svn/hardy-ppa/``
236
260
 
237
 
#. Merge from ``http://bzr.debian.org/pkg-bazaar/bzr-svn/experimental/``
238
 
  
 
261
#. Merge from ``http://bzr.debian.org/pkg-bazaar/bzr-svn/unstable/``
 
262
 
239
263
   This should bring in both upstream and packaging changes for the new
240
264
   release, and it's updated as part of the bzr-svn release process.
241
265
 
 
266
   It's quite possible you will need to resolve some conflicts.
 
267
 
242
268
#. Run ``dch -v 0.4.15-1~bazaar1-hardy1 -D hardy`` or similar
243
269
 
244
270
#. Run ``bzr builddeb --source``