11
:2.4.2: NOT RELEASED YET
13
External Compatibility Breaks
14
*****************************
16
.. These may require users to change the way they use Bazaar.
21
.. New commands, options, etc that users may wish to try out.
26
.. Improvements to existing commands, especially improved performance
27
or memory usage, or better results.
32
.. Fixes for situations where bzr would previously crash or give incorrect
33
or undesirable results.
35
* Cope with Unix filesystems, such as smbfs, where chmod gives 'permission
36
denied'. (Martin Pool, #606537)
38
* When the ``limbo`` or ``pending-deletion`` directories exist, typically
39
because of an interrupted tree update, but are empty, bzr no longer
40
errors out, because there is nothing for the user to clean up. Also,
41
errors in creation of these directories are no longer squelched.
42
(Martin Pool, #427773)
44
* During merges, when two entries end up using the same path for two
45
different file-ids (the same file being 'bzr added' in two different
46
branches) , 'duplicate' conflicts are created instead of 'content'
47
ones. This was previously leading to a 'Malformed tramsform' exception.
48
(Vincent Ladeuil, #880701)
50
* 'Malformed transform' exceptions are now recognized as internal errors
51
instead of user errors and report a traceback. This will reduce user
52
confusion as there is generally nothing users can do about them.
53
(Vincent Ladeuil, #880701)
55
* Prevent a traceback being printed to stderr when logging has problems and
56
accept utf-8 byte string without breaking. (Martin Packman, #714449)
61
.. Improved or updated documentation.
66
.. Changes that may require updates in plugins or other code that uses
72
.. Major internal changes, unlikely to be visible to users or plugin
73
developers, but interesting for bzr developers.
78
.. Fixes and changes that are only relevant to bzr's test framework and
79
suite. This can include new facilities for writing tests, fixes to
80
spurious test failures and changes to the way things should be tested.
82
* Account for slightly improved compression with newer versions of zlib in
83
``bt.test_btree_index`` tests. (Martin Packman, #940453)
91
This is a bugfix release. Most of the bugs dealt with portability
92
issues. Upgrading is recommended for all users of earlier 2.4 releases.
94
External Compatibility Breaks
95
*****************************
107
* Fixed a bug where ``bzr tags -r x..y`` loaded the branch history once for
108
every revision in the range; it's now much faster. (Vincent Ladeuil, #857335)
113
* Fixed an infinite loop when creating a repo at the root of the filesystem,
114
i.e. "/", due to posixpath.normpath() not collapsing 2 leading slashes into
115
one, thus respecting the POSIX standard, but making relpath() loop infinitely.
116
(Florian Vichot, #861008)
118
* Fixed loading of external merge tools from config to properly decode
119
command-lines which contain embedded quotes. (Gordon Tyler, #828803)
121
* Include declaration of 'changed' to avoid an UnboundLocalError in dirstate
122
pyrex code with new Cython versions. (Denys Duchier, #837221)
124
* Prevent several kinds of OverflowError and other fallout from failing to fit
125
stat fields into four bytes in dirstate pack_stat implementations.
126
(Martin Packman, #683191 #706957)
128
* Return early from create_delta_index_from_delta given tiny inputs. This
129
avoids raising a spurious MemoryError on certain platforms such as AIX.
130
(John Arbash Meinel, #856731)
135
* Corrected documentation for ``bzr serve`` in the Admin Guide.
136
(Morten Bøgeskov, Martin Pool, #832576)
151
* Accept both old and new style testtools output in selftest tests.
152
(Jelmer Vernooij, Martin Packman, #815423)
154
* Fix the race for TestingThreadingTCPServer in
155
test_server_crash_while_responding. (Vincent Ladeuil, #869366)
157
* Really corrupt the pack file without depending on a special length or value.
158
(Vincent Ladeuil, #807032)
166
This is a bugfix release. Upgrading is recommended for all users of earlier
169
It includes fixes from previous stable releases and address some issues with
173
External Compatibility Breaks
174
*****************************
176
.. These may require users to change the way they use Bazaar.
181
.. New commands, options, etc that users may wish to try out.
186
.. Improvements to existing commands, especially improved performance
187
or memory usage, or better results.
192
.. Fixes for situations where bzr would previously crash or give incorrect
193
or undesirable results.
195
* ``config.LocationMatcher`` properly excludes unrelated sections.
196
(Vincent Ladeuil, #829237)
198
* ``dirstate.fdatasync`` and ``repository.fdatasync`` can now properly be
199
disabled. (Vincent Ladeuil, #824513)
201
* Disable ``os.fsync`` and ``os.fdatasync`` by default when running
202
``bzr selftest``. You can use ``--sync`` to re-enable them.
203
(John Arbash Meinel, #837293)
205
* Fix i18n use when no environment variables are set. (Jelmer Vernooij, #810701)
207
* Avoid UnicodeDecode error when reporting EINVAL from transports.
208
(IWATA Hidetaka, #829237)
213
.. Improved or updated documentation.
215
* Corrected documentation for BZR_PROGRESS_BAR.
216
(Dennis Benzinger, #735417)
221
.. Changes that may require updates in plugins or other code that uses
227
.. Major internal changes, unlikely to be visible to users or plugin
228
developers, but interesting for bzr developers.
233
.. Fixes and changes that are only relevant to bzr's test framework and
234
suite. This can include new facilities for writing tests, fixes to
235
spurious test failures and changes to the way things should be tested.
237
* The test suite should now be able to run under weird environments where
238
``/etc/passwd`` doesn't contain the ``uid`` for the user running selftest
239
or where ``fakeroot`` is used but ``/root`` is inacessible.
240
(Vincent Ladeuil, #825027)
247
This release marks the start of a new long-term-stable series. From here, we
248
will only make bugfix releases on the 2.4 series (2.4.1, etc, and support it
249
until February 2013), while 2.5 will become our new development series.
251
This is a bugfix and polish release over the 2.3 series, with a large number
252
of bugs fixed (>150 for the 2.4 series alone), and some performance
253
improvements. Support for python 2.4 and 2.5 has been dropped, many large
254
working tree operations have been optimized as well as some stacked branches
257
Only bugfixes from other stables series have been included since 2.4b5 so
258
all known fixed bugs are included here.
260
Users are encouraged to upgrade from the other stable series.
263
External Compatibility Breaks
264
*****************************
266
.. These may require users to change the way they use Bazaar.
271
.. New commands, options, etc that users may wish to try out.
276
.. Improvements to existing commands, especially improved performance
277
or memory usage, or better results.
282
.. Fixes for situations where bzr would previously crash or give incorrect
283
or undesirable results.
285
* A call to CHKInventory's filter-method will not result in a
286
DuplicateFileId error, if you move a subfolder and change a file in
288
(Bastian Bowe, #809901)
290
* Accessing a packaging branch on Launchpad (eg, ``lp:ubuntu/bzr``) now
291
checks to see if the most recent published source package version for
292
that project is present in the branch tags. This should help developers
293
trust whether the packaging branch is up-to-date and can be used for new
294
changes. The level of verbosity is controlled by the config item
295
``launchpad.packaging_verbosity``. It can be set to one of
302
only display if the branch is out-of-date
305
also display single-line up-to-date and missing,
309
(default) display multi-line content for all states
312
(John Arbash Meinel, #609187, #812928)
314
* Cope with not all Python versions having a ``clear`` method on
315
``TestCase._type_equality_funcs``.
316
(Martin [gz], Jelmer Vernooij, #809048)
318
* Fetching tags when fetching the tip revision of a branch is now
319
controlled by the config setting ``branch.fetch_tags``. The behavior has
320
been reverted to 2.3's not-fetching tagged revisions by default.
321
(John Arbash Meinel, #771184)
323
* The fix for bug #513709 caused us to open a new connection when
324
switching a lightweight checkout that was pointing at a bound branch.
325
This isn't necessary because we know the master URL without opening it,
326
avoiding an extra SSH connection, etc.
327
(John Arbash Meinel, #812285)
333
.. Improved or updated documentation.
338
.. Changes that may require updates in plugins or other code that uses
344
.. Major internal changes, unlikely to be visible to users or plugin
345
developers, but interesting for bzr developers.
350
.. Fixes and changes that are only relevant to bzr's test framework and
351
suite. This can include new facilities for writing tests, fixes to
352
spurious test failures and changes to the way things should be tested.
354
* `BranchBuilder.build_snapshot` now supports a "flush" action. This
355
cleanly and reliably allows tests using `BranchBuilder` to construct
356
branches that e.g. rename files out of a directory and unversion that
357
directory in the same revision. Previously some changes were impossible
358
due to the order that `build_snapshot` performs its actions.
361
* `TestCaseWithMemoryTransport` is faster now: `_check_safety_net` now
362
just compares the bytes in the dirstate file to its pristine state,
363
rather than opening the WorkingTree and calling ``last_revision()``.
364
This reduces the overall test suite time by about 10% on my laptop.
373
This is the fifth (and last) beta of the 2.4 series leading to
374
2.4.0 release in August 2011. Beta releases are suitable for
375
everyday use but may cause some incompatibilities with plugins.
377
This release includes all bug fixed in previous series known at
378
the time of this release.
380
External Compatibility Breaks
381
*****************************
388
* New command ``verify-signatures`` to check if all commits or specified commits
389
have digital signatures from trusted keys. Requires python-gpgme to be
392
* New option ``--signatures`` for ``bzr log`` to display digital signature
393
verification results for each commit.
395
* Config option acceptable_keys to list which GPG keys are verified as trusted.
397
* Config option validate_signatures_in_log to always show signatures in
403
* ``Branch.open`` is now about 3x faster (about 2ms instead of 6.5ms).
406
* Pack, dirstate, and index files are synced to persistent storage if
407
possible when writing finishes, to reduce the risk of problems caused by
408
a machine crash or similar problem. This can be turned off through the
409
``dirstate.fdatasync`` and ``repository.fdatasync`` options, which can
410
be set in ``locations.conf`` or ``bazaar.conf``. (Martin Pool,
416
* Display a proper error message when a config file content cannot be
417
decoded as UTF-8 or when it cannot be parsed.
418
(Vincent Ladeuil, #502060, #688677, #797246)
420
* Generate a single conflict (instead of two) when merging a branch
421
modifying and renaming a file in a branch that deleted it (or vice-versa).
422
(Vincent Ladeuil, #688101)
424
* Give a more helpful message when the bzr executable doesn't match the
425
library. (This typically happens because of a misconfigured PYTHONPATH
426
or half-installed bzr.)
427
(Martin Pool, #804553)
429
* Properly load utf8-encoded config files. (Vincent Ladeuil, #799212)
431
* ``GraphThunkIdsToKeys.merge_sort`` now properly returns
432
keys rather than ids. (Jelmer Vernooij, #799677)
434
* ``TreeTransformBase.fixup_new_roots`` can now check that a tree root
435
is present. (Jelmer Vernooij, #801257)
440
* New attributes ``WorkingTreeFormat.supports_versioned_directories`` and
441
``RepositoryFormat.supports_versioned_directories``.
442
(Jelmer Vernooij, #765815)
444
* The "revno" field type when using the python version-info format is now
445
a string (to handle dotted revnos) (Benoît Pierre, #796259)
450
* Start implementing localization, starting with command help text (but not
451
the command options themselves). This will allow bootstrapping the bzr
452
internationalization process. (Inada Naoki)
457
* Fix test failures when running as a homeless user (debian buildd). Tests
458
leaking into ``${HOME}/.bzr.log`` should be detected properly now.
459
(Vincent Ladeuil, #798698)
466
This is the fourth beta of the 2.4 series, leading to a 2.4.0 release in
467
August 2011. Beta releases are suitable for everyday use but may cause some
468
incompatibilities with plugins.
470
This release includes all bug fixed in previous series known at the time of
474
External Compatibility Breaks
475
*****************************
477
.. These may require users to change the way they use Bazaar.
479
* Do not treat configuration option 'check_signatures = require' as if
480
it were 'create_signatures = always' (Jonathan Riddell)
485
.. New commands, options, etc that users may wish to try out.
487
* Hooks have been added for config stacks: ``get``, ``set`` and ``remove``
488
are called when an option is respectively read, modified or deleted. Also
489
added ``load`` and ``save`` hooks for config stores, called when the
490
stores are loaded or saved. (Vincent Ladeuil)
492
* New hook server_exception in bzrlib.smart.server to catch any
493
exception caused while running bzr serve.
494
(Jonathan Riddell, #274578)
496
* New hook set_commit_message in bzrlib.msgeditor to set a commit message
497
and revision properties. (Jonathan Riddell, #274578)
499
* Support ``-S`` as an alias for ``--short`` for the ``log`` and
500
``missing`` commands. (Martin von Gagern, #38655)
505
.. Improvements to existing commands, especially improved performance
506
or memory usage, or better results.
508
* ``bzr annotate`` can be run without setting whoami data first.
509
(Jonathan Riddell, #667408)
514
.. Fixes for situations where bzr would previously crash or give incorrect
515
or undesirable results.
517
* Bazaar can now detect when a lock file is held by a dead process
518
originating from the same machine, and steal the lock after printing a
519
message to the user. This is off by default, for safety, but can be
520
turned on by setting the configuration variable ``locks.steal_dead`` to
522
(Martin Pool, #220464)
524
* ``bzr version-info`` now works when the tree is on a dotted revno.
525
(Benoît Pierre, #796259)
527
* Credentials in the log output produced by ``-Dhttp`` are masked so users
528
can more freely post them in bug reports. (Vincent Ladeuil, #723074)
530
* Fix a race condition for ``server_started`` hooks leading to a spurious
531
test failure. (Vincent Ladeuil, #789167)
533
* Fix exporting subdirectory with ``--per-file-timestamps``.
534
(Szilveszter Farkas, #795557)
536
* Handle files that get created but don't get used during TreeTransform.
537
``open()`` can create a file, and still raise an exception before it
538
returns. So anything we might have created, make sure we destroy during
539
``finalize()``. (Martin [gz], #597686)
541
* ``pack_repo`` now uses ``Transport.move`` instead of
542
``Transport.rename``, deleting any existing targets even on SFTP.
543
(Martin von Gagern, #421776)
545
* Pass the ``build_mo`` command to the rest of the setup() calls in
546
setup.py. The ``bdist_wininst`` and ``py2exe`` code paths were failing
547
because ``build_mo`` became a required step that they didn't know about.
548
(John Arbash Meinel, #787122)
550
* Preserve existing ``root-id`` when merging an unrelated branch.
551
(Aaron Bentley, #806356)
553
* Properly avoid re-adding a file after it changes case on CICP
554
filesystems. (John Arbash Meinel, #798130)
556
* Reports the original error when an InvalidHttpResponse exception is
557
encountered to facilitate debug. (Vincent Ladeuil, #788530)
559
* Reports a non-existent file error when trying to merge in a file
560
that does not exist. (Jonathan Riddell, #330063)
562
* ``UIFactory.prompt``, ``UIFactory.get_username``,
563
``UIFactory.get_password`` and ``UIFactory.get_boolean`` now require a
564
unicode prompt to be passed in. (Jelmer Vernooij, #592083)
566
* Support merging into the empty tree. (Aaron Bentley, #595328)
571
.. Improved or updated documentation.
573
* Improve documentation of ``bzr merge --force``.
574
(Neil Martinsen-Burrell, #767307)
576
* Make docs for configuration options for digital signatures match
577
reality. (Jonathan Riddell)
579
* Add user-guide page on GPG signatures. (Jonathan Riddell)
584
.. Changes that may require updates in plugins or other code that uses
587
* Checking for a file id in a `Tree` or `Inventory` using ``in`` is now
588
deprecated. Instead, use `has_id`.
591
* Exporters are now all exposed as generators, rather than as single-call
592
functions, so that calling code can take stream the output.
595
* Information about held lockdir locks returned from eg `LockDir.peek` is
596
now represented as a `LockHeldInfo` object, rather than a plain
600
* Remove `file_status` function.
603
* ``Repository.iter_reverse_revision_history`` is now deprecated.
604
Use ``Graph.iter_lefthand_ancestry`` instead.
605
(Jelmer Vernooij, #739481)
607
* ``Repository.get_ancestry`` has been deprecated. Use
608
``Graph.iter_ancestry`` instead.
609
(Jelmer Vernooij, #784511)
614
.. Major internal changes, unlikely to be visible to users or plugin
615
developers, but interesting for bzr developers.
617
* ``tools/check-newsbugs.py`` accepts a ``--browser`` option to open
618
corresponding launchpad pages in a browser. (Vincent Ladeuil)
623
.. Fixes and changes that are only relevant to bzr's test framework and
624
suite. This can include new facilities for writing tests, fixes to
625
spurious test failures and changes to the way things should be tested.
627
* A `ImportTariffTestCase` base class has been added in
628
``bzrlib.tests.test_import_tariff``, which can be used for import tariff
629
tests in plugins. (Jelmer Vernooij, #793465)
631
* Fix deadlock in `TestImportTariffs.test_simple_serve` when stderr gets
632
more output than fits in the default buffer. This was happening on the
633
Windows buildslave, and could easily happen in other circumstances where
634
the default OS buffer size for pipes is small or the ``python -v``
635
output is large. (Andrew Bennetts, #784802)
637
* Fix spurious test failure on OSX for WorkingTreeFormat2.
638
(Vincent Ladeuil, #787942)
640
* Re-target ``bb.test_merge.TestMerge.test_merge_reversed_revision_range``
641
and rewrite it as a parametrized test to avoid unrelated failures.
642
(Vincent Ladeuil, #795456)
644
* Show log file contents from subprocesses started by
645
`start_bzr_subprocess` in test failure details. This may help diagnose
646
strange hangs and failures involving subprocesses. (Andrew Bennetts)
648
* Skip ``utextwrap`` tests when ``sphinx`` breaks text_wrap by an hostile
649
monkey-patch to textwrap.TextWrapper.wordsep_re.
650
(Vincent Ladeuil, #785098)
652
* Multiple ``selftest --exclude`` options are now combined instead of
653
overriding each other. (Vincent Ladeuil, #746991)
655
* Restore some ``FTPTransport`` test coverage by allowing ``pyftpdlib
656
0.6.0`` to be used. Also restore ``medusa`` support while leaving it
657
disabled to make it easier to use if/when we can in the future.
658
(Vincent Ladeuil, #781140)
660
* `TestImportTariffs` no longer uses the real ``$HOME``. This prevents it
661
from polluting ``$HOME/.bzr.log`` or being accidentally influenced by
662
user configuration such as aliases. It still runs with all the user's
663
plugins enabled, as intended.
664
(Vincent Ladeuil, Andrew Bennetts, #789505)
672
This is the third beta of the 2.4 series, leading to a 2.4.0 release in
673
August 2011. Beta releases are suitable for everyday use but may cause some
674
incompatibilities with plugins.
676
This release includes all bug fixed in previous series known at the time of
680
External Compatibility Breaks
681
*****************************
683
.. These may require users to change the way they use Bazaar.
685
* ``bzr-2.4`` has officially dropped support for python2.4 and python2.5.
686
We will continue to maintain ``bzr-2.3`` for people who still need to
687
use those versions of python. (John Arbash Meinel)
692
.. New commands, options, etc that users may wish to try out.
694
* The text compressor used for 2a repositories now has a tweakable
695
parameter that can be set in bazaar.conf.
696
``bzr.groupcompress.max_entries_per_source`` default of 65536.
697
When doing compression, we build up an index of locations to match
698
against. Setting this higher will result in slightly better compression,
699
at a cost of more memory. Note that a value of 65k represents fully
700
sampling a 1MB file. So this only has an effect when compressing texts
701
larger than N*16 bytes. (John Arbash Meinel, #602614)
706
.. Improvements to existing commands, especially improved performance
707
or memory usage, or better results.
709
* ``bzr branch --stacked`` from a smart server uses the network a little
710
more efficiently. For a simple branch it reduces the number of
711
round-trips by about 20%. (Andrew Bennetts)
713
* ``bzr log --line`` scales the width of the author field with the size of
714
the line. This means that the full author name is shown when the
715
environment variable BZR_COLUMNS=0. (Neil Martinsen-Burrell)
717
* ``bzr pull`` now properly triggers the fast
718
``CHKInventory.iter_changes`` rather than the slow generic
719
inter-Inventory changes. It used to use a ``DirStateRevisionTree`` as
720
one of the source trees, which is faster when we have to read the whole
721
inventory anyway, but much slower when we can get just the delta out of
722
the repository. On a 70k record tree, this changes ``bzr pull`` from 28s
723
down to 17s. (John Arbash Meinel, #780677)
725
* Slightly reduced memory consumption when fetching into a 2a repository
726
by reusing existing caching a little better. (Andrew Bennetts)
728
* Speed up ``bzr status`` by a little bit when there are a couple of
729
modified files. We now track how many files we have seen that need
730
updating, and only rewrite the dirstate file if enough of them have
731
changed. The default is 10, and can be overridden by setting the branch
732
option "``bzr.workingtree.worth_saving_limit``".
733
(Ian Clatworthy, John Arbash Meinel, #380202)
735
* Speed up ``bzr uncommit``. Instead of resetting the dirstate from
736
scratch, use ``update_basis_by_delta``, computing the delta from the
737
repository. (John Arbash Meinel, #780544)
742
.. Fixes for situations where bzr would previously crash or give incorrect
743
or undesirable results.
745
* All Tree types can now be exported as tar.*, zip or directories.
748
* ``bzr merge --no-remember location`` never sets ``submit_branch``.
749
(Vincent Ladeuil, #782169)
751
* ``bzr pull --no-remember location`` never sets
752
``parent_location``. ``bzr push --no-remember location`` never
753
sets ``push_location``. ``bzr send --no-remember
754
submit_location public_location`` never sets ``submit_branch``
755
nor ``public_branch``. (Vincent Ladeuil)
757
* Conflicts involving non-ascii filenames are now properly reported rather
758
than failing with a UnicodeEncodeError. (Martin [GZ], #686161)
760
* Correct parent is now set when using 'switch -b' with bound branches.
761
(A. S. Budden, #513709)
763
* Fix `bzr plugins` regression in bzr 2.4 which resulted in a traceback
764
from writelines on ckj terminals. (Martin [GZ], #754082)
766
* ``WT.inventory`` and ``WT.iter_entries_by_dir()`` was not correctly
767
reporting subdirectories that were tree references (in formats that
768
supported them). (John Arbash Meinel, #764677)
770
* Merging into empty branches now gives an error as this is currently
771
not supported. (Jonathan Riddell, #242175)
773
* Do not show exception to user on pointless commit error.
774
(Jonathan Riddell #317357)
776
* ``WT.update_basis_by_delta`` no longer requires that the deltas match
777
the current WT state. This allows ``update_basis_by_delta`` to be used
778
by more commands than just commit. Updating with a delta allows us to
779
not load the whole inventory, which can take 10+s with large trees.
780
(Jonathan Riddell, John Arbash Meinel, #781168)
782
* ``bzr mv --after old_name new_name`` now works if "new_name" is newly
783
added. (Benoît Pierre)
789
.. Improved or updated documentation.
791
* Restore the workaround for option names including dots (--1.14) which was
792
disabled when we stopped listing --1.9 as a format.
793
(Vincent Ladeuil, #782289)
798
.. Changes that may require updates in plugins or other code that uses
801
* ``annotate_file`` has been deprecated in favor of
802
``annotate_file_revision_tree``. (Jelmer Vernooij, #775598)
804
* ``Branch.fetch`` now takes an optional ``limit`` argument.
805
(Andrew Bennetts, Jelmer Vernooij, #750175)
807
* ``Inter.get`` now raises ``NoCompatibleInter`` if there are no
808
compatible optimisers rather than an instance of the class it is called
809
on. (Jelmer Vernooij)
811
* ``Branch.push`` now takes a ``lossy`` argument.
812
``Branch.lossy_push`` has been removed.
815
* New method ``Repository.get_file_graph`` which can return the
816
per-file revision graph. (Jelmer Vernooij, #775578)
818
* The default implementation of ``Branch`` is now oriented to
819
storing the branch tip. Branch implementations which store the full
820
history should now subclass ``FullHistoryBzrBranch``.
821
``Branch._last_revision_info`` has been renamed to
822
``Branch._read_last_revision_info`` (Jelmer Vernooij)
824
* ``Tree.__iter__`` has been deprecated; use ``Tree.all_file_ids``
825
instead. (Jelmer Vernooij)
827
* ``Tree.get_symlink_target`` now takes an optional ``path``
828
argument. (Jelmer Vernooij)
833
.. Major internal changes, unlikely to be visible to users or plugin
834
developers, but interesting for bzr developers.
836
* ``MutableTree.smart_add`` now uses inventory deltas.
837
(Jelmer Vernooij, #146165)
839
* Removed ``bzrlib.branch._run_with_write_locked_target`` as
840
``bzrlib.cleanup`` provides the same functionality in a more general
841
way. (Andrew Bennetts)
846
.. Fixes and changes that are only relevant to bzr's test framework and
847
suite. This can include new facilities for writing tests, fixes to
848
spurious test failures and changes to the way things should be tested.
850
* A test that was expected to fail but passes instead now counts as a failure
851
catching up with new testtools and subunit handling. (Martin [GZ], #654474)
853
* Make it easier for plugins to reuse the per_workingtree scenarios by
854
restoring the wt_scenarios helper that was accidentally deleted.
855
(Vincent Ladeuil, #783472)
857
* Removed ``test_breakin`` tests that were excessively prone to hanging,
858
did not work on Wine, and partly already disabled.
859
(Martin Pool, #408814, #746985)
861
* Windows locations are different and should be tested accordingly.
862
(Vincent Ladeuil, #788131)
869
This is the second beta of the 2.4 series, leading to a 2.4.0 release in
870
August 2011. Beta releases are suitable for everyday use but may cause some
871
incompatibilities with plugins.
873
This release includes all bug fixed in previous series known at the time of
877
External Compatibility Breaks
878
*****************************
880
.. These may require users to change the way they use Bazaar.
882
* Two command synonyms for ``bzr branch`` have been deprecated, to avoid
883
confusion and to allow the names to later be reused. The removed names
884
are: ``get`` and ``clone``. (Martin Pool, #506265)
889
.. New commands, options, etc that users may wish to try out.
891
* ``bzr commit`` now supports a ``--lossy`` argument that can be used
892
to discard any data that can not be natively represented when committing
893
to a foreign VCS. (Jelmer Vernooij, #587721)
898
.. Improvements to existing commands, especially improved performance
899
or memory usage, or better results.
901
* ``bzr merge`` in large trees is now significantly faster. On a 70k entry
902
tree, the time went from ~3min down to 30s. This also effects ``bzr pull``
903
and ``bzr update`` since they use the same merge logic to update the
904
WorkingTree. (John Arbash Meinel, #759091)
906
* ``bzr revert`` now properly uses ``bzr status``'s optimized
907
``iter_changes``. This can be a significant performance difference (33s
908
to 5s on large trees). (John Arbash Meinel, #759096)
910
* Resolve ``lp:FOO`` urls locally rather than doing an XMLRPC request if
911
the user has done ``bzr launchpad-login``. The bzr+ssh URLs were already
912
being handed off to the remote server anyway (xmlrpc has been mapping
913
``lp:bzr`` to ``bzr+ssh://bazaar.launchpad.net/+branch/bzr``, rather
914
than ``bzr+ssh://bazaar.launchpad.net/~bzr-pqm/bzr/bzr.dev`` for a few
915
months now.) By doing it ourselves, we can cut out substantial startup
916
time. From Netherlands to London it was taking 368ms to do the XMLRPC
917
call as much as 2s from Sydney. You can test the local logic by using
918
``-Dlaunchpad``. (John Arbash Meinel, #397739)
920
* When building a new WorkingTree (such as during ``bzr co`` or
921
``bzr branch``) we now properly store the stat and hash of files that
922
are old enough. This saves a fair amount of time on the first
923
``bzr status`` (on a 500MB tree, it saves about 30+s).
924
(John Arbash Meinel, #740932)
930
.. Fixes for situations where bzr would previously crash or give incorrect
931
or undesirable results.
933
* Arguments that can't be decoded to unicode in the current posix locale give
934
a clearer error message without a traceback. (Martin [gz], #745712)
936
* ``bzrlib.log._DEFAULT_REQUEST_PARAMS`` is no longer accidentally
937
mutated by ``bzrlib.log._apply_log_request_defaults``. In practice
938
these default values aren't relied on very often so this probably
939
wasn't causing any trouble. (Andrew Bennetts)
941
* ``bzr log`` now works on revisions which are not in the current branch.
942
(Matt Giuca, #241998)
944
* Don't rewrite the dirstate file when non-interesting changes have
945
occurred. This can significantly improve 'bzr status' times when there
946
are only small changes to a large tree.
947
(Ian Clatworthy, John Arbash Meinel, #380202)
949
* Lazy hooks are now reset between test runs. (Jelmer Vernooij, #745566)
951
* ``bzrlib.merge.Merge`` now calls ``iter_changes`` without
952
``include_unversioned=True``. This makes it significantly faster in many
953
cases, because it only looks at modified files, rather than building
954
information about all files. This can cause failures in other
955
TreeTransform code, because it had been expecting to know the names of
956
things which had not changed (such as parent directories). All cases we
957
know about so far have been fixed, but there may be fallout for edge
958
cases that we are missing. (John Arbash Meinel, #759091)
960
* ``SFTPTransport`` is more pro-active about closing file-handles. This
961
reduces the chance of having threads fail from async requests while
962
running the test suite. (John Arbash Meinel, #656170)
964
* Standalone bzr.exe installation on Windows: user can put additional python
965
libraries into ``site-packages`` subdirectory of the installation directory,
966
this might be required for "installing" extra dependencies for some plugins.
967
(Alexander Belchenko, #743256)
969
* ``transform.revert()`` has been updated to use
970
``wt.iter_changes(basis_tree)`` rather than
971
``basis_tree.iter_changes(wt)``. This allows the optimized code path to
972
kick in, improving ``bzr revert`` times significantly (33s to 4s on
973
large trees, 0.7s to 0.3s on small trees.) (John Arbash Meinel, #759096)
975
* ``TreeTransform.create_file/new_file`` can now take an optional ``sha1``
976
parameter. If supplied, when the transform is applied, it will then call
977
``self._tree._observed_sha1`` for those files. This lets us update the
978
hash-cache for content that we create, preventing us from re-reading the
979
content in the next ``bzr status``. (John Arbash Meinel, #740932)
984
* Added a section about using a shared SSH account on a server for bzr+ssh
985
access. (Russell Smith)
987
* The documentation now recommends using SSH rather than SFTP in the
988
tutorials and the examples, because that will generally be much faster
989
and better in cases where it can be used. SFTP is still available and
990
mentioned as an alternative. (Martin Pool, #636712)
995
.. Changes that may require updates in plugins or other code that uses
998
* ``Branch.update_revisions`` has been made private and should no
999
longer be used by external users. Use ``Branch.pull`` or ``Branch.push``
1000
instead. (Jelmer Vernooij, #771765)
1002
* Commands now have an `invoked_as` attribute, showing the name under
1003
which they were called before alias expansion.
1006
* ``Hooks.create_hook`` is now deprecated in favour of ``Hooks.add_hook``.
1009
* If you call `bzrlib.initialize` but forget to enter the resulting object
1010
as a context manager, bzrlib will now be initialized anyhow.
1011
(Previously simple programs calling bzrlib might find the library was
1012
mysteriously silent.)
1015
* Inventory-specific functionality has been split out of ``Tree`` into
1016
a new ``InventoryTree`` class. Tree instances no longer
1017
necessarily provide an ``inventory`` attribute. (Jelmer Vernooij)
1019
* Inventory-specific functionality has been split out of ``RevisionTree``
1020
into a new ``InventoryRevisionTree`` class. RevisionTree instances no
1021
longer necessarily provide an ``inventory`` attribute. (Jelmer Vernooij)
1023
* New method ``Hooks.uninstall_named_hook``. (Jelmer Vernooij, #301472)
1025
* ``revision_graph_can_have_wrong_parents`` is now an attribute
1026
on ``RepositoryFormat`` rather than a method on ``Repository``.
1029
* ``Testament`` now takes a ``tree`` rather than an
1030
``inventory``. (Jelmer Vernooij, #762608)
1032
* ``TestCase.failUnlessExists`` and ``failIfExists`` are deprecated in
1033
favour of ``assertPathExists`` and ``assertPathDoesNotExist``
1037
* The ``revno`` parameter of ``log.LogRevision`` may now be None,
1038
representing a revision which is not in the current branch.
1039
(Matt Giuca, #241998)
1041
* The various knit pack repository format classes have been moved
1042
from ``bzrlib.repofmt.pack_repo`` to
1043
``bzrlib.repofmt.knitpack_repo``. (Jelmer Vernooij)
1045
* ``RevisionTree`` now has a new method ``get_file_revision``.
1048
* ``WorkingTree`` no longer provides an ``inventory``. Instead,
1049
all inventory-related functionality is now on the subclass
1050
``InventoryWorkingTree`` that all native Bazaar working tree
1051
implementations derive from. (Jelmer Vernooij)
1056
.. Major internal changes, unlikely to be visible to users or plugin
1057
developers, but interesting for bzr developers.
1059
* Added ``osutils.lstat`` and ``osutils.fstat``. These are just the ``os``
1060
functions on Linux, but they are wrapped on Windows so that fstat
1061
matches lstat results across all python versions.
1062
(John Arbash Meinel)
1064
* ``WorkingTree._observed_sha1`` also updates the 'size' column. It
1065
happened to be updated as a side-effect of commit, but if we start using
1066
the function elsewhere we might as well do it directly.
1067
(John Arbash Meinel)
1072
.. Fixes and changes that are only relevant to bzr's test framework and
1073
suite. This can include new facilities for writing tests, fixes to
1074
spurious test failures and changes to the way things should be tested.
1076
* Stop using `failIf`, `failUnless`, `failIfEqual`, etc, that give
1077
`PendingDeprecationWarnings` on Python2.7.
1078
(Martin Pool, #760435)
1086
This is the first beta of the 2.4 series, leading up to a 2.4.0
1087
release in August 2011. Beta releases are suitable for everyday use
1088
but may cause some incompatibilities with plugins. Some plugins may need
1089
small updates to work with 2.4b1.
1091
External Compatibility Breaks
1092
*****************************
1099
* Added ``changelog_merge`` plugin for merging changes to ``Changelog`` files
1100
in GNU format. See ``bzr help changelog_merge`` for details.
1103
* Configuration options can now use references to other options in the same
1104
file by enclosing them with curly brackets (``{other_opt}``). This makes it
1105
possible to use, for example,
1106
``push_location=lp:~vila/bzr/config-{nickname}`` in ``branch.conf`` when
1107
using a loom. During the beta period, the default behaviour is to disable
1108
this feature. It can be activated by declaring ``bzr.config.expand = True``
1109
in ``bazaar.conf``. (Vincent Ladeuil)
1111
* External merge tools can now be configured in bazaar.conf. See
1112
``bzr help configuration`` for more information. (Gordon Tyler, #489915)
1114
* The ``lp:`` directory service now supports Launchpad's QA staging.
1115
(Jelmer Vernooij, #667483)
1120
* A new hidden command ``bzr repair-workingtree``. This is a way to force
1121
the dirstate file to be rebuilt, rather than using a ``bzr checkout``
1122
workaround. (John Arbash Meinel)
1124
* Added a ``Branch.heads_to_fetch`` RPC to the smart server protocol.
1125
This allows formats from plugins (such as looms) to efficiently tell the
1126
client which revisions need to be fetched. (Andrew Bennetts)
1128
* Branching, merging and pulling a branch now copies revisions named in
1129
tags, not just the tag metadata. (Andrew Bennetts, #309682)
1131
* ``bzr cat-revision`` no longer requires a working tree.
1132
(Jelmer Vernooij, #704405)
1134
* ``bzr export --per-file-timestamps`` for .tar.gz files will now
1135
override the mtime for trees exported on Python 2.7 and later, which
1136
expose the 'mtime' field in gzip files. This makes the output of
1137
``bzr export --per-file-timestamps`` for a particular tree
1138
deterministic. (Jelmer Vernooij, #711226)
1140
* ``bzr export --format=zip`` can now export to standard output,
1141
like the other exporters can. (Jelmer Vernooij, #513752)
1143
* ``bzr export`` can now create ``.tar.xz`` and ``.tar.lzma`` files.
1144
(Jelmer Vernooij, #551714)
1146
* Getting all entries from ``CHKInventory.iter_entries_by_dir()`` has been
1147
sped up dramatically for large trees. Iterating by dir is not the best
1148
way to load data from a CHK inventory, so it preloads all the items in
1149
the correct order. (With the gcc-tree, this changes it (re)reading 8GB
1150
of CHK data, down to just 150MB.) This has noticeable affects for things
1151
like building checkouts, etc. (John Arbash Meinel, #737234)
1156
* A MemoryError thrown on the server during a remote operation will now be
1157
usefully reported, and other unexpected errors will include the class name.
1158
(Martin [gz], #722416)
1160
* ``bzr annotate -r-1 file`` will now properly annotate a deleted file.
1161
(Andrew King, #537442)
1163
* ``bzr export`` to zip files will now set a mode on directories.
1164
(Jelmer Vernooij, #207253)
1166
* ``bzr export`` to tgz files will only write out the basename of the
1167
tarfile to the gzip file. (Jelmer Vernooij, #102234)
1169
* ``bzr push --overwrite`` with an older revision specified will now correctly
1170
roll back the target branch. (Jelmer Vernooij, #386576)
1172
* ``bzr lp-propose`` can now propose merges against packaging branches on
1173
Launchpad without requiring the target branch to be specified.
1174
(Jelmer Vernooij, #704647)
1176
* ``bzr lp-propose`` no longer requires a reviewer to be specified. It will
1177
instead leave setting the reviewer up to Launchpad if it was not specified.
1178
(Jelmer Vernooij, #583772)
1180
* ``bzr pull`` will now exit with exit code 1 if there were tag conflicts.
1181
(Jelmer Vernooij, #213185)
1183
* ``bzr mv`` user errors no longer throw UnicodeEncodeError with non-ascii
1184
paths, however they may still print junk if not on a UTF-8 terminal.
1185
(Martin [gz], #707954)
1187
* ``bzr reconfigure --unstacked`` now copies revisions (and their
1188
ancestors) named in tags into the unstacked repository, not just the
1189
ancestry of the branch's tip. (Andrew Bennetts, #401646)
1191
* ``bzr serve`` no longer crashes when a server_started hook is installed and
1192
IPv6 support is available on the system. (Jelmer Vernooij, #293697)
1194
* ``bzr status`` will not rewrite the dirstate file if it only has
1195
'trivial' changes. (Currently limited to dir updates and newly-added
1196
files changing state.) This saves a bit of time for regular operations.
1197
eg. ``bzr status`` in a 100k tree takes 1.4s to compute the status, but 1s
1198
to re-save the dirstate file. (John Arbash Meinel, #765881)
1200
* ``bzr tags`` will no longer choke on branches with ghost revisions in
1201
their mainline and tags on revisions not in the branch ancestry.
1202
(Jelmer Vernooij, #397556)
1204
* ``bzr whoami`` will now display an error if both a new identity and
1205
``--email`` were specified. (Jelmer Vernooij, #680449)
1207
* ``launchpadlib`` doesn't provide the ``uris`` module in some old versions.
1208
(Vincent Ladeuil, #706835)
1210
* Empty entries in the ``NO_PROXY`` variable are no longer treated as matching
1212
(Martin Pool, #586341)
1214
* Plugins incompatible with the current version of bzr no longer produce a
1215
warning on every command invocation. Instead, a message is shown by
1216
``bzr plugins`` and in crash reports.
1217
(#704195, Martin Pool)
1219
* The "pretty" version of ``needs_read_lock`` and ``needs_write_lock`` now
1220
preserves the identity of default parameter values.
1221
(Andrew Bennetts, #718569)
1223
* ``bzr dump-btree --raw`` no longer tracebacks on a B-Tree file
1224
containing no rows. (Eric Siegerman, #715508)
1226
* Fix ``bzr lp-mirror`` to work on command line branch URLs and branches
1227
without an explicit public location. (Max Bowsher)
1229
* On Python 2.6 and higher, use multiprocessing.cpu_count() to retrieve the
1230
number of available processors. (Jelmer Vernooij, #693140)
1235
* Added ``Branch.heads_to_fetch`` method. Implementations of the Branch API
1236
must now inherit or implement this method. (Andrew Bennetts, #721328)
1238
* Added ``bzrlib.mergetools`` module with helper functions for working with
1239
the list of external merge tools. (Gordon Tyler, #489915)
1241
* All methods and arguments that were deprecated before 2.0
1242
have been removed. (Jelmer Vernooij)
1244
* Branch formats should now be registered on the format registry
1245
(``bzrlib.branch.format_registry``) rather than using the class
1246
methods on ``BranchFormat``. (Jelmer Vernooij, #714729)
1248
* ``Branch.set_revision_history`` is now deprecated.
1251
* ``BranchFormat.supports_leaving_lock()`` and
1252
``RepositoryFormat.supports_leaving_lock`` flags have been added.
1255
* ``Branch.fetch`` implementations must now accept an optional
1256
``fetch_tags`` keyword argument. (Andrew Bennetts)
1258
* ``Branch.import_last_revision_info`` is deprecated. Use the
1259
``import_last_revision_info_and_tags`` method instead.
1262
* Because it was too specific to BzrDir implementations,
1263
``ControlDir.sprout`` no longer has a default implementation; it now
1264
raises ``NotImplementedError``. (Jelmer Vernooij, #717937)
1266
* ``bzrlib.deprecated_graph`` has been removed. ``bzrlib.graph``
1267
scales better tree and should be used instead.
1268
(Jelmer Vernooij, #733612)
1270
* ``ControlDirFormat.register_format`` has been removed. Instead,
1271
``Prober`` implementations should now implement a ``known_formats``
1272
method. (Jelmer Vernooij)
1274
* ControlDirFormats can now provide a ``check_status`` method and
1275
raise a custom exception or warning when an unsupported or deprecated
1276
format is being opened. (Jelmer Vernooij, #731311)
1278
* ``bzrlib.revionspec.dwim_revspecs`` is deprecated.
1279
Use ``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_revspec`` and
1280
``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_lazy_revspec``
1281
instead. (Jelmer Vernooij, #721971)
1283
* ``BzrDirFormat`` has a new attribute ``fixed_components`` that
1284
indicates whether the components of the bzrdir can be upgraded
1285
independent of the ``BzrDir``. (Jelmer Vernooij)
1287
* ``BzrProber.register_format`` and ``BzrProber.unregister_format`` are
1288
now deprecated in favour of the ``BzrProber.formats`` format registry.
1291
* ``ControlDir`` implementations no longer have to provide the
1292
``get_branch_transport``, ``get_workingtree_transport`` and
1293
``get_repository_transport`` methods. (Jelmer Vernooij, #730325)
1295
* ``Converter`` has been moved from ``bzrlib.bzrdir`` to
1296
``bzrlib.controldir``. (Jelmer Vernooij)
1298
* Repository formats can now provide
1299
``_get_extra_interrepo_test_combinations`` in the same module
1300
to provide extra test combinations for ``bzrlib.tests.per_repository``.
1303
* Repository formats should now be registered on the format registry
1304
(``bzrlib.repository.format_registry``) rather than using the class
1305
methods on ``RepositoryFormat``. (Jelmer Vernooij)
1307
* Repository formats can now indicate they do not support the full
1308
VersionedFiles API by setting the ``supports_full_versioned_files``
1309
attribute to False. A subset of the VersionedFiles API
1310
(signatures and text graphs) still needs to be supported.
1313
* Repository formats have a new method ``is_deprecated`` that
1314
implementations can override to return True to trigger a deprecation
1315
warning. (Jelmer Vernooij)
1317
* The ``revision_id`` parameter of
1318
``Repository.search_missing_revision_ids`` and
1319
``InterRepository.search_missing_revision_ids`` is deprecated. It is
1320
replaced by the ``revision_ids`` parameter. (Andrew Bennetts)
1322
* Working tree formats should now be registered on the format registry
1323
(``bzrlib.working_tree.format_registry``) rather than using the class
1324
methods on ``WorkingTreeFormat``. (Jelmer Vernooij, #714730)
1326
* Exporting may now be done with a generator
1327
(``bzrlib.export.get_export_generator``) (Geoff/xaav, #791005)
1332
* ``CatchingExceptionThread`` (formerly ThreadWithException) has been moved
1333
out of the ``bzrlib.tests`` hierarchy to make it clearer that it can be used
1334
outside of tests. This class makes it easier to track exceptions in threads
1335
by catching them so they can be re-raised in the controlling thread. It's
1336
available in the ``bzrlib.cethread`` module. (Vincent Ladeuil)
1338
* Correctly propagate malloc failures from diff-delta.c code as MemoryError
1339
so OOM conditions during groupcompress are clearly reported. This entailed a
1340
change to several function signatures. (Martin [gz], #633336)
1342
* ``HookPoint.lazy_hook`` and ``Hooks.install_named_lazy_hook`` can install
1343
hooks for which the callable is loaded lazily. (Jelmer Vernooij)
1348
* The Range parsing for HTTP requests will correctly parse incomplete ranges.
1349
(Vincent Ladeuil, #731240)
1352
vim: tw=74 ft=rst ff=unix