11
:2.5b4: 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
* When using ``bzr switch`` to switch to a sibling of the current
30
branch, the relative branch name should no longer be url-encoded.
33
* ``bzr switch`` now accepts colocated branch names to switch to.
34
(Jelmer Vernooij, #826814)
39
.. Fixes for situations where bzr would previously crash or give incorrect
40
or undesirable results.
42
* Allow lazy compiled patterns from ``bzrlib.lazy_regex`` to be
43
pickled. (Jelmer Vernooij, #893149)
45
* A new section local option ``basename`` is available to help support some
46
``bzr-pipeline`` workflows and more generally help mapping local paths to
47
remote ones. See ``bzr help configuration`` for more details.
48
(Vincent Ladeuil, #843211)
50
* Fix test failures on windows related to locations.conf handling.
51
(Vincent Ladeuil, #892992)
53
* Fixed parsing of the timestamp given to ``commit --commit-time``. Now
54
prohibits several invalid strings, reads the correct number of seconds,
55
and gives a better error message if the time zone offset is not given.
58
* Resolve regression from colocated branch path handling, by ensuring that
59
unreserved characters are unquoted in URLs. (Martin Packman, #842223)
61
* Split segments from URLs for colocated branches without assuming the
62
combined form is a valid. (Martin Packman, #842233)
64
* Support looking up revision numbers by revision id in empty branches.
65
(Jelmer Vernooij, #535031)
67
* Support verifying signatures on remote repositories.
68
(Jelmer Vernooij, #889694)
73
.. Improved or updated documentation.
78
.. Changes that may require updates in plugins or other code that uses
81
* ``Repository.verify_revision`` has been renamed to
82
``Repository.verify_revision_signature``. (Jelmer Vernooij)
84
* Some global options for use with commands have been removed, construct
85
an ``Option`` with the name instead. (Martin Packman)
90
.. Major internal changes, unlikely to be visible to users or plugin
91
developers, but interesting for bzr developers.
93
* ``bzr config`` uses the new configuration implementation.
96
* ``RemoteBranch.get_config_stack`` and ``RemoteBzrDir.get_config_stack``
97
will now use HPSS calls where possible. (Jelmer Vernooij)
99
* New HPSS calls ``Repository.has_signature_for_revision_id``,
100
``Repository.make_working_trees``, ``BzrDir.destroy_repository``,
101
``BzrDir.has_workingtree`` and ``Branch.put_config_file``.
107
.. Fixes and changes that are only relevant to bzr's test framework and
108
suite. This can include new facilities for writing tests, fixes to
109
spurious test failures and changes to the way things should be tested.
111
* Avoid failures in test_transform when OS error messages are localised.
112
(Martin Packman, #891582)
119
This is the third beta of the 2.5 series, leading to a 2.5.0 release in
120
February 2012. Beta releases are suitable for everyday use but may cause
121
some incompatibilities with plugins.
123
This release includes log options for ``push`` and ``pull``, more UI polish
124
for colocated branches, a better and more coherent implementation for UI
125
dialogs, enhancements to the config framework and more.
127
This release includes all bug fixed in previous series known at the time of
130
External Compatibility Breaks
131
*****************************
138
* The ``log_format`` configuration can be used with ``-Olog_format=line`` to
139
change the format ``push`` and ``pull`` use to display the
140
revisions. I.e.: ``bzr pull -v -Olog_format=short`` will use the ``short``
141
format instead of the default ``long`` one. (Vincent Ladeuil, #861472)
143
* The new config scheme allows an alternative syntax for the 'appenpath'
144
policy relying on option expansion and defining a new 'relpath' option
145
local to a section. Instead of using '<option>:policy=appendpath', the
146
option value can de defined as 'option=xxxx/{relpath}'.
147
(Vincent Ladeuil, #832013)
152
* ``bzr info -v`` now shows the number of colocated branches
153
for control directories that support them.
154
(Jelmer Vernooij, #863285)
156
* ``bzr version-info`` now takes a ``--revision`` argument.
157
(Jelmer Vernooij, #238705)
159
* ``bzr revno`` now takes a ``--revision`` argument.
160
(Jelmer Vernooij, #870649)
162
* ``bzr rmbranch`` can now remove colocated branches.
163
(Jelmer Vernooij, #831464)
165
* ``bzr serve`` now can serve from URLs rather than just from the
166
file system. I.e.: ``bzr serve -d lp:bzr`` or
167
``bzr serve -d file:///data/bzr`` (Jelmer Vernooij)
169
* all input prompts are now char-based when possible, and can be forced to
170
line-based mode by setting the ``BZR_TEXTUI_INPUT`` environment variable
171
to 'line-based'. This replace the previous shelf UI only patch using
172
``INSIDE_EMACS``. (Benoît Pierre)
177
* ``bzr info`` now shows the master branch location too for
178
treeless local branches. (Jelmer Vernooij, #258355)
180
* ``bzr info`` no longer shows empty output if only a control
181
directory is present. (Jelmer Vernooij, #159098)
183
* ``bzr mkdir --quiet`` now does not print a line for every created
184
directory. (Martin von Gagern, #869915)
186
* ``bzr mv`` does not crash when attempting to move the root of a
187
branch. (Jonathan Riddell, #809728)
189
* ``bzr shelve`` now use ``UIFactory.choose`` for input handling, making
190
it usable when creating a custom ``UIFactory`` implementation. (Benoît
193
* ``bzr clean-tree`` now use ``UIFactory.get_boolean`` for confirmation
194
prompt, making it usable when using a custom ``UIFactory``
195
implementation. (Benoît Pierre)
197
* If sending a crash through Apport fails report the Apport failure to
198
bzr.log rather than stderr. (Jonathan Riddell, #766735)
200
* ``bzr upgrade`` no longer treats 'already up-to-date' exceptions as
201
errors. (Benoît Pierre, #716560).
203
* ``bzr version-info`` no longer populates the clean state for custom
204
templates unless {clean} is explicitly asked for.
205
(Lawrence Mitchell, #882541)
207
* Fix finding the CPU count when using Python >= 2.6 on BSD-based systems.
208
(Jelmer Vernooij, #887151)
210
* ``WorkingTree.clone()`` now supports its ``revision_id`` being set
211
to the null revision. (Jelmer Vernooij, #876423)
213
* ``WorkingTree.pull`` can now pull ``NULL_REVISION``.
214
(Jelmer Vernooij, #887556)
219
* ``Branch.revision_history`` is now deprecated. (Jelmer Vernooij, #799519)
221
* Methods ``add`` and ``items`` of ``LRUCache`` and ``LRUSizeCache`` are
222
deprecated. Use normal dict-style access instead. (Martin Packman)
224
* New flag ``RepositoryFormat.supports_unreferenced_revisions`` which
225
indicates whether revisions can be present in a repository without
226
being referenced from e.g. a branch history at the same time.
229
* New method ``Transport.set_segment_parameter``. (Jelmer Vernooij)
231
* ``UIFactory.choose`` has been added: prompt the user for a list of
232
choices. (Benoît Pierre)
237
* ``ControlDirFormat`` now has a new method ``supports_transport``
238
which format implementations can use whether or not they can access
239
a control dir over a particular transport. (Jelmer Vernooij)
241
* ``BranchBuilder.build_commit`` now take ``parent_ids`` and
242
``allow_leftmost_as_ghost`` arguments. (Jelmer Vernooij)
247
* Ensure TestCase instances are deallocated immediately after running where
248
possible. This greatly reduces the peak resource needs of a full test suite
249
run. The new ``-Euncollected_cases`` selftest flag will add failures if any
250
case which persists pasts its expected lifetime. (Martin Packman, #613247)
252
* Report exceptions from child processes during fork instead of swallowing the
253
error and reporting that everything went okay. (Martin Packman, #804130)
259
This is the second beta of the 2.5 series, leading to a 2.5.0 release in
260
February 2012. Beta releases are suitable for everyday use but may cause some
261
incompatibilities with plugins.
263
This release includes more filtering options for ``bzr log``, idle
264
connections handling for ``bzr serve``, a ``development-colo`` experimental
265
format to flesh out the colocated branches UI, better support for foreign
266
formats, enhancements to the config framework and more.
268
This release includes all bug fixed in previous series known at the time of
273
External Compatibility Breaks
274
*****************************
281
* A new ``-O`` standard option (common to all commands) have been added. It
282
provides a value for a config option in the ``-Oname=value`` form that
283
takes precedence over all definitions found in config files. It can be
284
used multiple times to override different options.
285
(Vincent Ladeuil, #491196)
287
* ``bzr log`` now has an option called ``--omit-merges`` to omit
288
those commits that merged branches, i.e. those having more than one
290
In order to avoid confusion, the previous command line option
291
``--include-merges`` has been renamed to ``--include-merged``.
292
The old name of the command line option will still be accepted.
293
The name change also affects ``bzr missing``.
296
* ``bzr serve`` will now disconnect clients if they have not issued an RPC
297
request after 5minutes. On POSIX platforms, this will also happen for
298
``bzr serve --inet``. This can be overridden with the configuration
299
variable ``serve.client_timeout`` or in the command line parameter
300
``bzr serve --client-timeout=X``. Further, it is possible to request
301
``bzr serve [--inet]`` to shutdown gracefully by sending SIGHUP. It will
302
finish the current request, and then close the connection.
303
(John Arbash Meinel, #824797, #795025)
305
* The new experimental format ``development-colo`` supports colocated
306
branches. This format will eventually be merged back into the ``2a``
307
format when it has stabilized and there is adequate UI support for
309
(Jelmer Vernooij, #831481)
314
* Fixed a bug where ``bzr tags -r x..y`` loaded the branch history once for
315
every revision in the range; it's now much faster. (Vincent Ladeuil, #857335)
317
* ``bzr info -v`` can now be run against branches that don't support
318
``last_revision_info``, in which case the branch information will simply
319
not be displayed. (Jelmer Vernooij)
324
* ``bzr shelve`` can now be used in emacs shells as the input handling is
325
turned into a line-based one when ``INSIDE_EMACS`` is set (which is the
326
case for all recent emacs versions). (Vincent Ladeuil, #856261)
328
* ``bzr tags`` can now be used against remote repositories that do
329
not provide access to the revision graph. (Jelmer Vernooij, #858942)
331
* ``bzr update PATH`` will stop if you seem to be asking it to update
332
anything less than a whole tree, because that's not supported by ``bzr``'s
333
concept that the whole tree has a single basis revision. Previously, it
334
would go ahead and update the whole tree, which was surprising.
335
(Martin Pool, #557886)
337
* Don't crash if ``bzrlib.initialize()`` has not been called while accessing
338
configs. (Vincent Ladeuil, #863401)
340
* Redirects between http and https no longer discard path information
341
in some cases. (Jelmer Vernooij, #853765)
343
* The ``--overwrite`` argument to ``bzr push`` and ``bzr pull`` no longer
344
reports all tags as changed. (Jelmer Vernooij, #845396)
346
* ``WorkingTree.get_file_mtime`` now raises NoSuchId if a file id is
347
specified that is unknown. (Jelmer Vernooij, #847435)
353
* ``Branch.get_revision_delta`` has been deprecated. Use
354
``Repository.get_revision_delta`` instead. (Jelmer Vernooij, #859712)
356
* Plugins that implement custom protocols for ``bzr serve`` should now
357
also take an argument ``timeout``. This is used by the the bzr protocol
358
to close a connection if a client has been idle for more than X seconds.
359
(Default 5minutes). (John Arbash Meinel)
361
* ``Repository.fileids_altered_by_revision_ids`` has been moved to
362
``VersionedFileRepository`` and is no longer part of the standard
363
``Repository`` interface. (Jelmer Vernooij)
365
* The argument ``include_merges`` to ``missing.find_unmerged`` has
366
been renamed to ``include_merged``. The old name is still supported
367
for now but will cause a deprecation warning. (Martin von Gagern)
369
* The new method ``ControlDirFormat.is_initializable()`` returns a boolean
370
indicating whether or not it is possible to use any of the
371
initialization methods of that format to create a new control dir.
377
* ``Branch`` objects can now use a config stack with the newly introduced
378
``get_config_stack()``. Both ``get_config`` and ``get_config_stack`` can
379
be used for the same branch but it's recommended to stick to one for a
385
* Test scripts can now use ``bzr shelve`` and provide their input as
386
complete lines. (Vincent Ladeuil, #856261)
388
* Really corrupt the pack file without depending on a special length or value.
389
(Vincent Ladeuil, #807032)
397
This is the first beta of the 2.5 series, leading up to a 2.5.0
398
release in February 2012.
400
This release includes better support for gpg signing, better support for
401
i18n (mostly command help and error messages), more options to filter ``bzr
402
log`` output, more support for colocated branches ("location,branch=XXX"
403
syntax), better feedback on updated tags for various commands, faster
404
branching into an empty repository, enhancements to the config framework and
407
Beta releases are suitable for everyday use but may cause some
408
incompatibilities with plugins. Some plugins may need small updates to work
411
External Compatibility Breaks
412
*****************************
419
* A ``from_unicode`` parameter can be specified when registering a config
420
option. This implements boolean, integer and list config options when the
421
provided ``bool_from_store``, ``int_from_store`` and ``list_from_store``
422
are used for this parameter. (Vincent Ladeuil)
424
* Accessing a packaging branch on Launchpad (eg, ``lp:ubuntu/bzr``) now
425
checks to see if the most recent published source package version for
426
that project is present in the branch tags. This should help developers
427
trust whether the packaging branch is up-to-date and can be used for new
428
changes. The level of verbosity is controlled by the config item
429
``launchpad.packaging_verbosity``. It can be set to one of
436
only display if the branch is out-of-date
439
also display single-line up-to-date and missing,
443
(default) display multi-line content for all states
446
(John Arbash Meinel, #609187, #812928)
448
* Add a config option gpg_signing_key for setting which GPG key should
449
be used to sign commits. Also default to using the gpg user identity
450
which matches user_email() as set by whoami.
451
(Jonathan Riddell, #68501)
453
* An ``invalid`` parameter can be specified when registering a config option
454
to decide what should be done when invalid values are
455
encountered. 'warning' and 'error' will respectively emit a warning and
456
ignore the value or errors out. (Vincent Ladeuil)
458
* bzr add now skips large files in recursive mode. The default "large"
459
size is 20MB, and is configurable via the add.maximum_file_size
460
option. A value of 0 disables skipping. Named items passed to add are
461
never skipped. (Shannon Weyrick, #54624)
463
* ``bzr help configuration/<option>`` display the help for ``option`` for
464
all registered configuration options. (Vincent Ladeuil, #747050)
466
* ``bzr log -m`` now matches message, author, committer and bugs instead
467
of just matching the message. ``--message`` keeps its original meaning,
468
while ``--match-message, --match-author, --match-committer`` and
469
``--match-bugs`` match each of those fields. (Jacek Sieka)
471
* ``config.Option`` can now declare ``default_from_env``, a list of
472
environment variables to get a default value from. (Vincent Ladeuil)
474
* ``config.NameMatcher`` can be used to implement config stores and stacks
475
that need to provide specific option values for arbitrary unique IDs (svn
476
repository UUIDs, etc). (Vincent Ladeuil, #843638)
478
* New builtin ``bzr branches`` command, which lists all colocated branches
479
in a directory. (Jelmer Vernooij, #826820)
481
* Relative local paths can now be specified in URL syntax by using the
482
"file:" prefix. (Jelmer Vernooij)
484
* Report commits signed with expired keys in ``verify-signatures``.
485
(Jonathan Riddell, #804254)
487
* Translations are now enabled for command help, errors and globally
488
for any message using ``gettext`` given on output. (Jonathan Riddell,
494
* ``bzr add`` will now warn about nested subtrees that are skipped.
495
(Jelmer Vernooij, #187342)
497
* ``bzr commit -m ''`` can now be used to force an empty commit message.
498
Entering an empty commit message in the message editor still triggers
499
an error. (Jelmer Vernooij)
501
* ``bzr pull`` will now mention how many tags it has updated.
502
(Jelmer Vernooij, #164450)
504
* ``bzr tag`` no longer errors if a tag already exists but refers to the
505
same revision, and will mention when a tag has been updated
506
rather than created. (Jelmer Vernooij, #381203)
508
* ``bzr uncommit`` will now remove tags that refer to removed revisions.
509
The ``--keep-tags`` option can be used to prevent this behaviour.
510
(Jelmer Vernooij, #605814)
512
* Do not run i18n initialisation twice. (Jonathan Riddell)
514
* Install translation .mo files. (Jonathan Riddell)
516
* Locations printed by ``bzr upgrade`` are now formatted before display.
519
* ``Repository.get_parent_map`` now estimates the size of the returned
520
content more accurately. This means that we get closer to the desired
521
64kB/request. For repositories converted from svn, this can be an
522
improvement of approx 5:1 in round trips to discover the whole history.
525
* Support a ``bugtracker`` option which is used by ``bzr commit --fixes``
526
if no bug tracker was specified on the command line.
527
(Jelmer Vernooij, #334860)
529
* Use ``gettext.NullTranslations`` in i18n to allow use of i18n even when
530
translations are not turned on. (Jonathan Riddell)
535
* ``bzr commit`` now correctly reports missing files as "removed", not
536
"modified". (Jelmer Vernooij, #553955)
538
* ``bzr reconfigure`` will now allow multiple non-conflicting requests
539
in a single invocation, e.g. ``--branch`` and ``--use-shared``.
540
(Martin von Gagern, #842993)
542
* A call to CHKInventory's filter-method will not result in a
543
DuplicateFileId error, if you move a subfolder and change a file in
545
(Bastian Bowe, #809901)
547
* Branching from a stacked branch no longer does a ``get_parent_map``
548
request for each revisions that is in the stacked-on repository while
549
determining what revisions need to be fetched. This mostly impacts
550
branching initialy into an empty shared repository when the source is
551
not the development focus. (John Arbash Meinel, #388269)
553
* Decode ``BZR_HOME`` with fs encoding on posix platforms to avoid unicode
554
errors. (Vincent Ladeuil, #822571)
556
* Fix fallout from URL handling changes in 2.5 that caused an IndexError to be
557
raised whenever a transport at the drive root was opened on windows.
558
(Martin [gz], #841322)
560
* Fixed loading of external merge tools from config to properly decode
561
command-lines which contain embedded quotes. (Gordon Tyler, #828803)
563
* Rather than an error being raised, a warning is now printed when the
564
current user does not have permission to read a configuration file.
565
(Jelmer Vernooij, #837324)
567
* The pull command will now always use separate connections for the
568
case where the destination is a heavyweight checkout of some remote
569
branch on the same host as the source branch.
570
(Martin von Gagern, #483661)
572
* TreeTransformBase.fixup_new_roots no longer forces trees to have a root, so
573
operations that use it, like merge, can now create trees without a root.
576
* Raise BadIndexKey exception in btree_index when a key is too large, fixing
577
an infinite recursion issue. (Shannon Weyrick, #720853)
582
* Release instructions refreshed. (Vincent Ladeuil)
587
* ``BranchFormat.initialize`` now takes a ``append_revisions_only``
588
argument. (Jelmer Vernooij)
590
* ``Branch._get_checkout_format`` now takes a ``lightweight`` argument
591
which indicates if the format should be for a lightweight or a
592
heavyweight checkout. (Jelmer Vernooij)
594
* ``ControlDir.create_branch`` now takes a ``append_revisions_only`` argument.
597
* New class ``URL`` in ``bzrlib.utils`` for managing parsed URLs.
600
* New method ``Config.get_user_option_as_int_from_SI`` added for expanding a
601
value in SI format (i.e. "20MB", "1GB") into its integer equivalent.
604
* New method ``InterTree.file_content_matches`` which checks that
605
two files in different trees have the same contents.
608
* New method ``Tree.get_file_verifier`` which allows tree implementations
609
to return non-sha1 checksums to verify files.
610
(Jelmer Vernooij, #720831)
612
* New methods ``get_transport_from_path`` and ``get_transport_from_url``
613
have been added that only support opening from a path or a URL,
614
unlike ``get_transport``. (Jelmer Vernooij)
616
* New registry ``OptionRegistry`` specialized for configuration options.
619
* Remove ``AtomicFile.closed`` which has been deprecated in bzr 0.10.
622
* Remove ``commands._builtin_commands``, ``commands.shlex_split_unicode``,
623
``Command._maybe_expand_globs`` and ``Command.run_direct`` deprecated in
624
2.10 and 2.2.0. (Vincent Ladeuil)
626
* Remove ``diff.get_trees_and_branches_to_diff`` deprecated in 2.2.0.
628
* Remove ``log.calculate_view_revisions``, ``log._filter_revision_range``,
629
``log.get_view_revisions`` which have been deprecated in bzr 2.1.0. Also
630
remove ``log.show_one_log`` which was never properly deprecated but wasn't
631
used and is easy to inline if needed. (Vincent Ladeuil)
633
* Remove ``trace.info``, ``trace.error`` and ``trace.show_log_error``
634
deprecated in 2.1.0. (Vincent Ladeuil)
636
* Remove ``TransportListRegistry.set_default_transport``, as the concept of
637
a default transport is currently unused. (Jelmer Vernooij)
639
* Remove ``UIFactory.warn_cross_format_fetch`` and
640
``UIFactory.warn_experimental_format_fetch`` in favor of
641
``UIFactory.show_user_warning``. (Jelmer Vernooij)
643
* ``Tags`` containers can now declare whether they support versioned
644
tags and whether tags can refer to ghost tags.
647
* ``Tags.merge_to`` now returns a dictionary with the updated tags
648
and a set of conflicts, rather than just conflicts. (Jelmer Vernooij)
650
* There is a new class `ContentFilterTree` that provides a facade for
651
content filtering. The `filtered` parameter to `export` is deprecated
652
in favor of passing a filtered tree, and the specific exporter plugins
653
no longer support it.
656
* ``Transport`` now has a ``_parsed_url`` attribute instead of
657
separate ``_user``, ``_password``, ``_port``, ``_scheme``, ``_host``
658
and ``_path`` attributes. Proxies are provided for the moment but
659
may be removed in the future. (Jelmer Vernooij)
664
* A new debug flag ``hpss_client_no_vfs`` will now cause the HPSS client
665
to raise a ``HpssVfsRequestNotAllowed`` exception when a VFS request
666
is attempted. (Jelmer Vernooij)
668
* New method ``ControlDir._get_selected_branch`` which returns the
669
colocated branch selected using path segment parameters.
670
(Jelmer Vernooij, #380871)
675
* Blackbox tests (including test scripts) can be debugged interactively (see
676
bzrlib.debug.BzrPdb for details). (Vincent Ladeuil)
678
* `BranchBuilder.build_snapshot` now supports a "flush" action. This
679
cleanly and reliably allows tests using `BranchBuilder` to construct
680
branches that e.g. rename files out of a directory and unversion that
681
directory in the same revision. Previously some changes were impossible
682
due to the order that `build_snapshot` performs its actions.
685
* Don't require ``os.fdatasync`` to be defined on all supported OSes
686
(BSD-based OSes don't define it). (Vincent Ladeuil, #822649)
688
* Fix compatibility with testtools 0.9.12. (Jelmer Vernooij, #815423)
690
* ``LockDir`` can now be run when the local hostname is ``localhost``.
691
(Jelmer Vernooij, #825994)
693
* ``ModuleAvailableFeature`` won't try to import already imported modules,
694
allowing it to be used for modules with side-effects.
695
(Vincent Ladeuil, #712474)
697
* Output time stamps while running ``make check`` to get better timings from
698
pqm. (Vincent Ladeuil, #837926)
700
* `TestCaseWithMemoryTransport` is faster now: `_check_safety_net` now
701
just compares the bytes in the dirstate file to its pristine state,
702
rather than opening the WorkingTree and calling ``last_revision()``.
703
This reduces the overall test suite time by about 10% on my laptop.
706
* Update `TestCase.knownFailure` to the testtools way of handling expected
707
failures to resolve Python 2.7 incompatibility. (Martin [gz], #607400)
710
vim: tw=74 ft=rst ff=unix
added
removed
doc/en/release-notes/bzr-2.5.txt
