/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/developers/ppa.txt

  • Committer: Andrew Bennetts
  • Date: 2008-10-27 06:14:45 UTC
  • mfrom: (3793 +trunk)
  • mto: This revision was merged to the branch mainline in revision 3795.
  • Revision ID: andrew.bennetts@canonical.com-20081027061445-eqt9lz6uw1mbvq4g
Merge from bzr.dev.

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
 
85
85
 
86
86
* You need a Ubuntu (or probably Debian) machine, and ::
87
87
 
88
 
    sudo apt-get install build-essential devscripts dput quilt patch libcrypt-ssleay-perl debhelper cdbs python-docutils
89
 
 
90
 
  Please update this document if you encounter unmet dependencies or find a
91
 
  shorter way to express them.
 
88
    sudo apt-get install build-essential devscripts dput quilt patch
92
89
 
93
90
* You will also want to have the `bzr-builddeb`_ plugin installed, which
94
91
  depends on `bzrtools`_.
107
104
release packages is as simple as::
108
105
 
109
106
  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"
 
107
  export UBUNTU_RELEASES="dapper feisty gutsy hardy intrepid"
113
108
  ~/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.
 
109
  ~/dev/bzr/bzr.dev/tools/packaging/update-changelogs.sh 1.6~beta3-1~bazaar1
 
110
  ~/dev/bzr/bzr.dev/tools/packaging/build-packages
 
111
  dput bzr-beta-ppa bzr_1.6~beta3-1~bazaar1*.changes
120
112
 
121
113
Long Form
122
114
~~~~~~~~~
123
115
 
124
116
#. You will end up checking out a separate directory for each supported
125
 
   release. Such as ``~/dev/bzr/releases/packaging/hardy``. In each of these
126
 
   branches, you will produce the package for the release.
127
 
 
128
 
   The scripts will also create the branches and produce packages for
129
 
   bzrtools and bzr-svn.
 
117
   release. Such as ``~/dev/bzr/releases/packaging/hardy``
130
118
 
131
119
#. Decide on the final version number.  It should be of this form::
132
120
 
133
 
     bzr-1.17~rc1-1~bazaar1~hardy1
 
121
     bzr-1.6~beta3-1~bazaar1~hardy1
134
122
 
135
123
   **Note:** There are three hyphen-separated parts: the *package name*,
136
124
   the *upstream version*, and the *packaging version*.
137
125
 
138
126
   **Caution:** Upstream betas or release candidates must insert a tilde
139
127
   to make them sort before the final release, like this:
140
 
   ``bzr-1.17~rc1-1~bazaar1~hardy1``.
 
128
   ``bzr-1.6~beta3-1~bazaar1~hardy1``.
141
129
 
142
130
   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"
 
131
   ``bzr-1.6-1~bazaar1~hardy1``
148
132
 
149
133
#. Export the distroreleases that you will be packaging for::
150
134
 
151
 
      export UBUNTU_RELEASES="dapper hardy intrepid jaunty karmic"
152
 
 
153
 
#. Export the program you are packaging::
154
 
 
155
 
      export PACKAGE="bzr"
 
135
      export UBUNTU_RELEASES="dapper feisty gutsy hardy intrepid"
156
136
 
157
137
#. Checkout (or update) the packaging branch for each supported release::
158
138
 
170
150
 
171
151
   For bzrtools this is typically::
172
152
 
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
 
153
      Build-Depends-Indep: bzr (>= 1.6~), rsync
 
154
      Depends: ${python:Depends}, bzr (>= 1.6~), bzr (<< 1.7~), patch
185
155
 
186
156
#. Make a new ``debian/changelog`` entry for the new release,
187
157
   either by using ``dch`` or just editing the file::
188
158
 
189
 
      dch -v '1.17~rc1-1~bazaar1~hardy1' -D hardy
 
159
      dch -v '1.6~beta3-1~bazaar1~hardy1' -D hardy
190
160
 
