~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Andrew Bennetts
  • Date: 2010-10-13 00:26:41 UTC
  • mto: This revision was merged to the branch mainline in revision 5498.
  • Revision ID: andrew.bennetts@canonical.com-20101013002641-9tlh9k89mlj1666m
Keep docs-plain working.

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