~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Robert Collins
  • Date: 2006-05-04 10:36:13 UTC
  • mto: (1697.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 1701.
  • Revision ID: robertc@robertcollins.net-20060504103613-bf4d13f925aa8520
Extend LockableFiles to support break_lock() calls.

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