5
5
.. contents:: List of Releases
12
:2.2.1: NOT RELEASED YET
20
* CommitBuilder now uses the committer instead of _config.username to generate
21
the revision-id. (Aaron Bentley, #614404)
42
This release marks the start of another long-term-stable series. From
43
here, we will only make bugfix releases on the 2.2 series (2.2.1, etc),
44
while 2.3 will become our new development series. The 2.0 and 2.1 series
45
will also continue to get bugfixes. (Currently 2.0 is planned to be
46
supported for another 6 months.)
48
This is primarily a bugfix and polish release over the 2.1 series, with
49
a large number of bugs fixed (>120), and some performance improvements.
51
There are some compatibility changes in this release. For users of bzrlib
52
as a library, we now request that they call ``bzrlib.initialize`` and use
53
the returned context manager appropriately. For commandline users we no
54
longer guess user identity for ``bzr commit``, users must specify their
55
identity using ``bzr whoami`` (you don't need to specify your identity for
58
Users are encouraged to upgrade from the other stable series.
63
* BzrError subclasses no longer support the name "message" to be used
64
as an argument for __init__ or in _fmt format specification as this
65
breaks in some Python versions. errors.LockError.__init__ argument
66
is now named "msg" instead of earlier "message".
67
(Parth Malwankar, #603461)
69
* The old ``bzr selftest --benchmark`` option has been removed.
70
<https://launchpad.net/bzr-usertest> is an actively-maintained
77
* ``bzr ignore PATTERNS`` exits with error if a bad pattern is supplied.
78
``InvalidPattern`` exception error message now shows faulting
80
(Parth Malwankar #300062)
82
* Configuration files in ``${BZR_HOME}`` are now written in an atomic
83
way which should help avoid problems with concurrent writers.
84
(Vincent Ladeuil, #525571)
86
* Don't traceback trying to unversion children files of an already
87
unversioned directory. (Vincent Ladeuil, #494221)
89
* ``HTTP/1.1`` test servers now set a ``Content-Length`` header to comply
90
with pedantic ``HTTP/1.1`` clients. (Vincent Ladeuil, #568421)
92
* Progress bars prefer to truncate the text message rather than the
93
counters. The spinner is shown between the network transfer indicator
94
and the progress message. Progress bars are correctly cleared off when
95
they finish. (Martin Pool, #611127)
97
* Recursive binding for checkouts is now detected by bzr. A clear error
98
message is shown to the user. (Parth Malwankar, #405192)
103
* Add ``bzrlib.merge.MergeIntoMerger``, which can merge part or all of a
104
tree, and works with unrelated branches. (Andrew Bennetts)
106
* Add py2exe windows target ``bzrw.exe``. This allow for starting a Bazaar
107
GUI with out have a console open in the background.
108
(Gary van der Merwe, #433781)
113
* ``bzr help patterns`` now explains case insensitive patterns and
114
points to Python regular expression documentation.
115
(Parth Malwankar, #594386)
120
* Delete ``ProgressTask.note``, which was deprecated in 2.1.
125
* Unit test added to ensure that "message" is not uses as a format variable
126
name in BzrError subclasses as this conflicts with some Python versions.
127
(Parth Malwankar, #603461)
132
:Codename: Monkey Magic
136
This fourth and final beta in the 2.2 series now stabilizes the internal
137
APIs. Plugin authors are recommended to ensure their releases are
138
compatible, so that 2.2rc1 can be a true release candidate, containing
139
stable and compatible plugin versions.
141
For users of bzrlib as a library, one of the primary changes is to request
142
that they call ``bzrlib.initialize`` and use the returned context manager
145
Better interaction with ``bzr-loom`` to make sure branching from a loom
146
even over a smart server still yields a local loom. Not to mention lots of
152
* bzrlib library users now need to call ``__enter__`` and ``__exit__`` on
153
the result of ``bzrlib.initialize``. This change was made when fixing
154
the bad habit recent bzr versions have had of leaving progress bars
155
behind on the screen. That required calling another function before
156
exiting the program, and it made sense to provide a full context
157
manager at the same time. (Robert Collins)
159
* The ``bzr`` front end now requires a ``bzrlib.ui.ui_factory`` which is a
160
context manager in the Python 2.5 and above sense. The bzrlib base class
161
is such a manager, but third party UI factories which do not derive from
162
``bzrlib.ui.UIFactory`` will be incompatible with the command line front
165
* URLs like ``foo:bar/baz`` are now always parsed as a URL with scheme "foo"
166
and path "bar/baz", even if bzr does not recognize "foo" as a known URL
167
scheme. Previously these URLs would be treated as local paths.
174
* Support ``--directory`` option for a number of additional commands:
175
conflicts, merge-directive, missing, resolve, shelve, switch,
176
unshelve, whoami. (Martin von Gagern, #527878)
181
* ``bzr branch`` to a new repository with a default stacking policy no
182
longer transfers the full history unnecessarily.
183
(Andrew Bennetts, #597942)
185
* ``bzr init`` does not recursively scan directory contents anymore
186
leading to faster init for directories with existing content.
187
(Martin [gz], Parth Malwankar, #501307)
189
* ``bzr log --exclude-common-ancestry`` is now taken into account for
190
linear ancetries. (Vincent Ladeuil, #575631)
192
* ``bzr log -r branch:REMOTE`` can now properly log the remote branch,
193
rather than trying to fetch the data locally and failing because of a
194
readonly error. (Martin von Gagern, #149270)
196
* ``bzr pull`` now works when a lp: URL is explicitly defined as the parent
197
or pull location in locations.conf or branch.conf.
198
(Gordon Tyler, #534787)
200
* ``bzr reconfigure --unstacked`` now works with branches accessed via a
201
smart server. (Andrew Bennetts, #551525)
203
* ``BzrDir.find_branches`` should ignore branches with missing repositories.
204
(Marius Kruger, Robert Collins)
206
* ``BzrDir.find_bzrdirs`` should ignore dirs that raises PermissionDenied.
207
(Marius Kruger, Robert Collins)
209
* Ensure that wrong path specifications in ``BZR_PLUGINS_AT`` display
210
proper error messages. (Vincent Ladeuil, #591215)
212
* Explicitly removing ``--profile-imports`` option from parsed command-line
213
arguments on Windows, because bzr script does the same.
214
(Alexander Belchenko, #588277)
216
* Fetching was slightly confused about the best code to use and was
217
using a new code path for all branches, resulting in more lookups than
218
necessary on old branches. (Robert Collins, #593515)
220
* Final fix for 'no help for command' issue. We now show a clean message
221
when a command has no help, document how to set help more clearly, and
222
test that all commands available to the test suite have help.
223
(Robert Collins, #177500)
225
* Invalid patterns supplied to ``Globster`` or ``lazy_regex`` now raise
226
``InvalidPattern`` exception showing clear error message to the user.
227
(Parth Malwankar #300062)
229
* Progress output is cleaned up when exiting. (Aaron Bentley)
231
* Raise ValueError instead of a string exception.
232
(John Arbash Meinel, #586926)
234
* Relative imports in plugins are now handled correctly when using
235
BZR_PLUGINS_AT. (Vincent Ladeuil, #588959)
237
* ``ScriptRunner`` now strips off leading indentation from test scripts,
238
which previously caused "SyntaxError: No command for line".
241
* Show unicode filenames in diff headers using terminal encoding.
242
(Alexander Belchenko, Bug #382699)
243
NOTE for Windows users: If user need to save diff to file then user need to
244
change encoding of the terminal to ANSI encoding with command ``chcp XXX``
245
(e.g. ``chcp 1251`` for Russian Windows).
247
* URL displayed for use with ``break-lock`` when smart server sees lock
248
contention are now valid. Default timeout for lock contention retry is
249
now 30 seconds instead of 300 seconds.
250
(Parth Malwankar, #250451)
252
* ``walkdirs`` now raises a useful message when the filenames are not using
253
the filesystem encoding. (Eric Moritz, #488519)
255
* Enable debugging of bzr on windows with pdb and other tools. This was
256
broken because we call GetCommandLineW on windows. The fix adjusts the
257
command line we get to be the same length as sys.argv.
258
(Jason Spashett, Alexander Belchenko, #587868)
263
* Bazaar now reads data from SSH connections more efficiently on platforms
264
that provide the ``socketpair`` function, and when using paramiko.
265
(Andrew Bennetts, #590637)
267
* ``Branch.copy_content_into`` is now a convenience method dispatching to
268
a ``InterBranch`` multi-method. This permits ``bzr-loom`` and other
269
plugins to intercept this even when a ``RemoteBranch`` proxy is in use.
270
(Robert Collins, #201613)
272
* ``Branch`` formats can now be loaded lazily by registering a
273
``MetaDirBranchFormatFactory`` rather than an actual format. This will
274
cause the named format class to be loaded only when an enumeration of
275
formats is needed or when the format string for the object is
276
encountered. (Robert Collins, Jelmer Vernooij)
278
* The encoding that bzr uses to output things other than file content can
279
now be overridden via the output_encoding configuration option.
280
(Martin Pool, #340394)
282
* Use lazy imports in ``bzrlib/merge.py`` so that plugins like ``news_merge``
283
do not cause modules to be loaded unnecessarily just because the plugin
284
registers a merge hook. This improves ``bzr rocks`` time by about 25%
285
in a default installation (with just the core plugins).
291
* Added ``regression`` tag to our tags list. (Robert Collins)
293
* Improved our release checklist to have a bit less churn and leave things
294
ready-to-go for the next action (including other people doing
295
development). (Robert Collins)
297
* Remove obsolete discussion of PQM in documentation about how to
298
contribute to Bazaar. (Martin Pool, #588444)
303
* ``bzrlib.branch.InterBranch._get_branch_formats_to_test`` now returns
304
an iterable of format pairs, rather than just a single pair, permitting
305
InterBranch objects that work with multiple permutations to be
306
comprehensively tested. (Robert Collins)
308
* ``bzrlib.lsprof.profile`` will no longer silently generate bad threaded
309
profiles when concurrent profile requests are made. Instead the profile
310
requests will be serialised. Reentrant requests will now deadlock.
313
* ``bzrlib.knit.KnitSequenceMatcher``, which has been deprecated since
314
2007, has been deleted. Use ``PatienceSequenceMatcher`` from
315
``bzrlib.patiencediff`` instead. (Andrew Bennetts)
317
* ``bzrlib.re_compile_checked`` is now deprecated. Caller should handle
318
``bzrlib.errors.InvalidPattern`` exception thrown by ``re.match`` in
319
case the default error message not suitable for the use case.
322
* ``bzrlib.tests.blackbox.ExternalBase`` is deprecated. It provided only
323
one method ``check_output``, and we now recommend checking command
324
output using ``run_script``. (Martin Pool)
326
* ``bzrlib.transport.ssh.SSHVendor.connect_ssh`` now returns an object
327
that implements the interface of ``bzrlib.transport.ssh.SSHConnection``.
328
Third-party implementations of ``SSHVendor`` may need to be updated
329
accordingly. Similarly, any code using ``SSHConnection`` directly will
330
need to be updated. (Andrew Bennetts)
332
* The constructor of ``bzrilb.smart.medium.SmartSSHClientMedium`` has
333
changed to take an ``SSHParams`` instance (replacing many individual
334
values). (Andrew Bennetts)
339
* ``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
340
selection when explicitly requested; this avoids many duplicate calls
341
being logged when helpers, wrappers and older code that manually calls
342
it are executed it is now logged deliberately by the ui setup code.
345
* Improved ``bzrlib.urlutils`` to handle lp:foo/bar URLs. (Gordon Tyler)
347
* ``bzrlib._c_static_tuple.StaticTuple`` now implements ``__sizeof__``, so
348
that ``sys.getsizeof`` and other memory analysis tools will report more
349
accurate results. (Andrew Bennetts)
351
* The symbol_versioning module can now cleanup after itself -
352
``suppress_deprecation_warnings`` now returns a cleanup function.
358
* Add ``bzrlib.tests.fixtures`` to hold code for setting up objects
359
to test. (Martin Pool)
361
* ``test_import_tariff`` now respects BZR_PLUGINS_AT and BZR_PLUGINS_DISABLE.
362
(Vincent Ladeuil, #595587)
11
:2.2b3: NOT RELEASED YET
369
This third beta in the 2.2 series brings with it all the goodness of 2.1.2
370
and 2.0.6 (though it preceeds 2.0.6 slightly). Of particular note for
371
users are compatibility fixes with bzr 1.5 and below servers, a hopeful
372
end to the EINTR errors caused by SIGWINCH interactions, a shiny new
373
bash completion script and bzr will no longer guess at identity details -
374
it was too unreliable in reality. Use ``bzr whoami`` on every new install.
375
For developers we have some API changes which may impact plugins as well
376
as a bunch of our regular improvements to internal clarity and test
13
379
Compatibility Breaks
14
380
********************
382
* An API break has been made to the lock_write method of ``Branch`` and
383
``Repository`` objects; they now return ``branch.BranchWriteLockResult``
384
and ``repository.RepositoryWriteLockResult`` objects. This makes
385
changing the API in future easier and permits some cleaner calling code.
386
The lock_read method has also changed from having no defined return
387
value to returning ``LogicalLockResult`` objects.
390
* ``bzr`` does not try to guess the username as ``username@hostname``
391
and requires it to be explictly set. This can be set using ``bzr
392
whoami``. (Parth Malwankar, #549310)
394
* ``bzrlib.commands.Command`` will now raise ValueError during
395
construction if there is no __doc__ set. (Note, this will be reverted in
396
2.2b4) (Robert Collins)
398
* The source tree no longer contains a contrib/zsh/_bzr completion
399
script. The new file contrib/zsh/README suggests alternatives.
400
(Martin von Gagern, #560030)
31
417
(Parth Malwankar, #304320)
419
* New command line option ``--authors`` to ``bzr log`` allows users to
420
select which of the apparent authors and committer should be
421
included in the log. Defaults depend on format. (Martin von Gagern, #513322)
423
* Support ``--directory`` option for a number of additional commands:
424
added, annotate, bind, cat, cat-revision, clean-tree, deleted,
425
export, ignore, ignored, lookup-revision, ls, modified, nick,
426
re-sign, unbind, unknowns.
427
(Martin von Gagern, #527878)
429
* The bash_completion plugin from the bzr-bash-completion project has
430
been merged into the tree. It provides a bash-completion command and
431
replaces the outdated ``contrib/bash/bzr`` script with a version
432
using the plugin. (Martin von Gagern, #560030)
434
* A new transport based on GIO (the gnome i/o library) provides access to
435
samba shares, webdav using gio+smb and gio+dav. It is also possible to
436
use gio for some already existing transport methods as gio+file,
443
* Alias information shown by ``bzr help`` is now accurate. This
444
was showing an internal object name for some plugin aliases.
445
(Parth Malwankar, #584650)
36
447
* ``.bazaar``, ``.bazaar/bazaar.conf`` and ``.bzr.log`` inherit user and
37
448
group ownership from the containing directory. This allow bzr to work
39
450
(Martin <gzlist@googlemail.com>, Parth Malwankar, #376388)
452
* ``bzr clean-tree`` should not delete nested bzrdirs. Required for proper
453
support of bzr-externals and scmproj plugins.
454
(Alexander Belchenko, bug #572098)
456
* ``bzr ignore`` will no longer add duplicate patterns to .bzrignore.
457
(Gordon Tyler, #572092)
41
459
* ``bzr log --exclude-common-ancestry -r X..Y`` displays the revisions that
42
460
are part of Y ancestry but not part of X ancestry (aka the graph
44
462
(Vincent Ladeuil, #320119)
464
* ``bzr lp-propose`` which was switched to use production Launchpad API
465
servers a few commits ago has been reverted to use edge: there is a
466
problem with using production which isn't trivially obvious, so we've
467
filed a bug to track it, and until thats fixed will be using edge.
468
(Robert Collins, #583667)
470
* ``bzr rm`` should not refuse to delete directories which contained a file
471
which has been moved elsewhere in the tree after the previous commit.
472
(Marius Kruger, Daniel Watkins, #129880)
46
474
* ``bzr selftest --parallel=fork`` wait for its children avoiding zombies.
47
475
(Vincent Ladeuil, #566670)
49
477
* ``bzr selftest`` should not use ui.note() since it's not unicode safe.
50
478
(Vincent Ladeuil, #563997)
480
* CommitBuilder refuses to create revisions whose trees have no root.
483
* Do not register a SIGWINCH signal handler, instead just poll for the
484
terminal width as needed. This avoids the "Interrupted System Call"
485
problems that occur on POSIX with all currently released versions of
487
(Andrew Bennetts, #583941)
52
489
* Don't mention --no-strict when we just issue the warning about unclean trees.
53
490
(Vincent Ladeuil, #401599)