5
5
.. contents:: List of Releases
12
:2.3b1: NOT RELEASED YET
17
* BzrError subclasses no longer support the name "message" to be used
18
as an argument for __init__ or in _fmt format specification as this
19
breaks in some Python versions. errors.LockError.__init__ argument
20
is now named "msg" instead of earlier "message".
21
(Parth Malwankar, #603461)
23
* `FileInWrongBranch` is deprecated in favour of `PathNotChild` and no
27
* `tree_files` and `internal_tree_files` are now deprecated in favor of
28
`WorkingTree.open_containing_paths`.
31
* The old ``bzr selftest --benchmark`` option has been removed.
32
<https://launchpad.net/bzr-usertest> is an actively-maintained
39
* The ``lp:`` prefix will now use your known username (from
40
``bzr launchpad-login``) to expand ``~`` to your username. For example:
41
``bzr launchpad-login user && bzr push lp:~/project/branch`` will now
42
push to ``lp:~user/project/branch``. (John Arbash Meinel)
47
* Check if both --diff-options and --using are set, and exit with error
48
in this case. (Matthäus G. Chajdas, #234708)
50
* Decrease peak memory during ``bzr send``. The old code was caching all
51
text content and all inventory strings for all revisions before
52
computing the diffs. Now we only cache as long as there is a child that
53
will need them. Sending 2000 bzr revisions drops from 1.2GB peak to
54
256MB peak. (John Arbash Meinel, #614576)
56
* Don't print internal object name when print an invalid revision spec
57
error. (Neil Martinsen-Burrell, #598701)
59
* ``HTTP/1.1` test servers now set a ``Content-Length`` header to comply
60
with pedantic ``HTTP/1.1`` clients. (Vincent Ladeuil, #568421)
62
* `PathNotChild` should not give a traceback.
65
* Prevent ``CHKMap.apply_delta`` from generating non-canonical CHK maps,
66
which can result in "missing referenced chk root keys" errors when
67
fetching from repositories with affected revisions.
68
(Andrew Bennetts, #522637)
70
* ``Transport.stat`` on a symlink, including a transport pointing directly
71
to a symlink, now returns information about the symlink.
77
* Inventory entries now consume less memory (on 32-bit Ubuntu file entries
78
have dropped from 68 bytes to 40, and directory entries from 120 bytes
79
to 48). (Andrew Bennetts)
81
* When building new working trees, default to reading from the repository
82
rather than the source tree unless explicitly requested. (via
83
``--files-from`` and ``--hardlink`` for ``bzr branch`` and
84
``bzr checkout``. Generally, 2a format repositories extract
85
content faster than seeking and reading content from another tree,
86
especially in cold-cache situations. (John Arbash Meinel, #607298)
91
* First tests defined for sphinx, including a new bzrlib.tests.features.sphinx
92
to make the tests conditional.
95
* Added a builder/writer sphinx extension that can generate texinfo files. The
96
generated files are syntactically correct but the info navigation nodes
97
needs more work. (Vincent Ladeuil, #219334)
103
* InventoryEntry instances now raise AttributeError if you try to assign
104
to attributes that are irrelevant to that kind of entry. e.g. setting
105
``symlink_target`` on an InventoryFile will fail. It is still okay to
106
read those attributes on any kind of InventoryEntry. The complete list
107
of affected attributes is: ``executable``, ``text_id``, ``text_sha1``,
108
``text_size`` (only valid for kind == file); ``symlink_target`` (only
109
valid for kind == link); and ``reference_revision`` (only valid for kind
110
== tree-reference). (Andrew Bennetts)
118
* The way ``bzr selftest --parallel`` generates N partitions of tests to
119
run in parallel has changed. Instead of splitting the list of tests at
120
N-1 points, it distributes the tests one-by-one into the partitions in a
121
round robin fashion. This reduces the total time to run the tests in
122
parallel because a series of slow tests in the test suite will be
123
distributed evenly among the parallel test suites, rather than slowing
124
down just one suite. (Andrew Bennetts)
133
This release marks the start of another long-term-stable series. From
134
here, we will only make bugfix releases on the 2.2 series (2.2.1, etc),
135
while 2.3 will become our new development series. The 2.0 and 2.1 series
136
will also continue to get bugfixes. (Currently 2.0 is planned to be
137
supported for another 6 months.)
139
This is primarily a bugfix and polish release over the 2.1 series, with
140
a large number of bugs fixed (>120), and some performance improvements.
142
There are some compatibility changes in this release. For users of bzrlib
143
as a library, we now request that they call ``bzrlib.initialize`` and use
144
the returned context manager appropriately. For commandline users we no
145
longer guess user identity for ``bzr commit``, users must specify their
146
identity using ``bzr whoami`` (you don't need to specify your identity for
147
readonly operations).
149
Users are encouraged to upgrade from the other stable series.
154
* BzrError subclasses no longer support the name "message" to be used
155
as an argument for __init__ or in _fmt format specification as this
156
breaks in some Python versions. errors.LockError.__init__ argument
157
is now named "msg" instead of earlier "message".
158
(Parth Malwankar, #603461)
160
* The old ``bzr selftest --benchmark`` option has been removed.
161
<https://launchpad.net/bzr-usertest> is an actively-maintained
162
macrobenchmark suite.
168
* ``bzr ignore PATTERNS`` exits with error if a bad pattern is supplied.
169
``InvalidPattern`` exception error message now shows faulting
171
(Parth Malwankar #300062)
173
* Configuration files in ``${BZR_HOME}`` are now written in an atomic
174
way which should help avoid problems with concurrent writers.
175
(Vincent Ladeuil, #525571)
177
* Don't traceback trying to unversion children files of an already
178
unversioned directory. (Vincent Ladeuil, #494221)
180
* ``HTTP/1.1` test servers now set a ``Content-Length`` header to comply
181
with pedantic ``HTTP/1.1`` clients. (Vincent Ladeuil, #568421)
183
* Progress bars prefer to truncate the text message rather than the
184
counters. The spinner is shown between the network transfer indicator
185
and the progress message. Progress bars are correctly cleared off when
186
they finish. (Martin Pool, #611127)
188
* Recursive binding for checkouts is now detected by bzr. A clear error
189
message is shown to the user. (Parth Malwankar, #405192)
194
* Add ``bzrlib.merge.MergeIntoMerger``, which can merge part or all of a
195
tree, and works with unrelated branches. (Andrew Bennetts)
197
* Add py2exe windows target ``bzrw.exe``. This allow for starting a Bazaar
198
GUI with out have a console open in the background.
199
(Gary van der Merwe, #433781)
204
* ``bzr help patterns`` now explains case insensitive patterns and
205
points to Python regular expression documentation.
206
(Parth Malwankar, #594386)
211
* Delete ``ProgressTask.note``, which was deprecated in 2.1.
216
* Unit test added to ensure that "message" is not uses as a format variable
217
name in BzrError subclasses as this conflicts with some Python versions.
218
(Parth Malwankar, #603461)
223
:Codename: Monkey Magic
227
This fourth and final beta in the 2.2 series now stabilizes the internal
228
APIs. Plugin authors are recommended to ensure their releases are
229
compatible, so that 2.2rc1 can be a true release candidate, containing
230
stable and compatible plugin versions.
232
For users of bzrlib as a library, one of the primary changes is to request
233
that they call ``bzrlib.initialize`` and use the returned context manager
236
Better interaction with ``bzr-loom`` to make sure branching from a loom
237
even over a smart server still yields a local loom. Not to mention lots of
243
* bzrlib library users now need to call ``__enter__`` and ``__exit__`` on
244
the result of ``bzrlib.initialize``. This change was made when fixing
245
the bad habit recent bzr versions have had of leaving progress bars
246
behind on the screen. That required calling another function before
247
exiting the program, and it made sense to provide a full context
248
manager at the same time. (Robert Collins)
250
* The ``bzr`` front end now requires a ``bzrlib.ui.ui_factory`` which is a
251
context manager in the Python 2.5 and above sense. The bzrlib base class
252
is such a manager, but third party UI factories which do not derive from
253
``bzrlib.ui.UIFactory`` will be incompatible with the command line front
256
* URLs like ``foo:bar/baz`` are now always parsed as a URL with scheme "foo"
257
and path "bar/baz", even if bzr does not recognize "foo" as a known URL
258
scheme. Previously these URLs would be treated as local paths.
265
* Support ``--directory`` option for a number of additional commands:
266
conflicts, merge-directive, missing, resolve, shelve, switch,
267
unshelve, whoami. (Martin von Gagern, #527878)
272
* ``bzr branch`` to a new repository with a default stacking policy no
273
longer transfers the full history unnecessarily.
274
(Andrew Bennetts, #597942)
276
* ``bzr init`` does not recursively scan directory contents anymore
277
leading to faster init for directories with existing content.
278
(Martin [gz], Parth Malwankar, #501307)
280
* ``bzr log --exclude-common-ancestry`` is now taken into account for
281
linear ancetries. (Vincent Ladeuil, #575631)
283
* ``bzr log -r branch:REMOTE`` can now properly log the remote branch,
284
rather than trying to fetch the data locally and failing because of a
285
readonly error. (Martin von Gagern, #149270)
287
* ``bzr pull`` now works when a lp: URL is explicitly defined as the parent
288
or pull location in locations.conf or branch.conf.
289
(Gordon Tyler, #534787)
291
* ``bzr reconfigure --unstacked`` now works with branches accessed via a
292
smart server. (Andrew Bennetts, #551525)
294
* ``BzrDir.find_branches`` should ignore branches with missing repositories.
295
(Marius Kruger, Robert Collins)
297
* ``BzrDir.find_bzrdirs`` should ignore dirs that raises PermissionDenied.
298
(Marius Kruger, Robert Collins)
300
* Ensure that wrong path specifications in ``BZR_PLUGINS_AT`` display
301
proper error messages. (Vincent Ladeuil, #591215)
303
* Explicitly removing ``--profile-imports`` option from parsed command-line
304
arguments on Windows, because bzr script does the same.
305
(Alexander Belchenko, #588277)
307
* Fetching was slightly confused about the best code to use and was
308
using a new code path for all branches, resulting in more lookups than
309
necessary on old branches. (Robert Collins, #593515)
311
* Final fix for 'no help for command' issue. We now show a clean message
312
when a command has no help, document how to set help more clearly, and
313
test that all commands available to the test suite have help.
314
(Robert Collins, #177500)
316
* Invalid patterns supplied to ``Globster`` or ``lazy_regex`` now raise
317
``InvalidPattern`` exception showing clear error message to the user.
318
(Parth Malwankar #300062)
320
* Progress output is cleaned up when exiting. (Aaron Bentley)
322
* Raise ValueError instead of a string exception.
323
(John Arbash Meinel, #586926)
325
* Relative imports in plugins are now handled correctly when using
326
BZR_PLUGINS_AT. (Vincent Ladeuil, #588959)
328
* ``ScriptRunner`` now strips off leading indentation from test scripts,
329
which previously caused "SyntaxError: No command for line".
332
* Show unicode filenames in diff headers using terminal encoding.
333
(Alexander Belchenko, Bug #382699)
334
NOTE for Windows users: If user need to save diff to file then user need to
335
change encoding of the terminal to ANSI encoding with command ``chcp XXX``
336
(e.g. ``chcp 1251`` for Russian Windows).
338
* URL displayed for use with ``break-lock`` when smart server sees lock
339
contention are now valid. Default timeout for lock contention retry is
340
now 30 seconds instead of 300 seconds.
341
(Parth Malwankar, #250451)
343
* ``walkdirs`` now raises a useful message when the filenames are not using
344
the filesystem encoding. (Eric Moritz, #488519)
346
* Enable debugging of bzr on windows with pdb and other tools. This was
347
broken because we call GetCommandLineW on windows. The fix adjusts the
348
command line we get to be the same length as sys.argv.
349
(Jason Spashett, Alexander Belchenko, #587868)
354
* Bazaar now reads data from SSH connections more efficiently on platforms
355
that provide the ``socketpair`` function, and when using paramiko.
356
(Andrew Bennetts, #590637)
358
* ``Branch.copy_content_into`` is now a convenience method dispatching to
359
a ``InterBranch`` multi-method. This permits ``bzr-loom`` and other
360
plugins to intercept this even when a ``RemoteBranch`` proxy is in use.
361
(Robert Collins, #201613)
363
* ``Branch`` formats can now be loaded lazily by registering a
364
``MetaDirBranchFormatFactory`` rather than an actual format. This will
365
cause the named format class to be loaded only when an enumeration of
366
formats is needed or when the format string for the object is
367
encountered. (Robert Collins, Jelmer Vernooij)
369
* The encoding that bzr uses to output things other than file content can
370
now be overridden via the output_encoding configuration option.
371
(Martin Pool, #340394)
373
* Use lazy imports in ``bzrlib/merge.py`` so that plugins like ``news_merge``
374
do not cause modules to be loaded unnecessarily just because the plugin
375
registers a merge hook. This improves ``bzr rocks`` time by about 25%
376
in a default installation (with just the core plugins).
382
* Added ``regression`` tag to our tags list. (Robert Collins)
384
* Improved our release checklist to have a bit less churn and leave things
385
ready-to-go for the next action (including other people doing
386
development). (Robert Collins)
388
* Remove obsolete discussion of PQM in documentation about how to
389
contribute to Bazaar. (Martin Pool, #588444)
394
* ``bzrlib.branch.InterBranch._get_branch_formats_to_test`` now returns
395
an iterable of format pairs, rather than just a single pair, permitting
396
InterBranch objects that work with multiple permutations to be
397
comprehensively tested. (Robert Collins)
399
* ``bzrlib.lsprof.profile`` will no longer silently generate bad threaded
400
profiles when concurrent profile requests are made. Instead the profile
401
requests will be serialised. Reentrant requests will now deadlock.
404
* ``bzrlib.knit.KnitSequenceMatcher``, which has been deprecated since
405
2007, has been deleted. Use ``PatienceSequenceMatcher`` from
406
``bzrlib.patiencediff`` instead. (Andrew Bennetts)
408
* ``bzrlib.re_compile_checked`` is now deprecated. Caller should handle
409
``bzrlib.errors.InvalidPattern`` exception thrown by ``re.match`` in
410
case the default error message not suitable for the use case.
413
* ``bzrlib.tests.blackbox.ExternalBase`` is deprecated. It provided only
414
one method ``check_output``, and we now recommend checking command
415
output using ``run_script``. (Martin Pool)
417
* ``bzrlib.transport.ssh.SSHVendor.connect_ssh`` now returns an object
418
that implements the interface of ``bzrlib.transport.ssh.SSHConnection``.
419
Third-party implementations of ``SSHVendor`` may need to be updated
420
accordingly. Similarly, any code using ``SSHConnection`` directly will
421
need to be updated. (Andrew Bennetts)
423
* The constructor of ``bzrilb.smart.medium.SmartSSHClientMedium`` has
424
changed to take an ``SSHParams`` instance (replacing many individual
425
values). (Andrew Bennetts)
430
* ``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
431
selection when explicitly requested; this avoids many duplicate calls
432
being logged when helpers, wrappers and older code that manually calls
433
it are executed it is now logged deliberately by the ui setup code.
436
* Improved ``bzrlib.urlutils`` to handle lp:foo/bar URLs. (Gordon Tyler)
438
* ``bzrlib._c_static_tuple.StaticTuple`` now implements ``__sizeof__``, so
439
that ``sys.getsizeof`` and other memory analysis tools will report more
440
accurate results. (Andrew Bennetts)
442
* The symbol_versioning module can now cleanup after itself -
443
``suppress_deprecation_warnings`` now returns a cleanup function.
449
* Add ``bzrlib.tests.fixtures`` to hold code for setting up objects
450
to test. (Martin Pool)
452
* ``test_import_tariff`` now respects BZR_PLUGINS_AT and BZR_PLUGINS_DISABLE.
453
(Vincent Ladeuil, #595587)
11
:2.2b3: NOT RELEASED YET
460
This third beta in the 2.2 series brings with it all the goodness of 2.1.2
461
and 2.0.6 (though it preceeds 2.0.6 slightly). Of particular note for
462
users are compatibility fixes with bzr 1.5 and below servers, a hopeful
463
end to the EINTR errors caused by SIGWINCH interactions, a shiny new
464
bash completion script and bzr will no longer guess at identity details -
465
it was too unreliable in reality. Use ``bzr whoami`` on every new install.
466
For developers we have some API changes which may impact plugins as well
467
as a bunch of our regular improvements to internal clarity and test
13
470
Compatibility Breaks
14
471
********************
473
* An API break has been made to the lock_write method of ``Branch`` and
474
``Repository`` objects; they now return ``branch.BranchWriteLockResult``
475
and ``repository.RepositoryWriteLockResult`` objects. This makes
476
changing the API in future easier and permits some cleaner calling code.
477
The lock_read method has also changed from having no defined return
478
value to returning ``LogicalLockResult`` objects.
481
* ``bzr`` does not try to guess the username as ``username@hostname``
482
and requires it to be explictly set. This can be set using ``bzr
483
whoami``. (Parth Malwankar, #549310)
485
* ``bzrlib.commands.Command`` will now raise ValueError during
486
construction if there is no __doc__ set. (Note, this will be reverted in
487
2.2b4) (Robert Collins)
489
* The source tree no longer contains a contrib/zsh/_bzr completion
490
script. The new file contrib/zsh/README suggests alternatives.
491
(Martin von Gagern, #560030)
31
508
(Parth Malwankar, #304320)
510
* New command line option ``--authors`` to ``bzr log`` allows users to
511
select which of the apparent authors and committer should be
512
included in the log. Defaults depend on format. (Martin von Gagern, #513322)
514
* Support ``--directory`` option for a number of additional commands:
515
added, annotate, bind, cat, cat-revision, clean-tree, deleted,
516
export, ignore, ignored, lookup-revision, ls, modified, nick,
517
re-sign, unbind, unknowns.
518
(Martin von Gagern, #527878)
520
* The bash_completion plugin from the bzr-bash-completion project has
521
been merged into the tree. It provides a bash-completion command and
522
replaces the outdated ``contrib/bash/bzr`` script with a version
523
using the plugin. (Martin von Gagern, #560030)
525
* A new transport based on GIO (the gnome i/o library) provides access to
526
samba shares, webdav using gio+smb and gio+dav. It is also possible to
527
use gio for some already existing transport methods as gio+file,
534
* Alias information shown by ``bzr help`` is now accurate. This
535
was showing an internal object name for some plugin aliases.
536
(Parth Malwankar, #584650)
36
538
* ``.bazaar``, ``.bazaar/bazaar.conf`` and ``.bzr.log`` inherit user and
37
539
group ownership from the containing directory. This allow bzr to work
39
541
(Martin <gzlist@googlemail.com>, Parth Malwankar, #376388)
543
* ``bzr clean-tree`` should not delete nested bzrdirs. Required for proper
544
support of bzr-externals and scmproj plugins.
545
(Alexander Belchenko, bug #572098)
547
* ``bzr ignore`` will no longer add duplicate patterns to .bzrignore.
548
(Gordon Tyler, #572092)
41
550
* ``bzr log --exclude-common-ancestry -r X..Y`` displays the revisions that
42
551
are part of Y ancestry but not part of X ancestry (aka the graph
44
553
(Vincent Ladeuil, #320119)
555
* ``bzr lp-propose`` which was switched to use production Launchpad API
556
servers a few commits ago has been reverted to use edge: there is a
557
problem with using production which isn't trivially obvious, so we've
558
filed a bug to track it, and until thats fixed will be using edge.
559
(Robert Collins, #583667)
561
* ``bzr rm`` should not refuse to delete directories which contained a file
562
which has been moved elsewhere in the tree after the previous commit.
563
(Marius Kruger, Daniel Watkins, #129880)
46
565
* ``bzr selftest --parallel=fork`` wait for its children avoiding zombies.
47
566
(Vincent Ladeuil, #566670)
49
568
* ``bzr selftest`` should not use ui.note() since it's not unicode safe.
50
569
(Vincent Ladeuil, #563997)
571
* CommitBuilder refuses to create revisions whose trees have no root.
574
* Do not register a SIGWINCH signal handler, instead just poll for the
575
terminal width as needed. This avoids the "Interrupted System Call"
576
problems that occur on POSIX with all currently released versions of
578
(Andrew Bennetts, #583941)
52
580
* Don't mention --no-strict when we just issue the warning about unclean trees.
53
581
(Vincent Ladeuil, #401599)
added
removed
NEWS
