/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/releasing.txt

  • Committer: Vincent Ladeuil
  • Date: 2011-07-06 09:22:00 UTC
  • mfrom: (6008 +trunk)
  • mto: (6012.1.1 trunk)
  • mto: This revision was merged to the branch mainline in revision 6013.
  • Revision ID: v.ladeuil+lp@free.fr-20110706092200-7iai2mwzc0sqdsvf
Merging in trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/releasing.txt
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
   As of 2011-05-26, only a few false positives remain in the older
 
199
   series. Don't let this slow you down too much. This script accepts
 
200
   options you may find useful, use ``./tools/check-newsbugs.py`` to display
 
201
   its usage.
200
202
 
201
203
#. Commit these changes to the release branch, using a command like::
202
204
 
203
 
     bzr commit -m "Release 1.14."
 
205
     bzr commit -m "Release 2.3.1"
204
206
 
205
207
   The diff before you commit will be something like::
206
208
 
207
 
     === modified file 'NEWS'
208
 
     --- NEWS        2008-09-17 23:09:18 +0000
209
 
     +++ NEWS        2008-09-23 16:14:54 +0000
210
 
     @@ -4,6 +4,23 @@
211
 
 
212
 
      .. contents::
213
 
 
214
 
     +bzr 1.7 2008-09-23
215
 
     +------------------
216
 
     +
217
 
     +This release includes many bug fixes and a few performance and feature
218
 
     +improvements.  ``bzr rm`` will now scan for missing files and remove them,
219
 
     +like how ``bzr add`` scans for unknown files and adds them. A bit more
220
 
     +polish has been applied to the stacking code. The b-tree indexing code has
221
 
     +been brought in, with an eye on using it in a future repository format.
222
 
     +There are only minor installer changes since bzr-1.7rc2.
223
 
     +
224
 
      bzr 1.7rc2 2008-09-17
225
 
      ---------------------
226
 
 
227
 
 
228
 
     === modified file 'bzrlib/__init__.py'
229
 
     --- bzrlib/__init__.py  2008-09-16 21:39:28 +0000
230
 
     +++ bzrlib/__init__.py  2008-09-23 16:14:54 +0000
231
 
     @@ -41,7 +41,7 @@
232
 
      # Python version 2.0 is (2, 0, 0, 'final', 0)."  Additionally we use a
233
 
      # releaselevel of 'dev' for unreleased under-development code.
234
 
 
235
 
     -version_info = (1, 7, 0, 'candidate', 2)
236
 
     +version_info = (1, 7, 0, 'final', 0)
237
 
 
238
 
 
239
 
      # API compatibility version: bzrlib is currently API compatible with 1.7.
240
 
 
241
 
   Note that the NEWS file formatting has evolved, this example needs to
242
 
   be updated.
 
209
      === modified file 'bzrlib/__init__.py'
 
210
      --- bzrlib/__init__.py    2011-02-09 06:35:00 +0000
 
211
      +++ bzrlib/__init__.py    2011-03-10 10:24:47 +0000
 
212
      @@ -52,7 +52,7 @@
 
213
       # Python version 2.0 is (2, 0, 0, 'final', 0)."  Additionally we use a
 
214
       # releaselevel of 'dev' for unreleased under-development code.
 
215
       
 
216
      -version_info = (2, 3, 1, 'dev', 0)
 
217
      +version_info = (2, 3, 1, 'final', 0)
 
218
       
 
219
       # API compatibility version
 
220
       api_minimum_version = (2, 3, 0)
 
221
      
 
222
      === modified file 'doc/en/release-notes/bzr-2.3.txt'
 
223
      --- doc/en/release-notes/bzr-2.3.txt      2011-03-09 08:30:16 +0000
 
224
      +++ doc/en/release-notes/bzr-2.3.txt      2011-03-10 10:40:47 +0000
 
225
      @@ -8,23 +8,10 @@
 
226
       bzr 2.3.1
 
227
       #########
 
228
       
 
229
      -:2.3.1: NOT RELEASED YET
 
230
      -
 
231
      -External Compatibility Breaks
 
232
      -*****************************
 
233
      -
 
234
      -.. These may require users to change the way they use Bazaar.
 
