~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/releasing.txt

  • Committer: Jelmer Vernooij
  • Date: 2012-02-28 10:06:39 UTC
  • mfrom: (6437.40.2 rmbranch-colo)
  • mto: This revision was merged to the branch mainline in revision 6482.
  • Revision ID: jelmer@samba.org-20120228100639-p5gndu91wuqwugti
Merge rmbranch-colo.

Show diffs side-by-side

added added

removed removed

Lines of Context:
225
225
 
226
226
   For beta releases use::
227
227
 
228
 
       version_info = (2, 1, 0, 'beta', SERIAL)
229
 
 
230
 
   For instance 2.1b1::
231
 
 
232
 
       version_info = (2, 1, 0, 'beta', 1)
 
228
       version_info = (2, 5, 0, 'beta', SERIAL)
 
229
 
 
230
   For instance 2.5b5::
 
231
 
 
232
       version_info = (2, 5, 0, 'beta', 5)
233
233
 
234
234
   For stable releases use::
235
235
 
236
 
       version_info = (2, 1, 2, 'final', 0)
 
236
       version_info = (2, 5, 0, 'final', 0)
237
237
 
238
238
#. Update the ``./doc/en/release-notes/`` section for this release.
239
239
 
240
240
   Check that all news entries related to this release have been added in
241
 
   the right section. For example, if you're releasing 2.5b2, the following
242
 
   command should display a a single chuk diff for the 2.5b2 release::
 
241
   the right section. For example, if you're releasing 2.5b5, the following
 
242
   command should display a a single chuk diff for the 2.5b5 release::
243
243
 
244
 
     bzr diff -rbzr-2.5b1.. doc/en/release-notes/bzr-2.5.txt
 
244
     bzr diff -rbzr-2.5b4.. doc/en/release-notes/bzr-2.5.txt
245
245
 
246
246
   Fill out the date and a description of the release under the existing
247
247
   header (the diff above will help you summarizing). If there isn't one,
248
248
   follow the instructions above for using the ``release-template.txt`` file
249
249
   and remind people that they should document their changes there ;)
250
250
 
251
 
   See *2.1.1* or similar for an example of what this looks like.
 
251
   See *2.5b5* or similar for an example of what this looks like.
252
252
 
253
253
#. Add or check the summary of the release into the "What's New" document.
254
254
 
270
270
 
271
271
     BZR_PLUGIN_PATH=-site make po/bzr.pot
272
272
 
273
 
   This is especially important for the final beta release which is
274
 
   when translations are frozen and translators are requested to make
275
 
   the translations.
 
273
   This is especially important for the final beta release which is when
 
274
   translations are frozen and translators are requested (see `The final
 
275
   beta - branching and translations`_) to make the translations.
276
276
 
277
277
#. For stable releases update the translations::
278
278
 
450
450
the *last* beta for a given ``x.y`` series (from trunk aka lp:bzr), you need
451
451
to setup *two* branches for the next cycle:
452
452
 
453
 
#. ``lp:bzr`` needs to be opened for the next *series* ``x.(y+1)``
 
453
#. ``lp:bzr`` needs to be opened for the next *series* ``x.(y+1)``.
454
454
 
455
455
#. ``lp:bzr/x.y`` needs to be opened for the next *release* ``x.y.0`` in the
456
456
   series. Since this is first real use of ``lp:bzr/x.y``, this is also the
466
466
 
467
467
In a nutshell:
468
468
 
469
 
#. Create or update the ``x.y`` PQM branch based on whatever
470
 
   revision you want to release
471
 
 
472
469
#. Open ``lp:bzr`` for ``x.(y+1)``
473
470
 
 
471
#. Create or update the ``x.y`` PQM branch based on whatever revision you
 
472
   want to release. Since it takes time to create the PQM branch for the new
 
473
   series you should plan to get it created a few days before you need it
 
474
   and seed it with the revision from trunk you want to base your release of
 
475
   (ask a LOSA for pulling this revision from trunk and pushing it to the
 
476
   series branch (``lp:bzr/x.y``) when you're ready).
 
477
 
474
478
#. Release ``x.y.0`` from ``lp:bzr/x.y``
475
479
 
476
480
#. Open ``lp:bzr/x.y`` for bug fixes
477
481
 
478
 
You also need to ensure Launchpad is set up to import/export
479
 
translations for the new branch and inform translators.
 
482
You also need to ensure Launchpad is set up to import/export translations
 
483
for the new branch and inform translators.
480
484
 
481
 
#. Push a branch::
 
485
#. Push the last beta release to a new branch::
482
486
 
483
487
     bzr push lp:~bzr-core/bzr/bzr-translations-export-x.y
484
488
 
581
585
   Feel free to tweak this to your taste.
582
586
 
583
587
#. Make an announcement through <https://launchpad.net/bzr/+announce>
 
588
   mentioning the milestone URL <https://launchpad.net/bzr/+milestone/x.y.z>
 
589
   so people get an easy access to details.
584
590
 
585
591
#. Announce on http://freecode.com/projects/bazaar-vcs
586
592