11
:2.4b1: 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.
23
* The ``lp:`` directory service now supports Launchpad's QA staging.
24
(Jelmer Vernooij, #667483)
26
* External merge tools can now be configured in bazaar.conf. See
27
``bzr help configuration`` for more information. (Gordon Tyler, #489915)
29
* Configuration options can now use references to other options in the same
30
file by enclosing them with curly brackets (``{other_opt}``). This makes it
31
possible to use, for example,
32
``push_location=lp:~vila/bzr/config-{nickname}`` in ``branch.conf`` when
33
using a loom. During the beta period, the default behaviour is to disable
34
this feature. It can be activated by declaring ``bzr.config.expand = True``
35
in ``bazaar.conf``. (Vincent Ladeuil)
40
.. Improvements to existing commands, especially improved performance
41
or memory usage, or better results.
43
* A new hidden command ``bzr repair-workingtree``. This is a way to force
44
the dirstate file to be rebuilt, rather than using a ``bzr checkout``
45
workaround. (John Arbash Meinel)
47
* Added a ``Branch.heads_to_fetch`` RPC to the smart server protocol.
48
This allows formats from plugins (such as looms) to efficiently tell the
49
client which revisions need to be fetched. (Andrew Bennetts)
51
* Branching, merging and pulling a branch now copies revisions named in
52
tags, not just the tag metadata. (Andrew Bennetts, #309682)
54
* ``bzr cat-revision`` no longer requires a working tree. (Jelmer Vernooij, #704405)
59
.. Fixes for situations where bzr would previously crash or give incorrect
60
or undesirable results.
62
* A MemoryError thrown on the server during a remote operation will now be
63
usefully reported, and other unexpected errors will include the class name.
64
(Martin [gz], #722416)
66
* ``bzr annotate -r-1 file`` will now properly annotate a deleted file.
67
(Andrew King, #537442)
69
* ``bzr export`` to zip files will now set a mode on directories.
70
(Jelmer Vernooij, #207253)
72
* ``bzr push --overwrite`` with an older revision specified will now correctly
73
roll back the target branch. (Jelmer Vernooij, #386576)
75
* ``bzr lp-propose`` can now propose merges against packaging branches on
76
Launchpad without requiring the target branch to be specified.
77
(Jelmer Vernooij, #704647)
79
* ``bzr lp-propose`` no longer requires a reviewer to be specified. It will
80
instead leave setting the reviewer up to Launchpad if it was not specified.
81
(Jelmer Vernooij, #583772)
83
* ``bzr pull`` will now exit with exit code 1 if there were tag conflicts.
84
(Jelmer Vernooij, #213185)
86
* ``bzr mv`` user errors no longer throw UnicodeEncodeError with non-ascii
87
paths, however they may still print junk if not on a UTF-8 terminal.
88
(Martin [gz], #707954)
90
* ``bzr reconfigure --unstacked`` now copies revisions (and their
91
ancestors) named in tags into the unstacked repository, not just the
92
ancestry of the branch's tip. (Andrew Bennetts, #401646)
94
* ``bzr serve`` no longer crashes when a server_started hook is installed and
95
IPv6 support is available on the system. (Jelmer Vernooij, #293697)
97
* ``bzr tags`` will no longer choke on branches with ghost revisions in
98
their mainline and tags on revisions not in the branch ancestry.
99
(Jelmer Vernooij, #397556)
101
* ``bzr whoami`` will now display an error if both a new identity and
102
``--email`` were specified. (Jelmer Vernooij, #680449)
104
* ``launchpadlib`` doesn't provide the ``uris`` module in some old versions.
105
(Vincent Ladeuil, #706835)
107
* Empty entries in the ``NO_PROXY`` variable are no longer treated as matching
109
(Martin Pool, #586341)
111
* Plugins incompatible with the current version of bzr no longer produce a
112
warning on every command invocation. Instead, a message is shown by
113
``bzr plugins`` and in crash reports.
114
(#704195, Martin Pool)
116
* The "pretty" version of ``needs_read_lock`` and ``needs_write_lock`` now
117
preserves the identity of default parameter values.
118
(Andrew Bennetts, #718569)
120
* ``bzr dump-btree --raw`` no longer tracebacks on a B-Tree file
121
containing no rows. (Eric Siegerman, #715508)
123
* Fix ``bzr lp-mirror`` to work on command line branch URLs and branches
124
without an explicit public location. (Max Bowsher)
126
* On Python 2.6 and higher, use multiprocessing.cpu_count() to retrieve the
127
number of available processors. (Jelmer Vernooij, #693140)
132
.. Improved or updated documentation.
137
.. Changes that may require updates in plugins or other code that uses
140
* Added ``Branch.heads_to_fetch`` method. Implementions of the Branch API
141
must now inherit or implement this method. (Andrew Bennetts, #721328)
143
* Added ``bzrlib.mergetools`` module with helper functions for working with
144
the list of external merge tools. (Gordon Tyler, #489915)
146
* All methods and arguments that were deprecated before 2.0
147
have been removed. (Jelmer Vernooij)
149
* Branch formats should now be registered on the format registry
150
(``bzrlib.branch.format_registry``) rather than using the class
151
methods on ``BranchFormat``. (Jelmer Vernooij, #714729)
153
* ``BranchFormat.supports_leaving_lock()`` and
154
``RepositoryFormat.supports_leaving_lock`` flags have been added.
157
* ``Branch.fetch`` implementations must now accept an optional
158
``fetch_spec`` keyword argument. (Andrew Bennetts)
160
* ``Branch.import_last_revision_info`` is deprecated. Use the
161
``import_last_revision_info_and_tags`` method instead.
164
* ``bzrlib.revionspec.dwim_revspecs`` is deprecated.
165
Use ``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_revspec`` and
166
``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_lazy_revspec``
167
instead. (Jelmer Vernooij, #721971)
169
* ``BzrDirFormat`` has a new attribute ``fixed_components`` that
170
indicates whether the components of the bzrdir can be upgraded
171
independent of the ``BzrDir``. (Jelmer Vernooij)
173
* ``BzrProber.register_format`` and ``BzrProber.unregister_format`` are
174
now deprecated in favour of the ``BzrProber.formats`` format registry.
177
* ``ControlDir`` implementations no longer have to provide the ``get_branch_transport``,
178
``get_workingtree_transport`` and ``get_repository_transport`` methods.
179
(Jelmer Vernooij, #730325)
181
* ``Converter`` has been moved from ``bzrlib.bzrdir`` to
182
``bzrlib.controldir``. (Jelmer Vernooij)
184
* Repository formats can now provide
185
``_get_extra_interrepo_test_combinations`` in the same module
186
to provide extra test combinations for ``bzrlib.tests.per_repository``.
189
* Repository formats should now be registered on the format registry
190
(``bzrlib.repository.format_registry``) rather than using the class
191
methods on ``RepositoryFormat``. (Jelmer Vernooij)
193
* Repository formats can now indicate they do not support the full
194
VersionedFiles API by setting the ``supports_full_versioned_files``
195
attribute to False. A subset of the VersionedFiles API
196
(signatures and text graphs) still needs to be supported.
199
* Repository formats have a new method ``is_deprecated`` that
200
implementations can override to return True to trigger a deprecation
201
warning. (Jelmer Vernooij)
203
* The ``revision_id`` parameter of
204
``Repository.search_missing_revision_ids`` and
205
``InterRepository.search_missing_revision_ids`` is deprecated. It is
206
replaced by the ``revision_ids`` parameter. (Andrew Bennetts)
208
* Working tree formats should now be registered on the format registry
209
(``bzrlib.working_tree.format_registry``) rather than using the class
210
methods on ``WorkingTreeFormat``. (Jelmer Vernooij, #714730)
215
.. Major internal changes, unlikely to be visible to users or plugin
216
developers, but interesting for bzr developers.
218
* ``CatchingExceptionThread`` (formerly ThreadWithException) has been moved
219
out of the ``bzrlib.tests`` hierarchy to make it clearer that it can be used
220
outside of tests. This class makes it easier to track exceptions in threads
221
by cacthing them so they can be re-raised in the controlling thread. It's
222
available in the ``bzrlib.cethread`` module. (Vincent Ladeuil)
224
* ``HookPoint.lazy_hook`` and ``Hooks.install_named_lazy_hook`` can install
225
hooks for which the callable is loaded lazily. (Jelmer Vernooij)
230
.. Fixes and changes that are only relevant to bzr's test framework and
231
suite. This can include new facilities for writing tests, fixes to
232
spurious test failures and changes to the way things should be tested.
234
* The Range parsing for HTTP requests will correctly parse incomplete ranges.
235
(Vincent Ladeuil, #731240)
238
vim: tw=74 ft=rst ff=unix