235
      -
 
236
      -New Features
 
237
      -************
 
238
      -
 
239
      -.. New commands, options, etc that users may wish to try out.
 
240
      -
 
241
      -Improvements
 
242
      -************
 
243
      -
 
244
      -.. Improvements to existing commands, especially improved performance 
 
245
      -   or memory usage, or better results.
 
246
      +:2.3.1: 2011-03-10
 
247
      +
 
248
      +This is a bugfix release. Upgrading is recommended for all users of earlier
 
249
      +2.3 releases.
 
250
       
 
251
       Bug Fixes
 
252
       *********
 
253
      
 
254
      === modified file 'doc/en/whats-new/whats-new-in-2.3.txt'
 
255
      --- doc/en/whats-new/whats-new-in-2.3.txt 2011-02-03 16:29:18 +0000
 
256
      +++ doc/en/whats-new/whats-new-in-2.3.txt 2011-03-10 11:10:36 +0000
 
257
      @@ -17,8 +17,13 @@
 
258
       improvements made to the core product, it highlights enhancements within the
 
259
       broader Bazaar world of potential interest to those upgrading.
 
260
       
 
261
      -Bazaar 2.3.0 is fully compatible both locally and on the network with 2.0 2.1,
 
262
      -and 2.2, and can read and write repositories generated by all previous
 
263
      +Bazaar 2.3.1 includes all the fixes in the un-released 2.0.7, 2.1.4 and 2.2.5
 
264
      +versions that weren't included in 2.3.0 and fixes some bugs on its own.
 
265
      +
 
266
      +See the :doc:`../release-notes/index` for details.
 
267
      +
 
268
      +Bazaar 2.3 is fully compatible both locally and on the network with 2.0, 2.1,
 
269
      +and 2.2. It can read and write repositories generated by all previous
 
270
       versions.
 
271
       
 
272
       Changed Behaviour
 
273
      
243
274
 
244
275
#. Tag the new release::
245
276
 
246
 
     bzr tag bzr-1.14
 
277
     bzr tag bzr-2.3.1
247
278
 
248
279
#. Push those changes to a bzr repository that is public and accessible on
249
280
   the Internet. PQM will pull from this repository when it attempts to merge
251
282
   appropriate release branch::
252
283
 
253
284
     bzr push
254
 
     bzr pqm-submit -m "(mbp) Release 1.14 (Martin Pool)"
 
285
     bzr pqm-submit -m "(vila) Release 2.3.1 (Vincent Ladeuil)"
255
286
 
256
287
   Or with hydrazine::
257
288
 
289
320
Publishing the source tarball
290
321
-----------------------------
291
322
 
292
 
#. Go to the relevant milestone page in Launchpad.
 
323
#. Go to the relevant series page in Launchpad.
293
324
 
294
325
#. Create a release of the milestone, and upload the source tarball and
295
326
   the GPG signature.  Or, if you prefer, use the
337
368
#. Check that the documentation for this release is available in
338
369
   <http://doc.bazaar.canonical.com>.  It should be automatically build when the
339
370
   branch is created, by a cron script ``update-bzr-docs`` on
340
 
   ``escudero``. As of today (2009-08-27) ``igc`` manually updates the
341
 
   pretty version of it.
 
371
   ``escudero``.
342
372
 
343
373
 
344
374
Announcing the release
405
435
   * New announcement: When doing a release (beta, candidates, final), put the
406
436
     summary of the release (you can't embed URLs there, the moderation staff
407
437
     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.
 
438
     Notes`` URL in the ``Links`` box in the upper right area of the
 
439
     page. When doing the first stable release in a series, delete the
 
440
     ``Unstable installers`` <https://launchpad.net/bzr/x.y/x.ybn> and
 
441
     ``Unstable source tarball``
 
442
     <http://launchpad.net/bzr/x.y/x.ybn/+download/bzr-x.ybn.tar.gz>
 
443
     links. Conversely, when creating the first beta in a development series,
 
444
     create these links again. Check all links when doing other kinds of
 
445
     release.
409
446
 
410
447
   * Set direct download: When releasing a new stable release, this should
411
448
     point to the corresponding launchpad page: