11
:2.5b1: 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
* A ``from_unicode`` parameter can be specified when registering a config
24
option. This implements boolean and integer config options when the
25
provided ``bool_from_store`` and ``int_from_store`` are used.
28
* A ``from_unicode`` parameter can be specified when registering a config
29
option. This implements boolean, integer and list config options when the
30
provided ``bool_from_store``, ``int_from_store`` and ``list_from_store``
31
are used for this parameter. (Vincent Ladeuil)
33
* Accessing a packaging branch on Launchpad (eg, ``lp:ubuntu/bzr``) now
34
checks to see if the most recent published source package version for
35
that project is present in the branch tags. This should help developers
36
trust whether the packaging branch is up-to-date and can be used for new
37
changes. The level of verbosity is controlled by the config item
38
``launchpad.packaging_verbosity``. It can be set to one of
45
only display if the branch is out-of-date
48
also display single-line up-to-date and missing,
52
(default) display multi-line content for all states
55
(John Arbash Meinel, #609187, #812928)
57
* Add a config option gpg_signing_key for setting which GPG key should
58
be used to sign commits. Also default to using the gpg user identity
59
which matches user_email() as set by whoami. (Jonathan Riddell,
62
* An ``invalid`` parameter can be specified when registering a config option
63
to decide what should be done when invalid values are
64
encountered. 'warning' and 'eeror' will respectively emit a warning and
65
ignore the value or errors out. (Vincent Ladeuil)
67
* ``bzr help configuration/<option>`` display the help for ``option`` for
68
all registered configuration options. (Vincent Ladeuil, #747050)
70
* bzr log -m now matches message, author, committer and bugs instead
71
of just matching the message. --message keeps its original meaning,
72
while --match-message, --match-author, --match-committer and
73
--match-bugs match each of those fields.
75
* ``config.Option`` can now declare ``default_from_env``, a list of
76
environment variables to get a default value from. (Vincent Ladeuil)
78
* ``config.NameMatcher`` can be used to implement config stores and stacks
79
that need to provide specific option values for arbitrary unique IDs (svn
80
repository UUIDs, etc). (Vincent Ladeuil, #843638)
82
* New builtin ``bzr branches`` command, which lists all colocated branches
83
in a directory. (Jelmer Vernooij, #826820)
85
* Relative local paths can now be specified in URL syntax by using the
86
"file:" prefix. (Jelmer Vernooij)
88
* Report commits signed with expired keys in "verify-signatures".
89
(Jonathan Riddell, #804254)
91
* bzr add now skips large files in recursive mode. The default "large"
92
size is 20MB, and is configurable via the add.maximum_file_size
93
option. A value of 0 disables skipping. Named items passed to add are
94
never skipped. (Shannon Weyrick, #54624)
96
* bzr now ships with translations for command help. (Jonathan
97
Riddell, INADA Naoki, #83941)
99
* bzr now ships with translations for command errors. (Jonathan
100
Riddell, INADA Naoki)
105
.. Improvements to existing commands, especially improved performance
106
or memory usage, or better results.
108
* ``bzr commit -m ''`` can now be used to force an empty commit message.
109
Entering an empty commit message in the message editor still triggers
110
an error. (Jelmer Vernooij)
112
* ``bzr pull`` will now mention how many tags it has updated.
113
(Jelmer Vernooij, #164450)
115
* ``bzr tag`` no longer errors if a tag already exists but refers to the
116
same revision, and will mention when a tag has been updated
117
rather than created. (Jelmer Vernooij, #381203)
119
* ``bzr uncommit`` will now remove tags that refer to removed revisions.
120
The ``--keep-tags`` option can be used to prevent this behaviour.
121
(Jelmer Vernooij, #605814)
123
* Locations printed by ``bzr upgrade`` are now formatted before display.
126
* Use gettext.NullTranslations in i18n to allow use of i18n even when
127
translations are not turned on. (Jonathan Riddell)
129
* Install translation .mo files. (Jonathan Riddell)
131
* Do not run i18n initialisation twice. (Jonathan Riddell)
133
* Support a ``bugtracker`` option which is used by ``bzr commit --fixes``
134
if no bug tracker was specified on the command line.
135
(Jelmer Vernooij, #334860)
140
.. Fixes for situations where bzr would previously crash or give incorrect
141
or undesirable results.
143
* ``bzr reconfigure`` will now allow multiple non-conflicting requests
144
in a single invocation, e.g. ``--branch`` and ``--use-shared``.
145
(Martin von Gagern, #842993)
147
* The pull command will now always use separate connections for the
148
case where the destination is a heavyweight checkout of some remote
149
branch on the same host as the source branch.
150
(Martin von Gagern, #483661)
152
* A call to CHKInventory's filter-method will not result in a
153
DuplicateFileId error, if you move a subfolder and change a file in
155
(Bastian Bowe, #809901)
157
* Branching from a stacked branch no longer does a ``get_parent_map``
158
request for each revisions that is in the stacked-on repository while
159
determining what revisions need to be fetched. This mostly impacts
160
branching initialy into an empty shared repository when the source is
161
not the development focus. (John Arbash Meinel, #388269)
163
* Decode ``BZR_HOME`` with fs encoding on posix platforms to avoid unicode
164
errors. (Vincent Ladeuil, #822571)
166
* Fix fallout from URL handling changes in 2.5 that caused an IndexError to be
167
raised whenever a transport at the drive root was opened on windows.
168
(Martin [gz], #841322)
170
* Rather than an error being raised, a warning is now printed when the
171
current user does not have permission to read a configuration file.
172
(Jelmer Vernooij, #837324)
174
* TreeTransformBase.fixup_new_roots no longer forces trees to have a root, so
175
operations that use it, like merge, can now create trees without a root.
178
* Fixed loading of external merge tools from config to properly decode
179
command-lines which contain embedded quotes. (Gordon Tyler, #828803)
184
.. Improved or updated documentation.
186
* Release instructions refreshed. (Vincent Ladeuil)
191
.. Changes that may require updates in plugins or other code that uses
194
* ``BranchFormat.initialize`` now takes a ``append_revisions_only``
195
argument. (Jelmer Vernooij)
197
* ``Branch._get_checkout_format`` now takes a ``lightweight`` argument
198
which indicates if the format should be for a lightweight or a
199
heavyweight checkout. (Jelmer Vernooij)
201
* ``ControlDir.create_branch`` now takes a ``append_revisions_only`` argument.
204
* New class ``URL`` in ``bzrlib.utils`` for managing parsed URLs.
207
* New methods ``get_transport_from_path`` and ``get_transport_from_url``
208
have been added that only support opening from a path or a URL,
209
unlike ``get_transport``. (Jelmer Vernooij)
211
* New method ``Tree.get_file_verifier`` which allows tree implementations
212
to return non-sha1 checksums to verify files.
213
(Jelmer Vernooij, #720831)
215
* New method ``InterTree.file_content_matches`` which checks that
216
two files in different trees have the same contents.
219
* New registry ``OptionRegistry`` specialized for configuration options.
222
* Remove ``AtomicFile.closed`` which has been deprecated in bzr 0.10.
225
* Remove ``commands._builtin_commands``, ``commands.shlex_split_unicode``,
226
``Command._maybe_expand_globs`` and ``Command.run_direct`` deprecated in
227
2.10 and 2.2.0. (Vincent Ladeuil)
229
* Remove ``diff.get_trees_and_branches_to_diff`` deprecated in 2.2.0.
231
* Remove ``log.calculate_view_revisions``, ``log._filter_revision_range``,
232
``log.get_view_revisions`` which have been deprecated in bzr 2.1.0. Also
233
remove ``log.show_one_log`` which was never properly deprecated but wasn't
234
used and is easy to inline if needed. (Vincent Ladeuil)
236
* Remove ``trace.info``, ``trace.error`` and ``trace.show_log_error``
237
deprecated in 2.1.0. (Vincent Ladeuil)
239
* Remove ``TransportListRegistry.set_default_transport``, as the concept of
240
a default transport is currently unused. (Jelmer Vernooij)
242
* Remove ``UIFactory.warn_cross_format_fetch`` and
243
``UIFactory.warn_experimental_format_fetch`` in favor of
244
``UIFactory.show_user_warning``. (Jelmer Vernooij)
246
* There is a new class `ContentFilterTree` that provides a facade for
247
content filtering. The `filtered` parameter to `export` is deprecated
248
in favor of passing a filtered tree, and the specific exporter plugins
249
no longer support it.
252
* New method ``Config.get_user_option_as_int_from_SI`` added for expanding a
253
value in SI format (i.e. "20MB", "1GB") into its integer equivalent.
256
* ``Tags`` containers can now declare whether they support versioned
257
tags and whether tags can refer to ghost tags.
260
* ``Tags.merge_to`` now returns a dictionary with the updated tags
261
and a set of conflicts, rather than just conflicts. (Jelmer Vernooij)
263
* ``Transport`` now has a ``_parsed_url`` attribute instead of
264
separate ``_user``, ``_password``, ``_port``, ``_scheme``, ``_host``
265
and ``_path`` attributes. Proxies are provided for the moment but
266
may be removed in the future. (Jelmer Vernooij)
272
.. Major internal changes, unlikely to be visible to users or plugin
273
developers, but interesting for bzr developers.
275
* A new debug flags ``hpss_client_no_vfs`` will now cause the HPSS client
276
to raise a ``HpssVfsRequestNotAllowed`` exception when a VFS request
277
is attempted. (Jelmer Vernooij)
279
* New method ``ControlDir._get_selected_branch`` which returns the
280
colocated branch selected using path segment parameters.
281
(Jelmer Vernooij, #380871)
286
.. Fixes and changes that are only relevant to bzr's test framework and
287
suite. This can include new facilities for writing tests, fixes to
288
spurious test failures and changes to the way things should be tested.
290
* Blackbox tests can be debugged interactively (see bzrlib.debug.BzrPdb for
291
details). (Vincent Ladeuil)
293
* `BranchBuilder.build_snapshot` now supports a "flush" action. This
294
cleanly and reliably allows tests using `BranchBuilder` to construct
295
branches that e.g. rename files out of a directory and unversion that
296
directory in the same revision. Previously some changes were impossible
297
due to the order that `build_snapshot` performs its actions.
300
* Don't require ``os.fdatasync`` to be defined on all supported OSes
301
(BSD-based OSes don't define it). (Vincent Ladeuil, #822649)
303
* Fix compatibility with testtools 0.9.12. (Jelmer Vernooij, #815423)
305
* ``LockDir`` can now be run when the local hostname is ``localhost``.
306
(Jelmer Vernooij, #825994)
308
* ``ModuleAvailableFeature`` won't try to import already imported modules,
309
allowing it to be used for modules with side-effects.
310
(Vincent Ladeuil, #712474)
312
* Output time stamps while running ``make check`` to get better timings from
313
pqm. (Vincent Ladeuil, #837926)
315
* `TestCaseWithMemoryTransport` is faster now: `_check_safety_net` now
316
just compares the bytes in the dirstate file to its pristine state,
317
rather than opening the WorkingTree and calling ``last_revision()``.
318
This reduces the overall test suite time by about 10% on my laptop.
321
* Update `TestCase.knownFailure` to the testtools way of handling expected
322
failures to resolve Python 2.7 incompatibility. (Martin [gz], #607400)
325
vim: tw=74 ft=rst ff=unix
added
removed
doc/en/release-notes/bzr-2.5.txt
