← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/releasing.txt

  • Committer: Martin Pool
  • Date: 2010-10-15 10:19:25 UTC
  • mto: This revision was merged to the branch mainline in revision 5503.
  • Revision ID: mbp@sourcefrog.net-20101015101925-qr2m0i5sv6ad0bs2
Superstitious argument quoting in makefile

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/releasing.txt
93
93
   the release branch.
94
94
 
95
95
#. If you made a new series, add milestones at
96
 
   <https://launchpad.net/bzr/x.y/+addmilestone> to that series for
 
96
   <https://edge.launchpad.net/bzr/x.y/+addmilestone> to that series for
97
97
   the beta release, release candidate and the final release, and their
98
98
   expected dates.
99
99
 
100
 
#. Create a new milestone <https://launchpad.net/bzr/x.y/+addmilestone>
 
100
#. Create a new milestone <https://edge.launchpad.net/bzr/x.y/+addmilestone>
101
101
   and add information about this release.  We will not use it yet, but it
102
102
   will be available for targeting or nominating bugs.
103
103
 
195
195
 
196
196
     ./tools/check-newsbugs.py doc/en/release-notes/bzr-x.y.txt
197
197
 
198
 
   (As of 2011-12-03, only a few false positives remain. Don't let this slow
199
 
   you down too much.)
 
198
   (But note there will be many false positives, and this script may be
 
199
   flaky <https://bugs.edge.launchpad.net/bzr/+bug/354985>.  Don't let
 
200
   this slow you down too much.)
200
201
 
201
202
#. Commit these changes to the release branch, using a command like::
202
203
 
251
252
   appropriate release branch::
252
253
 
253
254
     bzr push
254
 
     bzr pqm-submit -m "(mbp) Release 1.14 (Martin Pool)"
 
255
     bzr pqm-submit -m "(mbp) prepare 1.14"
255
256
 
256
257
   Or with hydrazine::
257
258
 
271
272
#. Now we'll try expanding this tarball and running the test suite
272
273
   to check for packaging problems::
273
274
 
274
 
     make check-dist-tarball | subunit2pyunit
 
275
     make check-dist-tarball
275
276
 
276
 
   You may encounter failures while running the test suite caused by your
277
 
   locally installed plugins. Use your own judgment to decide if you can
278
 
   release with these failures. When in doubt, disable the faulty plugins
279
 
   one by one until you get no more failures. Alternatively, you can use
280
 
   ``BZR_DISABLE_PLUGINS`` or ``BZR_PLUGIN_PATH=-site`` to disable one or
281
 
   all plugins.
 
277
   You may encounter failures while running the test suite caused
 
278
   by your locally installed plugins. Use your own judgment to
 
279
   decide if you can release with these failures. When in doubt,
 
280
   disable the faulty plugins one by one until you get no more
 
281
   failures.
282
282
 
283
283
   Remember that PQM has just tested everything too, this step is
284
284
   particularly testing that the pyrex extensions, which are updated
374
374
      feedback.
375
375
 
376
376
      Bazaar is now available for download from
377
 
      https://launchpad.net/bzr/x.y/x.y.z/ as a source tarball; packages
 
377
      https://launchpad.net/bzr/2.x/2.x/ as a source tarball; packages
378
378
      for various systems will be available soon.
379
379
 
380
380
      <<release notes from this release back to the last major release>>
392
392
   releases. If you do not have a Freshmeat account yet, ask one of the
393
393
   existing admins.
394
394
 
395
 
   The purpose here is to point users to the latest stable release while still
396
 
   publishing announcements for development releases.
397
 
 
398
 
   There are several kinds of modifications that could be done there via the
399
 
   ``Administration`` box in the lower right area of the page:
400
 
 
401
 
   * Edit the project: This is where most of the URLs proposed in the
402
 
     ``Links`` box are edited. This should rarely change except for the URLs
403
 
     related to the latest stable release.
404
 
 
405
 
   * New announcement: When doing a release (beta, candidates, final), put the
406
 
     summary of the release (you can't embed URLs there, the moderation staff
407
 
     remove them). Users can still access the releases notes via the ``Release
408
 
     Notes`` URL in the ``Links`` box in the upper right area of the page.
409
 
 
410
 
   * Set direct download: When releasing a new stable release, this should
411
 
     point to the corresponding launchpad page:
412
 
     <https://launchpad.net/bzr/x.y/x.y.z/>
413
 
 
414
395
#. Update `<http://en.wikipedia.org/wiki/Bazaar_(software)>`_ -- this should
415
396
   be done for final releases but not for beta releases or Release Candidates.
416
397