~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/release-notes/bzr-2.4.txt

  • Committer: Ian Clatworthy
  • Date: 2007-08-10 05:17:09 UTC
  • mto: (2733.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 2734.
  • Revision ID: ian.clatworthy@internode.on.net-20070810051709-0rnxlur94samh192
move most existing topics into the User Guide dir for English

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
####################
2
 
Bazaar Release Notes
3
 
####################
4
 
 
5
 
.. toctree::
6
 
   :maxdepth: 1
7
 
 
8
 
bzr 2.4.0
9
 
#########
10
 
 
11
 
:2.4.0: NOT RELEASED YET
12
 
 
13
 
External Compatibility Breaks
14
 
*****************************
15
 
 
16
 
.. These may require users to change the way they use Bazaar.
17
 
 
18
 
New Features
19
 
************
20
 
 
21
 
.. New commands, options, etc that users may wish to try out.
22
 
 
23
 
Improvements
24
 
************
25
 
 
26
 
.. Improvements to existing commands, especially improved performance 
27
 
   or memory usage, or better results.
28
 
 
29
 
Bug Fixes
30
 
*********
31
 
 
32
 
.. Fixes for situations where bzr would previously crash or give incorrect
33
 
   or undesirable results.
34
 
 
35
 
Documentation
36
 
*************
37
 
 
38
 
.. Improved or updated documentation.
39
 
 
40
 
API Changes
41
 
***********
42
 
 
43
 
.. Changes that may require updates in plugins or other code that uses
44
 
   bzrlib.
45
 
 
46
 
Internals
47
 
*********
48
 
 
49
 
.. Major internal changes, unlikely to be visible to users or plugin 
50
 
   developers, but interesting for bzr developers.
51
 
 
52
 
Testing
53
 
*******
54
 
 
55
 
.. Fixes and changes that are only relevant to bzr's test framework and 
56
 
   suite.  This can include new facilities for writing tests, fixes to 
57
 
   spurious test failures and changes to the way things should be tested.
58
 
 
59
 
* `BranchBuilder.build_snapshot` now supports a "flush" action.  This
60
 
  cleanly and reliably allows tests using `BranchBuilder` to construct
61
 
  branches that e.g. rename files out of a directory and unversion that
62
 
  directory in the same revision.  Previously some changes were impossible
63
 
  due to the order that `build_snapshot` performs its actions.
64
 
  (Andrew Bennetts)
65
 
 
66
 
* `TestCaseWithMemoryTransport` is faster now: `_check_safety_net` now
67
 
  just compares the bytes in the dirstate file to its pristine state,
68
 
  rather than opening the WorkingTree and calling ``last_revision()``.
69
 
  This reduces the overall test suite time by about 10% on my laptop.
70
 
  (Andrew Bennetts)
71
 
 
72
 
 
73
 
bzr 2.4b5
74
 
#########
75
 
 
76
 
:2.4b5: 2011-07-07
77
 
 
78
 
This is the fifth (and last) beta of the 2.4 series leading to
79
 
2.4.0 release in Auguest 2011. Beta releases are suitable for
80
 
everyday use but may cause some incompatibilities with plugins.
81
 
 
82
 
This release includes all bug fixed in previous series known at
83
 
the time of this release.
84
 
 
85
 
External Compatibility Breaks
86
 
*****************************
87
 
 
88
 
None.
89
 
 
90
 
New Features
91
 
************
92
 
 
93
 
* New command ``verify-signatures`` to check if all commits or specified commits
94
 
  have digital signatures from trusted keys.  Requires python-gpgme to be
95
 
  installed.
96
 
 
97
 
* New option ``--signatures`` for ``bzr log`` to display digital signature
98
 
  verification results for each commit.
99
 
 
100
 
* Config option acceptable_keys to list which GPG keys are verified as trusted.
101
 
 
102
 
* Config option validate_signatures_in_log to always show signatures in 
103
 
  ``bzr log``.
104
 
 
105
 
Improvements
106
 
************
107
 
 
108
 
* ``Branch.open`` is now about 3x faster (about 2ms instead of 6.5ms).
109
 
  (Andrew Bennetts).
110
 
 
111
 
Bug Fixes
112
 
*********
113
 
 
114
 
* Display a proper error message when a config file content cannot be
115
 
  decoded as UTF-8 or when it cannot be parsed.
116
 
  (Vincent Ladeuil, #502060, #688677, #797246)
117
 
 
118
 
* Generate a single conflict (instead of two) when merging a branch
119
 
  modifying and renaming a file in a branch that deleted it (or vice-versa).
120
 
  (Vincent Ladeuil, #688101)
121
 
 
122
 
* Give a more helpful message when the bzr executable doesn't match the
123
 
  library.  (This typically happens because of a misconfigured PYTHONPATH
124
 
  or half-installed bzr.)  
125
 
  (Martin Pool, #804553)
126
 
 
127
 
* Properly load utf8-encoded config files. (Vincent Ladeuil, #799212)
128
 
 
129
 
* ``GraphThunkIdsToKeys.merge_sort`` now properly returns
130
 
  keys rather than ids. (Jelmer Vernooij, #799677)
131
 
 
132
 
* ``TreeTransformBase.fixup_new_roots`` can now check that a tree root
133
 
  is present. (Jelmer Vernooij, #801257)
134
 
 
135
 
API Changes
136
 
***********
137
 
 
138
 
* New attributes ``WorkingTreeFormat.supports_versioned_directories`` and
139
 
  ``RepositoryFormat.supports_versioned_directories``.
140
 
  (Jelmer Vernooij, #765815)
141
 
 
142
 
* The "revno" field type when using the python version-info format is now
143
 
  a string (to handle dotted revnos) (Benoît Pierre, #796259)
144
 
 
145
 
Internals
146
 
*********
147
 
 
148
 
* Start implementing localization, starting with command help text (but not
149
 
  the command options themselves). This will allow bootstrapping the bzr
150
 
  internationalization process. (Inada Naoki)
151
 
 
152
 
Testing
153
 
*******
154
 
 
155
 
* Fix test failures when running as a homeless user (debian buildd). Tests
156
 
  leaking into ``${HOME}/.bzr.log`` should be detected properly now.
157
 
  (Vincent Ladeuil, #798698)
158
 
 
159
 
bzr 2.4b4
160
 
#########
161
 
 
162
 
:2.4b4: 2011-06-16
163
 
 
164
 
This is the fourth beta of the 2.4 series, leading to a 2.4.0 release in
165
 
August 2011. Beta releases are suitable for everyday use but may cause some
166
 
incompatibilities with plugins.
167
 
 
168
 
This release includes all bug fixed in previous series known at the time of
169
 
this release.
170
 
 
171
 
 
172
 
External Compatibility Breaks
173
 
*****************************
174
 
 
175
 
.. These may require users to change the way they use Bazaar.
176
 
 
177
 
* Do not treat configuration option 'check_signatures = require' as if
178
 
  it were 'create_signatures = always' (Jonathan Riddell)
179
 
 
180
 
New Features
181
 
************
182
 
 
183
 
.. New commands, options, etc that users may wish to try out.
184
 
 
185
 
* Hooks have been added for config stacks: ``get``, ``set`` and ``remove``
186
 
  are called when an option is respectively read, modified or deleted. Also
187
 
  added ``load`` and ``save`` hooks for config stores, called when the
188
 
  stores are loaded or saved.  (Vincent Ladeuil)
189
 
 
190
 
* New hook server_exception in bzrlib.smart.server to catch any
191
 
  exception caused while running bzr serve.
192
 
  (Jonathan Riddell, #274578)
193
 
 
194
 
* New hook set_commit_message in bzrlib.msgeditor to set a commit message
195
 
  and revision properties.  (Jonathan Riddell, #274578)
196
 
 
197
 
* Support ``-S`` as an alias for ``--short`` for the ``log`` and
198
 
  ``missing`` commands. (Martin von Gagern, #38655)
199
 
 
200
 
Improvements
201
 
************
202
 
 
203
 
.. Improvements to existing commands, especially improved performance 
204
 
   or memory usage, or better results.
205
 
 
206
 
* ``bzr annotate`` can be run without setting whoami data first.
207
 
  (Jonathan Riddell, #667408)
208
 
 
209
 
Bug Fixes
210
 
*********
211
 
 
212
 
.. Fixes for situations where bzr would previously crash or give incorrect
213
 
   or undesirable results.
214
 
 
215
 
* Bazaar can now detect when a lock file is held by a dead process
216
 
  originating from the same machine, and steal the lock after printing a
217
 
  message to the user.  This is off by default, for safety, but can be
218
 
  turned on by setting the configuration variable ``locks.steal_dead`` to
219
 
  ``True``.
220
 
  (Martin Pool, #220464)
221
 
 
222
 
* ``bzr version-info`` now works when the tree is on a dotted revno.
223
 
  (Benoît Pierre, #796259)
224
 
 
225
 
* Credentials in the log output produced by ``-Dhttp`` are masked so users
226
 
  can more freely post them in bug reports. (Vincent Ladeuil, #723074)
227
 
 
228
 
* Fix a race condition for ``server_started`` hooks leading to a spurious
229
 
  test failure. (Vincent Ladeuil, #789167)
230
 
 
231
 
* Fix exporting subdirectory with ``--per-file-timestamps``.
232
 
  (Szilveszter Farkas, #795557)
233
 
 
234
 
* Handle files that get created but don't get used during TreeTransform.
235
 
  ``open()`` can create a file, and still raise an exception before it
236
 
  returns. So anything we might have created, make sure we destroy during
237
 
  ``finalize()``. (Martin [gz], #597686)
238
 
 
239
 
* ``pack_repo`` now uses ``Transport.move`` instead of
240
 
  ``Transport.rename``, deleting any existing targets even on SFTP.
241
 
  (Martin von Gagern, #421776)
242
 
 
243
 
* Pass the ``build_mo`` command to the rest of the setup() calls in
244
 
  setup.py. The ``bdist_wininst`` and ``py2exe`` code paths were failing
245
 
  because ``build_mo`` became a required step that they didn't know about.
246
 
  (John Arbash Meinel, #787122)
247
 
 
248
 
* Preserve existing ``root-id`` when merging an unrelated branch.
249
 
  (Aaron Bentley, #806356)
250
 
 
251
 
* Properly avoid re-adding a file after it changes case on CICP
252
 
  filesystems. (John Arbash Meinel, #798130)
253
 
 
254
 
* Reports the original error when an InvalidHttpResponse exception is
255
 
  encountered to facilitate debug. (Vincent Ladeuil, #788530)
256
 
 
257
 
* Reports a non-existant file error when trying to merge in a file
258
 
  that does not exist. (Jonathan Riddell, #330063)
259
 
 
260
 
* ``UIFactory.prompt``, ``UIFactory.get_username``,
261
 
  ``UIFactory.get_password`` and ``UIFactory.get_boolean`` now require a
262
 
  unicode prompt to be passed in. (Jelmer Vernooij, #592083)
263
 
 
264
 
* Support merging into the empty tree. (Aaron Bentley, #595328)
265
 
 
266
 
Documentation
267
 
*************
268
 
 
269
 
.. Improved or updated documentation.
270
 
 
271
 
* Improve documentation of ``bzr merge --force``.
272
 
  (Neil Martinsen-Burrell, #767307)
273
 
 
274
 
* Make docs for configuration options for digital signatures match 
275
 
  reality. (Jonathan Riddell)
276
 
 
277
 
* Add user-guide page on GPG signatures. (Jonathan Riddell)
278
 
 
279
 
API Changes
280
 
***********
281
 
 
282
 
.. Changes that may require updates in plugins or other code that uses
283
 
   bzrlib.
284
 
 
285
 
* Checking for a file id in a `Tree` or `Inventory` using ``in`` is now
286
 
  deprecated.  Instead, use `has_id`.
287
 
  (Martin Pool)
288
 
 
289
 
* Exporters are now all exposed as generators, rather than as single-call
290
 
  functions, so that calling code can take stream the output.
291
 
  (Xaav, Martin Pool)
292
 
 
293
 
* Information about held lockdir locks returned from eg `LockDir.peek` is
294
 
  now represented as a `LockHeldInfo` object, rather than a plain
295
 
  Python dict.
296
 
  (Martin Pool)
297
 
 
298
 
* Remove `file_status` function.
299
 
  (Martin Pool)
300
 
 
301
 
* ``Repository.iter_reverse_revision_history`` is now deprecated.
302
 
  Use ``Graph.iter_lefthand_ancestry`` instead.
303
 
  (Jelmer Vernooij, #739481)
304
 
 
305
 
* ``Repository.get_ancestry`` has been deprecated. Use
306
 
  ``Graph.iter_ancestry`` instead.
307
 
  (Jelmer Vernooij, #784511)
308
 
 
309
 
Internals
310
 
*********
311
 
 
312
 
.. Major internal changes, unlikely to be visible to users or plugin 
313
 
   developers, but interesting for bzr developers.
314
 
 
315
 
* ``tools/check-newsbugs.py`` accepts a ``--browser`` option to open
316
 
  corresponding launchpad pages in a browser. (Vincent Ladeuil)
317
 
 
318
 
Testing
319
 
*******
320
 
 
321
 
.. Fixes and changes that are only relevant to bzr's test framework and 
322
 
   suite.  This can include new facilities for writing tests, fixes to 
323
 
   spurious test failures and changes to the way things should be tested.
324
 
 
325
 
* A `ImportTariffTestCase` base class has been added in
326
 
  ``bzrlib.tests.test_import_tariff``, which can be used for import tariff
327
 
  tests in plugins. (Jelmer Vernooij, #793465)
328
 
 
329
 
* Fix deadlock in `TestImportTariffs.test_simple_serve` when stderr gets
330
 
  more output than fits in the default buffer.  This was happening on the
331
 
  Windows buildslave, and could easily happen in other circumstances where
332
 
  the default OS buffer size for pipes is small or the ``python -v``
333
 
  output is large.  (Andrew Bennetts, #784802)
334
 
 
335
 
* Fix spurious test failure on OSX for WorkingTreeFormat2.
336
 
  (Vincent Ladeuil, #787942)
337
 
 
338
 
* Re-target ``bb.test_merge.TestMerge.test_merge_reversed_revision_range``
339
 
  and rewrite it as a parameterized test to avoid unrelated failures.
340
 
  (Vincent Ladeuil, #795456)
341
 
 
342
 
* Show log file contents from subprocesses started by
343
 
  `start_bzr_subprocess` in test failure details.  This may help diagnose
344
 
  strange hangs and failures involving subprocesses.  (Andrew Bennetts)
345
 
 
346
 
* Skip ``utextwrap`` tests when ``sphinx`` breaks text_wrap by an hostile
347
 
  monkeypatch to textwrap.TextWrapper.wordsep_re.
348
 
  (Vincent Ladeuil, #785098)
349
 
 
350
 
* Multiple ``selftest --exclude`` options are now combined instead of
351
 
  overriding each other. (Vincent Ladeuil, #746991)
352
 
 
353
 
* Restore some ``FTPTransport`` test coverage by allowing ``pyftpdlib
354
 
  0.6.0`` to be used. Also restore ``medusa`` support while leaving it
355
 
  disabled to make it easier to use if/when we can in the future.
356
 
  (Vincent Ladeuil, #781140)
357
 
 
358
 
* `TestImportTariffs` no longer uses the real ``$HOME``.  This prevents it
359
 
  from polluting ``$HOME/.bzr.log`` or being accidentally influenced by
360
 
  user configuration such as aliases.  It still runs with all the user's
361
 
  plugins enabled, as intended.
362
 
  (Vincent Ladeuil, Andrew Bennetts, #789505)
363
 
 
364
 
 
365
 
bzr 2.4b3
366
 
#########
367
 
 
368
 
:2.4b3: 2011-05-26
369
 
 
370
 
This is the third beta of the 2.4 series, leading to a 2.4.0 release in
371
 
August 2011. Beta releases are suitable for everyday use but may cause some
372
 
incompatibilities with plugins.
373
 
 
374
 
This release includes all bug fixed in previous series known at the time of
375
 
this release.
376
 
 
377
 
 
378
 
External Compatibility Breaks
379
 
*****************************
380
 
 
381
 
.. These may require users to change the way they use Bazaar.
382
 
 
383
 
* ``bzr-2.4`` has officially dropped support for python2.4 and python2.5.
384
 
  We will continue to maintain ``bzr-2.3`` for people who still need to
385
 
  use those versions of python. (John Arbash Meinel)
386
 
 
387
 
New Features
388
 
************
389
 
 
390
 
.. New commands, options, etc that users may wish to try out.
391
 
 
392
 
* The text compressor used for 2a repositories now has a tweakable
393
 
  parameter that can be set in bazaar.conf.
394
 
  ``bzr.groupcompress.max_entries_per_source`` default of 65536.
395
 
  When doing compression, we build up an index of locations to match
396
 
  against. Setting this higher will result in slightly better compression,
397
 
  at a cost of more memory. Note that a value of 65k represents fully
398
 
  sampling a 1MB file. So this only has an effect when compressing texts
399
 
  larger than N*16 bytes. (John Arbash Meinel, #602614)
400
 
 
401
 
Improvements
402
 
************
403
 
 
404
 
.. Improvements to existing commands, especially improved performance 
405
 
   or memory usage, or better results.
406
 
 
407
 
* ``bzr branch --stacked`` from a smart server uses the network a little
408
 
  more efficiently.  For a simple branch it reduces the number of
409
 
  round-trips by about 20%.  (Andrew Bennetts)
410
 
 
411
 
* ``bzr log --line`` scales the width of the author field with the size of
412
 
  the line.  This means that the full author name is shown when the
413
 
  environment variable BZR_COLUMNS=0.  (Neil Martinsen-Burrell)
414
 
 
415
 
* ``bzr pull`` now properly triggers the fast
416
 
  ``CHKInventory.iter_changes`` rather than the slow generic
417
 
  inter-Inventory changes. It used to use a ``DirStateRevisionTree`` as
418
 
  one of the source trees, which is faster when we have to read the whole
419
 
  inventory anyway, but much slower when we can get just the delta out of
420
 
  the repository. On a 70k record tree, this changes ``bzr pull`` from 28s
421
 
  down to 17s. (John Arbash Meinel, #780677)
422
 
 
423
 
* Slightly reduced memory consumption when fetching into a 2a repository
424
 
  by reusing existing caching a little better.  (Andrew Bennetts)
425
 
 
426
 
* Speed up ``bzr status`` by a little bit when there are a couple of
427
 
  modified files. We now track how many files we have seen that need
428
 
  updating, and only rewrite the dirstate file if enough of them have
429
 
  changed. The default is 10, and can be overridden by setting the branch
430
 
  option "``bzr.workingtree.worth_saving_limit``".
431
 
  (Ian Clatworthy, John Arbash Meinel, #380202)
432
 
 
433
 
* Speed up ``bzr uncommit``. Instead of resetting the dirstate from
434
 
  scratch, use ``update_basis_by_delta``, computing the delta from the
435
 
  repository. (John Arbash Meinel, #780544)
436
 
 
437
 
Bug Fixes
438
 
*********
439
 
 
440
 
.. Fixes for situations where bzr would previously crash or give incorrect
441
 
   or undesirable results.
442
 
 
443
 
* All Tree types can now be exported as tar.*, zip or directories.
444
 
  (Aaron Bentley)
445
 
  
446
 
* ``bzr merge --no-remember location`` never sets ``submit_branch``.
447
 
  (Vincent Ladeuil, #782169)
448
 
 
449
 
* ``bzr pull --no-remember location`` never sets
450
 
  ``parent_location``.  ``bzr push --no-remember location`` never
451
 
  sets ``push_location``.  ``bzr send --no-remember
452
 
  submit_location public_location`` never sets ``submit_branch``
453
 
  nor ``public_branch``.  (Vincent Ladeuil)
454
 
 
455
 
* Conflicts involving non-ascii filenames are now properly reported rather
456
 
  than failing with a UnicodeEncodeError. (Martin [GZ], #686161)
457
 
 
458
 
* Correct parent is now set when using 'switch -b' with bound branches.
459
 
  (A. S. Budden, #513709)
460
 
 
461
 
* Fix `bzr plugins` regression in bzr 2.4 which resulted in a traceback
462
 
  from writelines on ckj terminals. (Martin [GZ], #754082)
463
 
 
464
 
* ``WT.inventory`` and ``WT.iter_entries_by_dir()`` was not correctly
465
 
  reporting subdirectories that were tree references (in formats that
466
 
  supported them). (John Arbash Meinel, #764677)
467
 
 
468
 
* Merging into empty branches now gives an error as this is currently
469
 
  not supported. (Jonathan Riddell, #242175)
470
 
 
471
 
* Do not show exception to user on pointless commit error.
472
 
  (Jonathan Riddell #317357)
473
 
 
474
 
* ``WT.update_basis_by_delta`` no longer requires that the deltas match
475
 
  the current WT state. This allows ``update_basis_by_delta`` to be used
476
 
  by more commands than just commit. Updating with a delta allows us to
477
 
  not load the whole inventory, which can take 10+s with large trees.
478
 
  (Jonathan Riddell, John Arbash Meinel, #781168)
479
 
 
480
 
* ``bzr mv --after old_name new_name`` now works if "new_name" is newly
481
 
  added. (Benoît Pierre)
482
 
 
483
 
 
484
 
Documentation
485
 
*************
486
 
 
487
 
.. Improved or updated documentation.
488
 
 
489
 
* Restore the workaround for option names including dots (--1.14) which was
490
 
  disabled when we stopped listing --1.9 as a format.
491
 
  (Vincent Ladeuil, #782289)
492
 
 
493
 
API Changes
494
 
***********
495
 
 
496
 
.. Changes that may require updates in plugins or other code that uses
497
 
   bzrlib.
498
 
 
499
 
* ``annotate_file`` has been deprecated in favor of
500
 
  ``annotate_file_revision_tree``. (Jelmer Vernooij, #775598)
501
 
 
502
 
* ``Branch.fetch`` now takes an optional ``limit`` argument.
503
 
  (Andrew Bennetts, Jelmer Vernooij, #750175)
504
 
 
505
 
* ``Inter.get`` now raises ``NoCompatibleInter`` if there are no
506
 
  compatible optimisers rather than an instance of the class it is called
507
 
  on. (Jelmer Vernooij)
508
 
 
509
 
* ``Branch.push`` now takes a ``lossy`` argument.
510
 
  ``Branch.lossy_push`` has been removed.
511
 
  (Jelmer Vernooij)
512
 
 
513
 
* New method ``Repository.get_file_graph`` which can return the
514
 
  per-file revision graph. (Jelmer Vernooij, #775578)
515
 
 
516
 
* The default implementation of ``Branch`` is now oriented to
517
 
  storing the branch tip. Branch implementations which store the full
518
 
  history should now subclass ``FullHistoryBzrBranch``.
519
 
  ``Branch._last_revision_info`` has been renamed to
520
 
  ``Branch._read_last_revision_info`` (Jelmer Vernooij)
521
 
 
522
 
* ``Tree.__iter__`` has been deprecated; use ``Tree.all_file_ids``
523
 
  instead.  (Jelmer Vernooij)
524
 
 
525
 
* ``Tree.get_symlink_target`` now takes an optional ``path``
526
 
  argument. (Jelmer Vernooij)
527
 
 
528
 
Internals
529
 
*********
530
 
 
531
 
.. Major internal changes, unlikely to be visible to users or plugin 
532
 
   developers, but interesting for bzr developers.
533
 
 
534
 
* ``MutableTree.smart_add`` now uses inventory deltas.
535
 
  (Jelmer Vernooij, #146165)
536
 
 
537
 
* Removed ``bzrlib.branch._run_with_write_locked_target`` as
538
 
  ``bzrlib.cleanup`` provides the same functionality in a more general
539
 
  way.  (Andrew Bennetts)
540
 
 
541
 
Testing
542
 
*******
543
 
 
544
 
.. Fixes and changes that are only relevant to bzr's test framework and 
545
 
   suite.  This can include new facilities for writing tests, fixes to 
546
 
   spurious test failures and changes to the way things should be tested.
547
 
 
548
 
* A test that was expected to fail but passes instead now counts as a failure
549
 
  catching up with new testtools and subunit handling. (Martin [GZ], #654474)
550
 
 
551
 
* Make it easier for plugins to reuse the per_workingtree scenarios by
552
 
  restoring the wt_scenarios helper that was accidentally deleted.
553
 
  (Vincent Ladeuil, #783472)
554
 
 
555
 
* Removed ``test_breakin`` tests that were excessively prone to hanging,
556
 
  did not work on Wine, and partly already disabled.
557
 
  (Martin Pool, #408814, #746985)
558
 
 
559
 
* Windows locations are different and should be tested accordingly.
560
 
  (Vincent Ladeuil, #788131)
561
 
 
562
 
bzr 2.4b2
563
 
#########
564
 
 
565
 
:2.4b2: 2011-04-28
566
 
 
567
 
This is the second beta of the 2.4 series, leading to a 2.4.0 release in
568
 
August 2011. Beta releases are suitable for everyday use but may cause some
569
 
incompatibilities with plugins.
570
 
 
571
 
This release includes all bug fixed in previous series known at the time of
572
 
this release.
573
 
 
574
 
 
575
 
External Compatibility Breaks
576
 
*****************************
577
 
 
578
 
.. These may require users to change the way they use Bazaar.
579
 
 
580
 
* Two command synonyms for ``bzr branch`` have been deprecated, to avoid
581
 
  confusion and to allow the names to later be reused.  The removed names
582
 
  are: ``get`` and ``clone``.   (Martin Pool, #506265)
583
 
 
584
 
New Features
585
 
************
586
 
 
587
 
.. New commands, options, etc that users may wish to try out.
588
 
 
589
 
* ``bzr commit`` now supports a ``--lossy`` argument that can be used
590
 
  to discard any data that can not be natively represented when committing
591
 
  to a foreign VCS. (Jelmer Vernooij, #587721)
592
 
 
593
 
Improvements
594
 
************
595
 
 
596
 
.. Improvements to existing commands, especially improved performance 
597
 
   or memory usage, or better results.
598
 
 
599
 
* ``bzr merge`` in large trees is now significantly faster. On a 70k entry
600
 
  tree, the time went from ~3min down to 30s. This also effects ``bzr pull``
601
 
  and ``bzr update`` since they use the same merge logic to update the
602
 
  WorkingTree.  (John Arbash Meinel, #759091)
603
 
 
604
 
* ``bzr revert`` now properly uses ``bzr status``'s optimized
605
 
  ``iter_changes``. This can be a significant performance difference (33s
606
 
  to 5s on large trees). (John Arbash Meinel, #759096)
607
 
 
608
 
* Resolve ``lp:FOO`` urls locally rather than doing an XMLRPC request if
609
 
  the user has done ``bzr launchpad-login``. The bzr+ssh URLs were already
610
 
  being handed off to the remote server anyway (xmlrpc has been mapping
611
 
  ``lp:bzr`` to ``bzr+ssh://bazaar.launchpad.net/+branch/bzr``, rather
612
 
  than ``bzr+ssh://bazaar.launchpad.net/~bzr-pqm/bzr/bzr.dev`` for a few
613
 
  months now.) By doing it ourselves, we can cut out substantial startup
614
 
  time. From Netherlands to London it was taking 368ms to do the XMLRPC
615
 
  call as much as 2s from Sydney. You can test the local logic by using
616
 
  ``-Dlaunchpad``.  (John Arbash Meinel, #397739)
617
 
 
618
 
* When building a new WorkingTree (such as during ``bzr co`` or
619
 
  ``bzr branch``) we now properly store the stat and hash of files that
620
 
  are old enough. This saves a fair amount of time on the first
621
 
  ``bzr status`` (on a 500MB tree, it saves about 30+s).
622
 
  (John Arbash Meinel, #740932)
623
 
 
624
 
 
625
 
Bug Fixes
626
 
*********
627
 
 
628
 
.. Fixes for situations where bzr would previously crash or give incorrect
629
 
   or undesirable results.
630
 
 
631
 
* Arguments that can't be decoded to unicode in the current posix locale give
632
 
  a clearer error message without a traceback. (Martin [gz], #745712)
633
 
 
634
 
* ``bzrlib.log._DEFAULT_REQUEST_PARAMS`` is no longer accidentally
635
 
  mutated by ``bzrlib.log._apply_log_request_defaults``.  In practice
636
 
  these default values aren't relied on very often so this probably
637
 
  wasn't causing any trouble.  (Andrew Bennetts)
638
 
 
639
 
* ``bzr log`` now works on revisions which are not in the current branch.
640
 
  (Matt Giuca, #241998)
641
 
 
642
 
* Don't rewrite the dirstate file when non-interesting changes have
643
 
  occurred. This can significantly improve 'bzr status' times when there
644
 
  are only small changes to a large tree.
645
 
  (Ian Clatworthy, John Arbash Meinel, #380202)
646
 
 
647
 
* Lazy hooks are now reset between test runs. (Jelmer Vernooij, #745566)
648
 
 
649
 
* ``bzrlib.merge.Merge`` now calls ``iter_changes`` without
650
 
  ``include_unversioned=True``. This makes it significantly faster in many
651
 
  cases, because it only looks at modified files, rather than building
652
 
  information about all files. This can cause failures in other
653
 
  TreeTransform code, because it had been expecting to know the names of
654
 
  things which had not changed (such as parent directories). All cases we
655
 
  know about so far have been fixed, but there may be fallout for edge
656
 
  cases that we are missing. (John Arbash Meinel, #759091)
657
 
 
658
 
* ``SFTPTransport`` is more pro-active about closing file-handles. This
659
 
  reduces the chance of having threads fail from async requests while
660
 
  running the test suite. (John Arbash Meinel, #656170)
661
 
 
662
 
* Standalone bzr.exe installation on Windows: user can put additional python 
663
 
  libraries into ``site-packages`` subdirectory of the installation directory,
664
 
  this might be required for "installing" extra dependencies for some plugins.
665
 
  (Alexander Belchenko, #743256)
666
 
 
667
 
* ``transform.revert()`` has been updated to use
668
 
  ``wt.iter_changes(basis_tree)`` rather than
669
 
  ``basis_tree.iter_changes(wt)``. This allows the optimized code path to
670
 
  kick in, improving ``bzr revert`` times significantly (33s to 4s on
671
 
  large trees, 0.7s to 0.3s on small trees.) (John Arbash Meinel, #759096)
672
 
 
673
 
* ``TreeTransform.create_file/new_file`` can now take an optional ``sha1``
674
 
  parameter. If supplied, when the transform is applied, it will then call
675
 
  ``self._tree._observed_sha1`` for those files. This lets us update the
676
 
  hash-cache for content that we create, preventing us from re-reading the
677
 
  content in the next ``bzr status``.  (John Arbash Meinel, #740932)
678
 
 
679
 
Documentation
680
 
*************
681
 
 
682
 
* Added a section about using a shared SSH account on a server for bzr+ssh
683
 
  access.  (Russell Smith)
684
 
 
685
 
* The documentation now recommends using SSH rather than SFTP in the
686
 
  tutorials and the examples, because that will generally be much faster
687
 
  and better in cases where it can be used.  SFTP is still available and
688
 
  mentioned as an alternative.  (Martin Pool, #636712)
689
 
 
690
 
API Changes
691
 
***********
692
 
 
693
 
.. Changes that may require updates in plugins or other code that uses
694
 
   bzrlib.
695
 
 
696
 
* ``Branch.update_revisions`` has been made private and should no
697
 
  longer be used by external users. Use ``Branch.pull`` or ``Branch.push``
698
 
  instead. (Jelmer Vernooij, #771765)
699
 
 
700
 
* Commands now have an `invoked_as` attribute, showing the name under
701
 
  which they were called before alias expansion.
702
 
  (Martin Pool)
703
 
 
704
 
* ``Hooks.create_hook`` is now deprecated in favour of ``Hooks.add_hook``.
705
 
  (Jelmer Vernooij)
706
 
 
707
 
* If you call `bzrlib.initialize` but forget to enter the resulting object
708
 
  as a context manager, bzrlib will now be initialized anyhow.
709
 
  (Previously simple programs calling bzrlib might find the library was
710
 
  mysteriously silent.)
711
 
  (Martin Pool)
712
 
 
713
 
* Inventory-specific functionality has been split out of ``Tree`` into
714
 
  a new ``InventoryTree`` class. Tree instances no longer
715
 
  necessarily provide an ``inventory`` attribute. (Jelmer Vernooij)
716
 
 
717
 
* Inventory-specific functionality has been split out of ``RevisionTree``
718
 
  into a new ``InventoryRevisionTree`` class. RevisionTree instances no
719
 
  longer necessarily provide an ``inventory`` attribute. (Jelmer Vernooij)
720
 
 
721
 
* New method ``Hooks.uninstall_named_hook``. (Jelmer Vernooij, #301472)
722
 
 
723
 
* ``revision_graph_can_have_wrong_parents`` is now an attribute
724
 
  on ``RepositoryFormat`` rather than a method on ``Repository``.
725
 
  (Jelmer Vernooij)
726
 
 
727
 
* ``Testament`` now takes a ``tree`` rather than an
728
 
  ``inventory``. (Jelmer Vernooij, #762608)
729
 
 
730
 
* ``TestCase.failUnlessExists`` and ``failIfExists`` are deprecated in
731
 
  favour of ``assertPathExists`` and ``assertPathDoesNotExist`` 
732
 
  respectively.
733
 
  (Martin Pool)
734
 
 
735
 
* The ``revno`` parameter of ``log.LogRevision`` may now be None,
736
 
  representing a revision which is not in the current branch.
737
 
  (Matt Giuca, #241998)
738
 
 
739
 
* The various knit pack repository format classes have been moved
740
 
  from ``bzrlib.repofmt.pack_repo`` to
741
 
  ``bzrlib.repofmt.knitpack_repo``. (Jelmer Vernooij)
742
 
 
743
 
* ``RevisionTree`` now has a new method ``get_file_revision``.
744
 
  (Jelmer Vernooij)
745
 
 
746
 
* ``WorkingTree`` no longer provides an ``inventory``. Instead,
747
 
  all inventory-related functionality is now on the subclass
748
 
  ``InventoryWorkingTree`` that all native Bazaar working tree
749
 
  implementations derive from. (Jelmer Vernooij)
750
 
 
751
 
Internals
752
 
*********
753
 
 
754
 
.. Major internal changes, unlikely to be visible to users or plugin 
755
 
   developers, but interesting for bzr developers.
756
 
 
757
 
* Added ``osutils.lstat`` and ``osutils.fstat``. These are just the ``os``
758
 
  functions on Linux, but they are wrapped on Windows so that fstat
759
 
  matches lstat results across all python versions.
760
 
  (John Arbash Meinel)
761
 
 
762
 
* ``WorkingTree._observed_sha1`` also updates the 'size' column. It
763
 
  happened to be updated as a side-effect of commit, but if we start using
764
 
  the function elsewhere we might as well do it directly.
765
 
  (John Arbash Meinel)
766
 
 
767
 
Testing
768
 
*******
769
 
 
770
 
.. Fixes and changes that are only relevant to bzr's test framework and 
771
 
   suite.  This can include new facilities for writing tests, fixes to 
772
 
   spurious test failures and changes to the way things should be tested.
773
 
 
774
 
* Stop using `failIf`, `failUnless`, `failIfEqual`, etc, that give
775
 
  `PendingDeprecationWarnings` on Python2.7. 
776
 
  (Martin Pool, #760435)
777
 
 
778
 
 
779
 
bzr 2.4b1
780
 
#########
781
 
 
782
 
:2.4b1: 2011-03-17
783
 
 
784
 
This is the first beta of the 2.4 series, leading up to a 2.4.0
785
 
release in August 2011.  Beta releases are suitable for everyday use
786
 
but may cause some incompatibilities with plugins.  Some plugins may need
787
 
small updates to work with 2.4b1.
788
 
 
789
 
External Compatibility Breaks
790
 
*****************************
791
 
 
792
 
(none)
793
 
 
794
 
New Features
795
 
************
796
 
 
797
 
* Added ``changelog_merge`` plugin for merging changes to ``Changelog`` files
798
 
  in GNU format.  See ``bzr help changelog_merge`` for details.
799
 
  (Andrew Bennetts)
800
 
  
801
 
* Configuration options can now use references to other options in the same
802
 
  file by enclosing them with curly brackets (``{other_opt}``). This makes it
803
 
  possible to use, for example,
804
 
  ``push_location=lp:~vila/bzr/config-{nickname}`` in ``branch.conf`` when
805
 
  using a loom. During the beta period, the default behaviour is to disable
806
 
  this feature. It can be activated by declaring ``bzr.config.expand = True``
807
 
  in ``bazaar.conf``. (Vincent Ladeuil)
808
 
 
809
 
* External merge tools can now be configured in bazaar.conf. See
810
 
  ``bzr help configuration`` for more information.  (Gordon Tyler, #489915)
811
 
 
812
 
* The ``lp:`` directory service now supports Launchpad's QA staging.
813
 
  (Jelmer Vernooij, #667483)
814
 
 
815
 
Improvements
816
 
************
817
 
 
818
 
* A new hidden command ``bzr repair-workingtree``. This is a way to force
819
 
  the dirstate file to be rebuilt, rather than using a ``bzr checkout``
820
 
  workaround. (John Arbash Meinel)
821
 
 
822
 
* Added a ``Branch.heads_to_fetch`` RPC to the smart server protocol.
823
 
  This allows formats from plugins (such as looms) to efficiently tell the
824
 
  client which revisions need to be fetched.  (Andrew Bennetts)
825
 
 
826
 
* Branching, merging and pulling a branch now copies revisions named in
827
 
  tags, not just the tag metadata.  (Andrew Bennetts, #309682)
828
 
 
829
 
* ``bzr cat-revision`` no longer requires a working tree.
830
 
  (Jelmer Vernooij, #704405)
831
 
 
832
 
* ``bzr export --per-file-timestamps`` for .tar.gz files will now
833
 
  override the mtime for trees exported on Python 2.7 and later, which
834
 
  expose the 'mtime' field in gzip files. This makes the output of
835
 
  ``bzr export --per-file-timestamps`` for a particular tree
836
 
  deterministic.  (Jelmer Vernooij, #711226)
837
 
 
838
 
* ``bzr export --format=zip`` can now export to standard output,
839
 
  like the other exporters can. (Jelmer Vernooij, #513752)
840
 
 
841
 
* ``bzr export`` can now create ``.tar.xz`` and ``.tar.lzma`` files.
842
 
  (Jelmer Vernooij, #551714)
843
 
 
844
 
* Getting all entries from ``CHKInventory.iter_entries_by_dir()`` has been
845
 
  sped up dramatically for large trees. Iterating by dir is not the best
846
 
  way to load data from a CHK inventory, so it preloads all the items in
847
 
  the correct order. (With the gcc-tree, this changes it (re)reading 8GB
848
 
  of CHK data, down to just 150MB.) This has noticeable affects for things
849
 
  like building checkouts, etc.  (John Arbash Meinel, #737234)
850
 
 
851
 
Bug Fixes
852
 
*********
853
 
 
854
 
* A MemoryError thrown on the server during a remote operation will now be
855
 
  usefully reported, and other unexpected errors will include the class name.
856
 
  (Martin [gz], #722416)
857
 
 
858
 
* ``bzr annotate -r-1 file`` will now properly annotate a deleted file.
859
 
  (Andrew King, #537442)
860
 
 
861
 
* ``bzr export`` to zip files will now set a mode on directories.
862
 
  (Jelmer Vernooij, #207253)
863
 
 
864
 
* ``bzr export`` to tgz files will only write out the basename of the
865
 
  tarfile to the gzip file. (Jelmer Vernooij, #102234)
866
 
 
867
 
* ``bzr push --overwrite`` with an older revision specified will now correctly
868
 
  roll back the target branch. (Jelmer Vernooij, #386576)
869
 
 
870
 
* ``bzr lp-propose`` can now propose merges against packaging branches on
871
 
  Launchpad without requiring the target branch to be specified.
872
 
  (Jelmer Vernooij, #704647)
873
 
 
874
 
* ``bzr lp-propose`` no longer requires a reviewer to be specified. It will
875
 
  instead leave setting the reviewer up to Launchpad if it was not specified.
876
 
  (Jelmer Vernooij, #583772)
877
 
 
878
 
* ``bzr pull`` will now exit with exit code 1 if there were tag conflicts.
879
 
  (Jelmer Vernooij, #213185)
880
 
 
881
 
* ``bzr mv`` user errors no longer throw UnicodeEncodeError with non-ascii
882
 
  paths, however they may still print junk if not on a UTF-8 terminal.
883
 
  (Martin [gz], #707954)
884
 
 
885
 
* ``bzr reconfigure --unstacked`` now copies revisions (and their
886
 
  ancestors) named in tags into the unstacked repository, not just the
887
 
  ancestry of the branch's tip.  (Andrew Bennetts, #401646)
888
 
 
889
 
* ``bzr serve`` no longer crashes when a server_started hook is installed and
890
 
  IPv6 support is available on the system. (Jelmer Vernooij, #293697)
891
 
 
892
 
* ``bzr status`` will not rewrite the dirstate file if it only has
893
 
  'trivial' changes. (Currently limited to dir updates and newly-added
894
 
  files changing state.) This saves a bit of time for regular operations.
895
 
  eg. ``bzr status`` in a 100k tree takes 1.4s to compute the status, but 1s
896
 
  to re-save the dirstate file. (John Arbash Meinel, #765881)
897
 
 
898
 
* ``bzr tags`` will no longer choke on branches with ghost revisions in
899
 
  their mainline and tags on revisions not in the branch ancestry. 
900
 
  (Jelmer Vernooij, #397556)
901
 
 
902
 
* ``bzr whoami`` will now display an error if both a new identity and
903
 
  ``--email`` were specified. (Jelmer Vernooij, #680449)
904
 
 
905
 
* ``launchpadlib`` doesn't provide the ``uris`` module in some old versions.
906
 
  (Vincent Ladeuil, #706835)
907
 
 
908
 
* Empty entries in the ``NO_PROXY`` variable are no longer treated as matching
909
 
  every host.
910
 
  (Martin Pool, #586341)
911
 
 
912
 
* Plugins incompatible with the current version of bzr no longer produce a
913
 
  warning on every command invocation.  Instead, a message is shown by
914
 
  ``bzr plugins`` and in crash reports.
915
 
  (#704195, Martin Pool)
916
 
 
917
 
* The "pretty" version of ``needs_read_lock`` and ``needs_write_lock`` now
918
 
  preserves the identity of default parameter values.
919
 
  (Andrew Bennetts, #718569)
920
 
 
921
 
* ``bzr dump-btree --raw`` no longer tracebacks on a B-Tree file
922
 
  containing no rows. (Eric Siegerman, #715508)
923
 
 
924
 
* Fix ``bzr lp-mirror`` to work on command line branch URLs and branches
925
 
  without an explicit public location. (Max Bowsher)
926
 
 
927
 
* On Python 2.6 and higher, use multiprocessing.cpu_count() to retrieve the
928
 
  number of available processors. (Jelmer Vernooij, #693140)
929
 
 
930
 
API Changes
931
 
***********
932
 
 
933
 
* Added ``Branch.heads_to_fetch`` method.  Implementations of the Branch API
934
 
  must now inherit or implement this method.  (Andrew Bennetts, #721328)
935
 
  
936
 
* Added ``bzrlib.mergetools`` module with helper functions for working with
937
 
  the list of external merge tools. (Gordon Tyler, #489915)
938
 
 
939
 
* All methods and arguments that were deprecated before 2.0
940
 
  have been removed. (Jelmer Vernooij)
941
 
 
942
 
* Branch formats should now be registered on the format registry
943
 
  (``bzrlib.branch.format_registry``) rather than using the class
944
 
  methods on ``BranchFormat``. (Jelmer Vernooij, #714729)
945
 
 
946
 
* ``Branch.set_revision_history`` is now deprecated.
947
 
  (Jelmer Vernooij)
948
 
 
949
 
* ``BranchFormat.supports_leaving_lock()`` and
950
 
  ``RepositoryFormat.supports_leaving_lock`` flags have been added.
951
 
  (Jelmer Vernooij)
952
 
 
953
 
* ``Branch.fetch`` implementations must now accept an optional
954
 
  ``fetch_tags`` keyword argument. (Andrew Bennetts)
955
 
 
956
 
* ``Branch.import_last_revision_info`` is deprecated.  Use the
957
 
  ``import_last_revision_info_and_tags`` method instead.
958
 
  (Andrew Bennetts)
959
 
 
960
 
* Because it was too specific to BzrDir implementations,
961
 
  ``ControlDir.sprout`` no longer has a default implementation; it now
962
 
  raises ``NotImplementedError``. (Jelmer Vernooij, #717937)
963
 
 
964
 
* ``bzrlib.deprecated_graph`` has been removed. ``bzrlib.graph``
965
 
  scales better tree and should be used instead.
966
 
  (Jelmer Vernooij, #733612)
967
 
 
968
 
* ``ControlDirFormat.register_format`` has been removed. Instead,
969
 
  ``Prober`` implementations should now implement a ``known_formats``
970
 
  method. (Jelmer Vernooij)
971
 
 
972
 
* ControlDirFormats can now provide a ``check_status`` method and
973
 
  raise a custom exception or warning when an unsupported or deprecated
974
 
  format is being opened.  (Jelmer Vernooij, #731311)
975
 
 
976
 
* ``bzrlib.revionspec.dwim_revspecs`` is deprecated.
977
 
  Use ``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_revspec`` and
978
 
  ``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_lazy_revspec``
979
 
  instead.  (Jelmer Vernooij, #721971)
980
 
 
981
 
* ``BzrDirFormat`` has a new attribute ``fixed_components`` that
982
 
  indicates whether the components of the bzrdir can be upgraded
983
 
  independent of the ``BzrDir``. (Jelmer Vernooij)
984
 
 
985
 
* ``BzrProber.register_format`` and ``BzrProber.unregister_format`` are
986
 
  now deprecated in favour of the ``BzrProber.formats`` format registry.
987
 
  (Jelmer Vernooij)
988
 
 
989
 
* ``ControlDir`` implementations no longer have to provide the
990
 
  ``get_branch_transport``, ``get_workingtree_transport`` and
991
 
  ``get_repository_transport`` methods.  (Jelmer Vernooij, #730325)
992
 
 
993
 
* ``Converter`` has been moved from ``bzrlib.bzrdir`` to
994
 
  ``bzrlib.controldir``. (Jelmer Vernooij)
995
 
 
996
 
* Repository formats can now provide
997
 
  ``_get_extra_interrepo_test_combinations`` in the same module 
998
 
  to provide extra test combinations for ``bzrlib.tests.per_repository``.
999
 
  (Jelmer Vernooij)
1000
 
 
1001
 
* Repository formats should now be registered on the format registry
1002
 
  (``bzrlib.repository.format_registry``) rather than using the class
1003
 
  methods on ``RepositoryFormat``. (Jelmer Vernooij)
1004
 
 
1005
 
* Repository formats can now indicate they do not support the full
1006
 
  VersionedFiles API by setting the ``supports_full_versioned_files``
1007
 
  attribute to False. A subset of the VersionedFiles API
1008
 
  (signatures and text graphs) still needs to be supported.
1009
 
  (Jelmer Vernooij)
1010
 
 
1011
 
* Repository formats have a new method ``is_deprecated`` that
1012
 
  implementations can override to return True to trigger a deprecation
1013
 
  warning. (Jelmer Vernooij)
1014
 
 
1015
 
* The ``revision_id`` parameter of
1016
 
  ``Repository.search_missing_revision_ids`` and
1017
 
  ``InterRepository.search_missing_revision_ids`` is deprecated.  It is
1018
 
  replaced by the ``revision_ids`` parameter.  (Andrew Bennetts)
1019
 
 
1020
 
* Working tree formats should now be registered on the format registry
1021
 
  (``bzrlib.working_tree.format_registry``) rather than using the class
1022
 
  methods on ``WorkingTreeFormat``. (Jelmer Vernooij, #714730)
1023
 
 
1024
 
* Exporting may now be done with a generator
1025
 
  (``bzrlib.export.get_export_generator``) (Geoff/xaav, #791005)
1026
 
 
1027
 
Internals
1028
 
*********
1029
 
 
1030
 
* ``CatchingExceptionThread`` (formerly ThreadWithException) has been moved
1031
 
  out of the ``bzrlib.tests`` hierarchy to make it clearer that it can be used
1032
 
  outside of tests. This class makes it easier to track exceptions in threads
1033
 
  by catching them so they can be re-raised in the controlling thread. It's
1034
 
  available in the ``bzrlib.cethread`` module.  (Vincent Ladeuil)
1035
 
 
1036
 
* Correctly propogate malloc failures from diff-delta.c code as MemoryError
1037
 
  so OOM conditions during groupcompress are clearly reported. This entailed a
1038
 
  change to several function signatures. (Martin [gz], #633336)
1039
 
 
1040
 
* ``HookPoint.lazy_hook`` and ``Hooks.install_named_lazy_hook`` can install 
1041
 
  hooks for which the callable is loaded lazily.  (Jelmer Vernooij)
1042
 
 
1043
 
Testing
1044
 
*******
1045
 
 
1046
 
* The Range parsing for HTTP requests will correctly parse incomplete ranges.
1047
 
  (Vincent Ladeuil, #731240)
1048
 
 
1049
 
..
1050
 
   vim: tw=74 ft=rst ff=unix