11
:2.4b2: 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.
29
* Resolve ``lp:FOO`` urls locally rather than doing an XMLRPC request if
30
the user has done ``bzr launchpad-login``. The bzr+ssh URLs were already
31
being handed off to the remote server anyway (xmlrpc has been mapping
32
``lp:bzr`` to ``bzr+ssh://bazaar.launchpad.net/+branch/bzr``, rather
33
than ``bzr+ssh://bazaar.launchpad.net/~bzr-pqm/bzr/bzr.dev`` for a few
34
months now.) By doing it ourselves, we can cut out substantial startup
35
time. From Netherlands to London it was taking 368ms to do the XMLRPC
36
call as much as 2s from Sydney. You can test the local logic by using
37
``-Dlaunchpad``. (John Arbash Meinel, #397739)
42
.. Fixes for situations where bzr would previously crash or give incorrect
43
or undesirable results.
45
* Lazy hooks are now reset between test runs. (Jelmer Vernooij, #745566)
50
* Added a section about using a shared SSH account on a server for bzr+ssh
51
access. (Russell Smith)
56
.. Changes that may require updates in plugins or other code that uses
59
* ``Hooks.create_hook`` is now deprecated in favour of ``Hooks.add_hook``.
62
* If you call `bzrlib.initialize` but forget to enter the resulting object
63
as a context manager, bzrlib will now be initialized anyhow.
64
(Previously simple programs calling bzrlib might find the library was
68
* New method ``Hooks.uninstall_named_hook``. (Jelmer Vernooij, #301472)
73
.. Major internal changes, unlikely to be visible to users or plugin
74
developers, but interesting for bzr developers.
79
.. Fixes and changes that are only relevant to bzr's test framework and
80
suite. This can include new facilities for writing tests, fixes to
81
spurious test failures and changes to the way things should be tested.
89
This is the first beta of the 2.4 series, leading up to a 2.4.0
90
release in August 2011. Beta releases are suitable for everyday use
91
but may cause some incompatibilities with plugins. Some plugins may need
92
small updates to work with 2.4b1.
94
External Compatibility Breaks
95
*****************************
102
* Added ``changelog_merge`` plugin for merging changes to ``Changelog`` files
103
in GNU format. See ``bzr help changelog_merge`` for details.
106
* Configuration options can now use references to other options in the same
107
file by enclosing them with curly brackets (``{other_opt}``). This makes it
108
possible to use, for example,
109
``push_location=lp:~vila/bzr/config-{nickname}`` in ``branch.conf`` when
110
using a loom. During the beta period, the default behaviour is to disable
111
this feature. It can be activated by declaring ``bzr.config.expand = True``
112
in ``bazaar.conf``. (Vincent Ladeuil)
114
* External merge tools can now be configured in bazaar.conf. See
115
``bzr help configuration`` for more information. (Gordon Tyler, #489915)
117
* The ``lp:`` directory service now supports Launchpad's QA staging.
118
(Jelmer Vernooij, #667483)
123
* A new hidden command ``bzr repair-workingtree``. This is a way to force
124
the dirstate file to be rebuilt, rather than using a ``bzr checkout``
125
workaround. (John Arbash Meinel)
127
* Added a ``Branch.heads_to_fetch`` RPC to the smart server protocol.
128
This allows formats from plugins (such as looms) to efficiently tell the
129
client which revisions need to be fetched. (Andrew Bennetts)
131
* Branching, merging and pulling a branch now copies revisions named in
132
tags, not just the tag metadata. (Andrew Bennetts, #309682)
134
* ``bzr cat-revision`` no longer requires a working tree.
135
(Jelmer Vernooij, #704405)
137
* ``bzr export --per-file-timestamps`` for .tar.gz files will now
138
override the mtime for trees exported on Python 2.7 and later, which
139
expose the 'mtime' field in gzip files. This makes the output of
140
``bzr export --per-file-timestamps`` for a particular tree
141
deterministic. (Jelmer Vernooij, #711226)
143
* ``bzr export --format=zip`` can now export to standard output,
144
like the other exporters can. (Jelmer Vernooij, #513752)
146
* ``bzr export`` can now create ``.tar.xz`` and ``.tar.lzma`` files.
147
(Jelmer Vernooij, #551714)
149
* Getting all entries from ``CHKInventory.iter_entries_by_dir()`` has been
150
sped up dramatically for large trees. Iterating by dir is not the best
151
way to load data from a CHK inventory, so it preloads all the items in
152
the correct order. (With the gcc-tree, this changes it (re)reading 8GB
153
of CHK data, down to just 150MB.) This has noticeable affects for things
154
like building checkouts, etc. (John Arbash Meinel, #737234)
160
* A MemoryError thrown on the server during a remote operation will now be
161
usefully reported, and other unexpected errors will include the class name.
162
(Martin [gz], #722416)
164
* ``bzr annotate -r-1 file`` will now properly annotate a deleted file.
165
(Andrew King, #537442)
167
* ``bzr export`` to zip files will now set a mode on directories.
168
(Jelmer Vernooij, #207253)
170
* ``bzr export`` to tgz files will only write out the basename of the
171
tarfile to the gzip file. (Jelmer Vernooij, #102234)
173
* ``bzr push --overwrite`` with an older revision specified will now correctly
174
roll back the target branch. (Jelmer Vernooij, #386576)
176
* ``bzr lp-propose`` can now propose merges against packaging branches on
177
Launchpad without requiring the target branch to be specified.
178
(Jelmer Vernooij, #704647)
180
* ``bzr lp-propose`` no longer requires a reviewer to be specified. It will
181
instead leave setting the reviewer up to Launchpad if it was not specified.
182
(Jelmer Vernooij, #583772)
184
* ``bzr pull`` will now exit with exit code 1 if there were tag conflicts.
185
(Jelmer Vernooij, #213185)
187
* ``bzr mv`` user errors no longer throw UnicodeEncodeError with non-ascii
188
paths, however they may still print junk if not on a UTF-8 terminal.
189
(Martin [gz], #707954)
191
* ``bzr reconfigure --unstacked`` now copies revisions (and their
192
ancestors) named in tags into the unstacked repository, not just the
193
ancestry of the branch's tip. (Andrew Bennetts, #401646)
195
* ``bzr serve`` no longer crashes when a server_started hook is installed and
196
IPv6 support is available on the system. (Jelmer Vernooij, #293697)
198
* ``bzr tags`` will no longer choke on branches with ghost revisions in
199
their mainline and tags on revisions not in the branch ancestry.
200
(Jelmer Vernooij, #397556)
202
* ``bzr whoami`` will now display an error if both a new identity and
203
``--email`` were specified. (Jelmer Vernooij, #680449)
205
* ``launchpadlib`` doesn't provide the ``uris`` module in some old versions.
206
(Vincent Ladeuil, #706835)
208
* Empty entries in the ``NO_PROXY`` variable are no longer treated as matching
210
(Martin Pool, #586341)
212
* Plugins incompatible with the current version of bzr no longer produce a
213
warning on every command invocation. Instead, a message is shown by
214
``bzr plugins`` and in crash reports.
215
(#704195, Martin Pool)
217
* The "pretty" version of ``needs_read_lock`` and ``needs_write_lock`` now
218
preserves the identity of default parameter values.
219
(Andrew Bennetts, #718569)
221
* ``bzr dump-btree --raw`` no longer tracebacks on a B-Tree file
222
containing no rows. (Eric Siegerman, #715508)
224
* Fix ``bzr lp-mirror`` to work on command line branch URLs and branches
225
without an explicit public location. (Max Bowsher)
227
* On Python 2.6 and higher, use multiprocessing.cpu_count() to retrieve the
228
number of available processors. (Jelmer Vernooij, #693140)
233
* Added ``Branch.heads_to_fetch`` method. Implementations of the Branch API
234
must now inherit or implement this method. (Andrew Bennetts, #721328)
236
* Added ``bzrlib.mergetools`` module with helper functions for working with
237
the list of external merge tools. (Gordon Tyler, #489915)
239
* All methods and arguments that were deprecated before 2.0
240
have been removed. (Jelmer Vernooij)
242
* Branch formats should now be registered on the format registry
243
(``bzrlib.branch.format_registry``) rather than using the class
244
methods on ``BranchFormat``. (Jelmer Vernooij, #714729)
246
* ``BranchFormat.supports_leaving_lock()`` and
247
``RepositoryFormat.supports_leaving_lock`` flags have been added.
250
* ``Branch.fetch`` implementations must now accept an optional
251
``fetch_spec`` keyword argument. (Andrew Bennetts)
253
* ``Branch.import_last_revision_info`` is deprecated. Use the
254
``import_last_revision_info_and_tags`` method instead.
257
* Because it was too specific to BzrDir implementations,
258
``ControlDir.sprout`` no longer has a default implementation; it now
259
raises ``NotImplementedError``. (Jelmer Vernooij, #717937)
261
* ``ControlDirFormat.register_format`` has been removed. Instead,
262
``Prober`` implementations should now implement a ``known_formats``
263
method. (Jelmer Vernooij)
265
* ControlDirFormats can now provide a ``check_status`` method and
266
raise a custom exception or warning when an unsupported or deprecated
267
format is being opened. (Jelmer Vernooij, #731311)
269
* ``bzrlib.revionspec.dwim_revspecs`` is deprecated.
270
Use ``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_revspec`` and
271
``bzrlib.revisionspec.RevisionSpec_dwim.append_possible_lazy_revspec``
272
instead. (Jelmer Vernooij, #721971)
274
* ``BzrDirFormat`` has a new attribute ``fixed_components`` that
275
indicates whether the components of the bzrdir can be upgraded
276
independent of the ``BzrDir``. (Jelmer Vernooij)
278
* ``BzrProber.register_format`` and ``BzrProber.unregister_format`` are
279
now deprecated in favour of the ``BzrProber.formats`` format registry.
282
* ``ControlDir`` implementations no longer have to provide the
283
``get_branch_transport``, ``get_workingtree_transport`` and
284
``get_repository_transport`` methods. (Jelmer Vernooij, #730325)
286
* ``Converter`` has been moved from ``bzrlib.bzrdir`` to
287
``bzrlib.controldir``. (Jelmer Vernooij)
289
* Repository formats can now provide
290
``_get_extra_interrepo_test_combinations`` in the same module
291
to provide extra test combinations for ``bzrlib.tests.per_repository``.
294
* Repository formats should now be registered on the format registry
295
(``bzrlib.repository.format_registry``) rather than using the class
296
methods on ``RepositoryFormat``. (Jelmer Vernooij)
298
* Repository formats can now indicate they do not support the full
299
VersionedFiles API by setting the ``supports_full_versioned_files``
300
attribute to False. A subset of the VersionedFiles API
301
(signatures and text graphs) still needs to be supported.
304
* Repository formats have a new method ``is_deprecated`` that
305
implementations can override to return True to trigger a deprecation
306
warning. (Jelmer Vernooij)
308
* The ``revision_id`` parameter of
309
``Repository.search_missing_revision_ids`` and
310
``InterRepository.search_missing_revision_ids`` is deprecated. It is
311
replaced by the ``revision_ids`` parameter. (Andrew Bennetts)
313
* Working tree formats should now be registered on the format registry
314
(``bzrlib.working_tree.format_registry``) rather than using the class
315
methods on ``WorkingTreeFormat``. (Jelmer Vernooij, #714730)
320
* ``CatchingExceptionThread`` (formerly ThreadWithException) has been moved
321
out of the ``bzrlib.tests`` hierarchy to make it clearer that it can be used
322
outside of tests. This class makes it easier to track exceptions in threads
323
by catching them so they can be re-raised in the controlling thread. It's
324
available in the ``bzrlib.cethread`` module. (Vincent Ladeuil)
326
* Correctly propogate malloc failures from diff-delta.c code as MemoryError
327
so OOM conditions during groupcompress are clearly reported. This entailed a
328
change to several function signatures. (Martin [gz], #633336)
330
* ``HookPoint.lazy_hook`` and ``Hooks.install_named_lazy_hook`` can install
331
hooks for which the callable is loaded lazily. (Jelmer Vernooij)
336
* The Range parsing for HTTP requests will correctly parse incomplete ranges.
337
(Vincent Ladeuil, #731240)
340
vim: tw=74 ft=rst ff=unix
added
removed
doc/en/release-notes/bzr-2.4.txt
