← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

  • Committer: John Arbash Meinel
  • Date: 2009-03-06 20:42:40 UTC
  • mto: This revision was merged to the branch mainline in revision 4088.
  • Revision ID: john@arbash-meinel.com-20090306204240-mzjavv31z3gu1x7i
Fix a small bug in setup.py when an extension fails to build

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
 
  export VERSION="1.17~rc1-1~bazaar1"
111
 
  export PACKAGE="bzr"
112
 
  export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
 
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"
113
112
  ~/dev/bzr/bzr.dev/tools/packaging/update-packaging-branches.sh
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.
 
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
120
116
 
121
117
Long Form
122
118
~~~~~~~~~
125
121
   release. Such as ``~/dev/bzr/releases/packaging/hardy``. In each of these
126
122
   branches, you will produce the package for the release.
127
123
 
128
 
   The scripts will also create the branches and produce packages for
129
 
   bzrtools and bzr-svn.
130
 
 
131
124
#. Decide on the final version number.  It should be of this form::
132
125
 
133
 
     bzr-1.17~rc1-1~bazaar1~hardy1
 
126
     bzr-1.6~beta3-1~bazaar1~hardy1
134
127
 
135
128
   **Note:** There are three hyphen-separated parts: the *package name*,
136
129
   the *upstream version*, and the *packaging version*.
137
130
 
138
131
   **Caution:** Upstream betas or release candidates must insert a tilde
139
132
   to make them sort before the final release, like this:
140
 
   ``bzr-1.17~rc1-1~bazaar1~hardy1``.
 
133
   ``bzr-1.6~beta3-1~bazaar1~hardy1``.
141
134
 
142
135
   Final releases will use a release string of the form:
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"
 
136
   ``bzr-1.6-1~bazaar1~hardy1``
148
137
 
149
138
#. Export the distroreleases that you will be packaging for::
150
139
 
151
 
      export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
152
 
 
153
 
#. Export the program you are packaging::
154
 
 
155
 
      export PACKAGE="bzr"
 
140
      export UBUNTU_RELEASES="dapper feisty gutsy hardy intrepid jaunty"
156
141
 
157
142
#. Checkout (or update) the packaging branch for each supported release::
158
143
 
170
155
 
171
156
   For bzrtools this is typically::
172
157
 
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
 
158
      Build-Depends-Indep: bzr (>= 1.6~), rsync
 
159
      Depends: ${python:Depends}, bzr (>= 1.6~), bzr (<< 1.7~), patch
185
160
 
186
161
#. Make a new ``debian/changelog`` entry for the new release,
187
162
   either by using ``dch`` or just editing the file::
188
163
 
189
 
      dch -v '1.17~rc1-1~bazaar1~hardy1' -D hardy
 
164
      dch -v '1.6~beta3-1~bazaar1~hardy1' -D hardy
190
165
 
191
166
   dch will default to the distro you're working in and this isn't checked
192
 
   against the version number (which is just our convention), so make sure
 
167
   against the version number (which is just our convention), so make sure 
193
168
   to specify it.
194
169
 
195
170
   Make sure you have the correct email address for yourself (you may need
196
171
   export DEBEMAIL=`bzr whoami` if it isn't already set), version number, and
197
172
   distribution.  It should look something like this::
198
173
 
199
 
       bzr (1.17~rc1-1~bazaar1~hardy1) hardy; urgency=low
200
 
 
 
174
       bzr (1.6~beta3-1~bazaar1~hardy1) hardy; urgency=low
 
175
     
201
176
        * New upstream release.
202
 
 
 
177
     
203
178
       -- John Sample <sample@example.com>  Mon, 31 Mar 2008 12:36:27 +1100
204
179
 
205
180
   If you need to upload the package again to fix a problem, normally you
210
185
 
211
186
   You will also want to commit these changes into the packaging branch.
212
187
 
213
 
   There is a helper script which will build all the packages
 
188
   There is a helper script which will update the changelog and commit it
214
189
   for all of your ``$UBUNTU_RELEASES``. It is available as::
215
190
 
216
191
      tools/packaging/update-changelogs.sh
217
192
 
 
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
 
218
199
#. Build the source packages::
219
200
 
220
201
      cd packaging-$DISTRO; bzr builddeb -S
226
207
 
227
208
   where ``$UID`` is the gpg key you want to use to sign the changes.
228
209
 
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
 
 
234
210
#. Upload into the beta PPA for each release::
235
211
 
236
 
     dput bzr-beta-ppa bzr*1.17-1*.changes
 
212
     dput bzr-beta-ppa bzr_1.6-1*.changes
237
213
 
238
214
#. For final release versions, also copy it into the ``~bzr`` PPA::
239
215
 
240
 
     dput bzr-ppa ../bzr_1.17-1\~bazaar1\~hardy1\_source.changes
 
216
     dput bzr-ppa ../bzr_1.6-1\~bazaar1\~hardy1\_source.changes
241
217
 
242
218
   Alternatively, you can use Launchpad's "copy" feature to copy the
243
219
   packages between repositories.
251
227
Packaging bzr-svn
252
228
~~~~~~~~~~~~~~~~~
253
229
 
254
 
bzr-svn uses a packaging branch that contains both the source
 
230
bzr-svn uses a packaging branch that contains both the source 
255
231
(including any changes against upstream) and the ``debian/`` directory.
256
232
 
257
233
To build bzr-svn:
258
234
 
259
235
#. Get a checkout of ``lp:~bzr/bzr-svn/hardy-ppa/``
260
236
 
261
 
#. Merge from ``http://bzr.debian.org/pkg-bazaar/bzr-svn/unstable/``
262
 
 
 
237
#. Merge from ``http://bzr.debian.org/pkg-bazaar/bzr-svn/experimental/``
 
238
  
263
239
   This should bring in both upstream and packaging changes for the new
264
240
   release, and it's updated as part of the bzr-svn release process.
265
241
 
266
 
   It's quite possible you will need to resolve some conflicts.
267
 
 
268
242
#. Run ``dch -v 0.4.15-1~bazaar1-hardy1 -D hardy`` or similar
269
243
 
270
244
#. Run ``bzr builddeb --source``