191
161
   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
 
162
   against the version number (which is just our convention), so make sure 
193
163
   to specify it.
194
164
 
195
 
   Make sure you have the correct email address for yourself (you may need
196
 
   export DEBEMAIL=`bzr whoami` if it isn't already set), version number, and
197
 
   distribution.  It should look something like this::
198
 
 
199
 
       bzr (1.17~rc1-1~bazaar1~hardy1) hardy; urgency=low
200
 
 
 
165
   Make sure you have the correct email address for yourself, version
 
166
   number, and distribution.  It should look something like this::
 
167
 
 
168
       bzr (1.6~beta3-1~bazaar1~hardy1) hardy; urgency=low
 
169
     
201
170
        * New upstream release.
202
 
 
 
171
     
203
172
       -- John Sample <sample@example.com>  Mon, 31 Mar 2008 12:36:27 +1100
204
173
 
205
174
   If you need to upload the package again to fix a problem, normally you
210
179
 
211
180
   You will also want to commit these changes into the packaging branch.
212
181
 
213
 
   There is a helper script which will build all the packages
 
182
   There is a helper script which will update the changelog and commit it
214
183
   for all of your ``$UBUNTU_RELEASES``. It is available as::
215
184
 
216
185
      tools/packaging/update-changelogs.sh
217
186
 
 
187
   You must supply the release string, such as::
 
188
 
 
189
      tools/packaging/update-changelogs.sh 1.6~beta3-1~bazaar1
 
190
 
 
191
   It will automatically append the distro numbering on the end.
 
192
 
218
193
#. Build the source packages::
219
194
 
220
195
      cd packaging-$DISTRO; bzr builddeb -S
226
201
 
227
202
   where ``$UID`` is the gpg key you want to use to sign the changes.
228
203
 
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
204
#. Upload into the beta PPA for each release::
235
205
 
236
 
     dput bzr-beta-ppa bzr*1.17-1*.changes
 
206
     dput bzr-beta-ppa bzr_1.6-1*.changes
237
207
 
238
208
#. For final release versions, also copy it into the ``~bzr`` PPA::
239
209
 
240
 
     dput bzr-ppa ../bzr_1.17-1\~bazaar1\~hardy1\_source.changes
 
210
     dput bzr-ppa ../bzr_1.6-1\~bazaar1\~hardy1\_source.changes
241
211
 
242
212
   Alternatively, you can use Launchpad's "copy" feature to copy the
243
213
   packages between repositories.
248
218
   <https://launchpad.net/~bzr-beta-ppa/+archive/+builds>.
249
219
 
250
220
 
251
 
Packaging bzr-svn
252
 
~~~~~~~~~~~~~~~~~
253
 
 
254
 
bzr-svn uses a packaging branch that contains both the source
255
 
(including any changes against upstream) and the ``debian/`` directory.
256
 
 
257
 
To build bzr-svn:
258
 
 
259
 
#. Get a checkout of ``lp:~bzr/bzr-svn/hardy-ppa/``
260
 
 
261
 
#. Merge from ``http://bzr.debian.org/pkg-bazaar/bzr-svn/unstable/``
262
 
 
263
 
   This should bring in both upstream and packaging changes for the new
264
 
   release, and it's updated as part of the bzr-svn release process.
265
 
 
266
 
   It's quite possible you will need to resolve some conflicts.
267
 
 
268
 
#. Run ``dch -v 0.4.15-1~bazaar1-hardy1 -D hardy`` or similar
269
 
 
270
 
#. Run ``bzr builddeb --source``
271
 
 
272
 
   bzr-builddeb will automatically check out the appropriate tag from the
273
 
   main branch of bzr-svn, build, and package it.
274
 
 
275
 
#. ``dput bzr-beta-ppa ../bzr-svn_0.4.15-1~bazaar1~hardy1_source.changes``
276
 
 
277
 
 
278
221
Monitoring the contents of PPAs
279
222
-------------------------------
280
223