~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/releasing.txt

  • Committer: Patch Queue Manager
  • Date: 2011-09-08 11:01:15 UTC
  • mfrom: (6123.1.16 gpg-typo)
  • Revision ID: pqm@cupuasso-20110908110115-gbb9benwkdksvzk5
(jelmer) Fix a typo (invalid format identifier) in an error message in
 bzrlib.gpg. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
244
244
   Released' or setting a different milestone if the bug hasn't been
245
245
   fixed). A few false positives may remain in the older series, don't let
246
246
   this slow you down too much. This script accepts options you may find
247
 
   useful, use ``./tools/check-newsbugs.py`` to display its usage (``-w``
248
 
   will open each bug in your browser for example).
249
 
 
250
 
#. For beta releases update the translation template::
251
 
 
252
 
     make -f po/bzr.pot
253
 
 
254
 
   This is especially important for the final beta release which is
255
 
   when translations are frozen and translators are requested to make
256
 
   the translations.
257
 
 
258
 
#. For stable releases update the translations::
259
 
 
260
 
     bzr merge lp:~bzr-core/bzr/bzr-translations-export-x.y
 
247
   useful, use ``./tools/check-newsbugs.py`` to display its usage.
261
248
 
262
249
#. Commit these changes to the release branch, using a command like::
263
250
 
419
406
You may also need to do `At the start of a series cycle`_ if you're starting
420
407
a new series.
421
408
 
422
 
The final beta - branching and translations
423
 
-------------------------------------------
424
 
 
425
409
A word of caution: the instructions above works well for all releases but
426
410
there is one special case that requires a bit more care: when you release
427
411
the *last* beta for a given ``x.y`` series (from trunk aka lp:bzr), you need
452
436
 
453
437
#. Open ``lp:bzr/x.y`` for bug fixes
454
438
 
455
 
You also need to ensure Launchpad is set up to import/export
456
 
translations for the new branch and inform translators.
457
 
 
458
 
#. Push a branch::
459
 
 
460
 
     bzr push lp:~bzr-core/bzr/bzr-translations-export-x.y
461
 
 
462
 
#. On the translations series synchronization settings page
463
 
   <https://translations.launchpad.net/bzr/x.y/+translations-settings>
464
 
   turn on ``Import template files`` then for exports click ``Choose a
465
 
   target branch`` and point it at the branch you just pushed.
466
 
 
467
 
#. E-mail translators to announce that the forthcoming stable release
468
 
   of bzr is ready for translations.  Send to
469
 
   ``translators@lists.launchpad.net`` and
470
 
   ``ubuntu-translators@lists.ubuntu.com``.
471
 
 
472
 
#. The series is now frozen for strings and API, see below for adding
473
 
   that to the announcement.
474
 
 
475
439
Announcing the source freeze
476
440
----------------------------
477
441
 
478
 
#. Post to the ``bazaar@lists.canonical.com`` list, saying that the source
479
 
   has been frozen (gone gold). Be extra clear that this is only a *source*
480
 
   release targeted at packagers and installer builders (see
481
 
   <https://bugs.launchpad.net/launchpad/+bug/645084>).  This is the cue for
482
 
   platform maintainers and plugin authors to update their code.  This is
483
 
   done before the general public announcement of the release.
 
442
#. Post to the ``bazaar`` list, saying that the source has been frozen
 
443
   (gone gold). Be extra clear that this is only a *source* release
 
444
   targeted at packagers and installer builders (see
 
445
   <https://bugs.launchpad.net/launchpad/+bug/645084>).  This is the cue
 
446
   for platform maintainers and plugin authors to update their code.  This
 
447
   is done before the general public announcement of the release. 
484
448
 
485
449
   The freeze announcement generally guess the date of the official public
486
450
   announcement, for the most recent stable series (the one supported by the
488
452
   the freeze. For older series supported only via SRUs for Ubuntu, we don't
489
453
   control the process as tightly so guessing the date is not appropriate.
490
454
 
491
 
   For the final beta release include in your announcement a notice of
492
 
   API and translation freezes nothing that public methods should not
493
 
   be removed or changed and strings should not be added or changed.
494
 
 
495
455
#. Pause for a few days. 
496
456
 
497
457
 
522
482
 
523
483
#. Make an announcement mail.
524
484
 
525
 
   For beta releases, this is sent to the ``bazaar@lists.canonical.com`` and
526
 
   ``bazaar-announce@lists.canonical.com`` lists.
 
485
   For beta releases, this is sent to the ``bazaar@lists.canonical.com``
 
486
   list only to inform plugin authors and people responsible for building
 
487
   packages or installers.
 
488
 
 
489
   Once the installers are available, the mail can be sent to the
 
490
   ``bazaar-announce`` list too.
527
491
 
528
492
   For stable releases (excluding SRUs which are for older stable releases),
529
493
   it should also be cc'd to ``info-gnu@gnu.org``,
539
503
      The Bazaar team is happy to announce availability of a new
540
504
      release of the bzr adaptive version control system.
541
505
 
542
 
      Bazaar <http://bazaar.canonical.com/> is a Canonical project and part
543
 
      of the GNU project <http://gnu.org/> to produce a free operating
544
 
      system.
 
506
      Bazaar <http://bazaar.canonical.com/> is part of the GNU project
 
507
      <http://gnu.org/> to produce a free operating system.
545
508
 
546
509
      <<Summary paragraph from news>>
547
510