← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/releasing.txt

Merge lp:bzr.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/releasing.txt
27
27
#. Create a new series at <https://launchpad.net/bzr/+addseries>. There is one
28
28
   series for every *x.y* release.
29
29
 
30
 
#. Go to the series web page at <https://launchpad.net/bzr/2.0>
 
30
#. Go to the series web page at <https://launchpad.net/bzr/x.y>
31
31
 
32
32
#. Create a new release at
33
 
   <https://launchpad.net/bzr/2.0/+addrelease> and add
 
33
   <https://launchpad.net/bzr/x.y/+addrelease> and add
34
34
   information about this release. We will not use it yet, but it
35
35
   will be available for targeting or nominating bugs.
36
36
 
40
40
   general development continues on the trunk, and only
41
41
   specifically-targeted fixes go into the release branch.
42
42
 
43
 
#. Add milestones at <https://edge.launchpad.net/bzr/2.0/+addmilestone> to
 
43
#. Add milestones at <https://edge.launchpad.net/bzr/x.y/+addmilestone> to
44
44
   that series for the beta release, release candidate and the final release,
45
45
   and their expected dates.
46
46
 
59
59
 
60
60
When it's time to make the first beta release or release candidate:
61
61
 
62
 
#. Create a new milestone at <https://launchpad.net/bzr/2.0/+addmilestone>
63
 
   for the beta release or release candidate.
64
 
 
65
 
#. Make a beta release or release candidate.
 
62
#. Make a beta release or release candidate. The milestone for this
 
63
   candidate will already exist (see Starting a cycle above).
66
64
 
67
65
Preparing the tree for release
68
66
------------------------------
72
70
 
73
71
     bzr branch trunk prepare-1.14
74
72
 
75
 
#. Configure pqm-submit for this branch, with a section like this in
 
73
#. Configure pqm-submit for this branch, with a section like this (where
 
74
   x.y is the version to release).
76
75
   ``~/.bazaar/locations.conf``::
77
76
 
78
 
        [/home/mbp/bzr/prepare-1.14]
 
77
        [/home/mbp/bzr/prepare-x.y]
79
78
        pqm_email = Canonical PQM <pqm@bazaar-vcs.org>
80
 
        submit_branch = lp:bzr/2.0
81
 
        public_branch = http://bazaar.example.com/prepare-2.0
 
79
        submit_branch = http://bazaar.launchpad.net/~bzr-pqm/bzr/x.y
 
80
        public_branch = http://bazaar.example.com/prepare-x.y
82
81
        submit_to = bazaar@lists.canonical.com
83
82
        smtp_server = mail.example.com:25
84
83
 
174
173
  
175
174
     make dist
176
175
 
177
 
   This also makes a zip file, which is easier to access on Microsoft
178
 
   Windows.
179
 
 
180
176
#. Now we'll try expanding this tarball and running the test suite
181
177
   to check for packaging problems::
182
178
 
189
185
   failures.
190
186
 
191
187
 
 
188
Publishing the source tarball
 
189
-----------------------------
 
190
 
 
191
#. Go to the relevant milestone page in Launchpad.
 
192
 
 
193
#. Within that release, upload the source tarball and the GPG
 
194
   signature.  Or, if you prefer, use the
 
195
   ``tools/packaging/lp-upload-release`` script to do this.
 
196
 
 
197
 
 
198
Announcing the source freeze
 
199
----------------------------
 
200
 
 
201
#. Post to the ``bazaar`` list, saying that the source has been frozen.
 
202
   This is the cue for platform maintainers and plugin authors to update
 
203
   their code.  This is done before the general public announcement of the
 
204
   release.
 
205
 
 
206
 
192
207
Publishing the release
193
208
----------------------
194
209
 
195
 
Now you have the beta or releasable product.  The next step is making it
 
210
There is normally a delay of a few days after the source freeze to allow
 
211
for binaries to be built on various platforms.  Once they have been built,
 
212
we have a releasable product.  The next step is to make it generally
196
213
available to the world.
197
214
 
198
215
go to the release
201
218
   signature.  Or, if you prefer, use the
202
219
   ``tools/packaging/lp-upload-release`` script to do this.
203
220
 
204
 
#. Link from http://bazaar-vcs.org/Download to the tarball and signature.
205
 
 
206
 
#. Announce on the `Bazaar home page <http://bazaar-vcs.org/>`_.
 
221
#. Link from http://bazaar-vcs.org/SourceDownloads to the tarball and
 
222
   signature.
 
223
 
 
224
#. Announce on the `Bazaar website <http://bazaar-vcs.org/>`_.
 
225
   This page is edited via the lp:bzr-website branch. (Changes
 
226
   pushed to this branch are refreshed by a cron job on escudero.)
 
227
 
 
228
#. Announce on the `Bazaar wiki <http://bazaar-vcs.org/Welcome>`_.
207
229
 
208
230
#. Check that the documentation for this release is available in
209
231
   <http://doc.bazaar-vcs.org>.  It should be automatically build when the