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
* Don't print internal object name when print an invalid revision spec
51
error. (Neil Martinsen-Burrell, #598701)
53
* ``HTTP/1.1` test servers now set a ``Content-Length`` header to comply
54
with pedantic ``HTTP/1.1`` clients. (Vincent Ladeuil, #568421)
56
* `PathNotChild` should not give a traceback.
59
* Prevent ``CHKMap.apply_delta`` from generating non-canonical CHK maps,
60
which can result in "missing referenced chk root keys" errors when
61
fetching from repositories with affected revisions.
62
(Andrew Bennetts, #522637)
64
* ``Transport.stat`` on a symlink, including a transport pointing directly
65
to a symlink, now returns information about the symlink.
71
* When building new working trees, default to reading from the repository
72
rather than the source tree unless explicitly requested. (via
73
``--files-from`` and ``--hardlink`` for ``bzr branch`` and
74
``bzr checkout``. Generally, 2a format repositories extract
75
content faster than seeking and reading content from another tree,
76
especially in cold-cache situations. (John Arbash Meinel, #607298)
95
:2.2rc1: NOT RELEASED YET
100
* BzrError subclasses no longer support the name "message" to be used
101
as an argument for __init__ or in _fmt format specification as this
102
breaks in some Python versions. errors.LockError.__init__ argument
103
is now named "msg" instead of earlier "message".
104
(Parth Malwankar, #603461)
106
* The old ``bzr selftest --benchmark`` option has been removed.
107
<https://launchpad.net/bzr-usertest> is an actively-maintained
108
macrobenchmark suite.
117
* ``bzr ignore PATTERNS`` exits with error if a bad pattern is supplied.
118
``InvalidPattern`` exception error message now shows faulting
120
(Parth Malwankar #300062)
122
* Configuration files in ``${BZR_HOME}`` are now written in an atomic
123
way which should help avoid problems with concurrent writers.
124
(Vincent Ladeuil, #525571)
126
* Don't traceback trying to unversion children files of an already
127
unversioned directory. (Vincent Ladeuil, #494221)
132
* Add ``bzrlib.merge.MergeIntoMerger``, which can merge part or all of a
133
tree, and works with unrelated branches. (Andrew Bennetts)
138
* ``bzr help patterns`` now explains case insensitive patterns and
139
points to Python regular expression documentation.
140
(Parth Malwankar, #594386)
145
* Delete ``ProgressTask.note``, which was deprecated in 2.1.
153
* Unit test added to ensure that "message" is not uses as a format variable
154
name in BzrError subclasses as this conflicts with some Python versions.
155
(Parth Malwankar, #603461)
160
:Codename: Monkey Magic
164
This fourth and final beta in the 2.2 series now stabilizes the internal
165
APIs. Plugin authors are recommended to ensure their releases are
166
compatible, so that 2.2rc1 can be a true release candidate, containing
167
stable and compatible plugin versions.
169
For users of bzrlib as a library, one of the primary changes is to request
170
that they call ``bzrlib.initialize`` and use the returned context manager
173
Better interaction with ``bzr-loom`` to make sure branching from a loom
174
even over a smart server still yields a local loom. Not to mention lots of
180
* bzrlib library users now need to call ``__enter__`` and ``__exit__`` on
181
the result of ``bzrlib.initialize``. This change was made when fixing
182
the bad habit recent bzr versions have had of leaving progress bars
183
behind on the screen. That required calling another function before
184
exiting the program, and it made sense to provide a full context
185
manager at the same time. (Robert Collins)
187
* The ``bzr`` front end now requires a ``bzrlib.ui.ui_factory`` which is a
188
context manager in the Python 2.5 and above sense. The bzrlib base class
189
is such a manager, but third party UI factories which do not derive from
190
``bzrlib.ui.UIFactory`` will be incompatible with the command line front
193
* URLs like ``foo:bar/baz`` are now always parsed as a URL with scheme "foo"
194
and path "bar/baz", even if bzr does not recognize "foo" as a known URL
195
scheme. Previously these URLs would be treated as local paths.
202
* Support ``--directory`` option for a number of additional commands:
203
conflicts, merge-directive, missing, resolve, shelve, switch,
204
unshelve, whoami. (Martin von Gagern, #527878)
209
* ``bzr branch`` to a new repository with a default stacking policy no
210
longer transfers the full history unnecessarily.
211
(Andrew Bennetts, #597942)
213
* ``bzr init`` does not recursively scan directory contents anymore
214
leading to faster init for directories with existing content.
215
(Martin [gz], Parth Malwankar, #501307)
217
* ``bzr log --exclude-common-ancestry`` is now taken into account for
218
linear ancetries. (Vincent Ladeuil, #575631)
220
* ``bzr log -r branch:REMOTE`` can now properly log the remote branch,
221
rather than trying to fetch the data locally and failing because of a
222
readonly error. (Martin von Gagern, #149270)
224
* ``bzr pull`` now works when a lp: URL is explicitly defined as the parent
225
or pull location in locations.conf or branch.conf.
226
(Gordon Tyler, #534787)
228
* ``bzr reconfigure --unstacked`` now works with branches accessed via a
229
smart server. (Andrew Bennetts, #551525)
231
* ``BzrDir.find_branches`` should ignore branches with missing repositories.
232
(Marius Kruger, Robert Collins)
234
* ``BzrDir.find_bzrdirs`` should ignore dirs that raises PermissionDenied.
235
(Marius Kruger, Robert Collins)
237
* Ensure that wrong path specifications in ``BZR_PLUGINS_AT`` display
238
proper error messages. (Vincent Ladeuil, #591215)
240
* Explicitly removing ``--profile-imports`` option from parsed command-line
241
arguments on Windows, because bzr script does the same.
242
(Alexander Belchenko, #588277)
244
* Fetching was slightly confused about the best code to use and was
245
using a new code path for all branches, resulting in more lookups than
246
necessary on old branches. (Robert Collins, #593515)
248
* Final fix for 'no help for command' issue. We now show a clean message
249
when a command has no help, document how to set help more clearly, and
250
test that all commands available to the test suite have help.
251
(Robert Collins, #177500)
253
* Invalid patterns supplied to ``Globster`` or ``lazy_regex`` now raise
254
``InvalidPattern`` exception showing clear error message to the user.
255
(Parth Malwankar #300062)
257
* Progress output is cleaned up when exiting. (Aaron Bentley)
259
* Raise ValueError instead of a string exception.
260
(John Arbash Meinel, #586926)
262
* Relative imports in plugins are now handled correctly when using
263
BZR_PLUGINS_AT. (Vincent Ladeuil, #588959)
265
* ``ScriptRunner`` now strips off leading indentation from test scripts,
266
which previously caused "SyntaxError: No command for line".
269
* Show unicode filenames in diff headers using terminal encoding.
270
(Alexander Belchenko, Bug #382699)
271
NOTE for Windows users: If user need to save diff to file then user need to
272
change encoding of the terminal to ANSI encoding with command ``chcp XXX``
273
(e.g. ``chcp 1251`` for Russian Windows).
275
* URL displayed for use with ``break-lock`` when smart server sees lock
276
contention are now valid. Default timeout for lock contention retry is
277
now 30 seconds instead of 300 seconds.
278
(Parth Malwankar, #250451)
280
* ``walkdirs`` now raises a useful message when the filenames are not using
281
the filesystem encoding. (Eric Moritz, #488519)
283
* Enable debugging of bzr on windows with pdb and other tools. This was
284
broken because we call GetCommandLineW on windows. The fix adjusts the
285
command line we get to be the same length as sys.argv.
286
(Jason Spashett, Alexander Belchenko, #587868)
291
* Bazaar now reads data from SSH connections more efficiently on platforms
292
that provide the ``socketpair`` function, and when using paramiko.
293
(Andrew Bennetts, #590637)
295
* ``Branch.copy_content_into`` is now a convenience method dispatching to
296
a ``InterBranch`` multi-method. This permits ``bzr-loom`` and other
297
plugins to intercept this even when a ``RemoteBranch`` proxy is in use.
298
(Robert Collins, #201613)
300
* ``Branch`` formats can now be loaded lazily by registering a
301
``MetaDirBranchFormatFactory`` rather than an actual format. This will
302
cause the named format class to be loaded only when an enumeration of
303
formats is needed or when the format string for the object is
304
encountered. (Robert Collins, Jelmer Vernooij)
306
* The encoding that bzr uses to output things other than file content can
307
now be overridden via the output_encoding configuration option.
308
(Martin Pool, #340394)
310
* Use lazy imports in ``bzrlib/merge.py`` so that plugins like ``news_merge``
311
do not cause modules to be loaded unnecessarily just because the plugin
312
registers a merge hook. This improves ``bzr rocks`` time by about 25%
313
in a default installation (with just the core plugins).
319
* Added ``regression`` tag to our tags list. (Robert Collins)
321
* Improved our release checklist to have a bit less churn and leave things
322
ready-to-go for the next action (including other people doing
323
development). (Robert Collins)
325
* Remove obsolete discussion of PQM in documentation about how to
326
contribute to Bazaar. (Martin Pool, #588444)
331
* ``bzrlib.branch.InterBranch._get_branch_formats_to_test`` now returns
332
an iterable of format pairs, rather than just a single pair, permitting
333
InterBranch objects that work with multiple permutations to be
334
comprehensively tested. (Robert Collins)
336
* ``bzrlib.lsprof.profile`` will no longer silently generate bad threaded
337
profiles when concurrent profile requests are made. Instead the profile
338
requests will be serialised. Reentrant requests will now deadlock.
341
* ``bzrlib.knit.KnitSequenceMatcher``, which has been deprecated since
342
2007, has been deleted. Use ``PatienceSequenceMatcher`` from
343
``bzrlib.patiencediff`` instead. (Andrew Bennetts)
345
* ``bzrlib.re_compile_checked`` is now deprecated. Caller should handle
346
``bzrlib.errors.InvalidPattern`` exception thrown by ``re.match`` in
347
case the default error message not suitable for the use case.
350
* ``bzrlib.tests.blackbox.ExternalBase`` is deprecated. It provided only
351
one method ``check_output``, and we now recommend checking command
352
output using ``run_script``. (Martin Pool)
354
* ``bzrlib.transport.ssh.SSHVendor.connect_ssh`` now returns an object
355
that implements the interface of ``bzrlib.transport.ssh.SSHConnection``.
356
Third-party implementations of ``SSHVendor`` may need to be updated
357
accordingly. Similarly, any code using ``SSHConnection`` directly will
358
need to be updated. (Andrew Bennetts)
360
* The constructor of ``bzrilb.smart.medium.SmartSSHClientMedium`` has
361
changed to take an ``SSHParams`` instance (replacing many individual
362
values). (Andrew Bennetts)
367
* ``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
368
selection when explicitly requested; this avoids many duplicate calls
369
being logged when helpers, wrappers and older code that manually calls
370
it are executed it is now logged deliberately by the ui setup code.
373
* Improved ``bzrlib.urlutils`` to handle lp:foo/bar URLs. (Gordon Tyler)
375
* ``bzrlib._c_static_tuple.StaticTuple`` now implements ``__sizeof__``, so
376
that ``sys.getsizeof`` and other memory analysis tools will report more
377
accurate results. (Andrew Bennetts)
379
* The symbol_versioning module can now cleanup after itself -
380
``suppress_deprecation_warnings`` now returns a cleanup function.
386
* Add ``bzrlib.tests.fixtures`` to hold code for setting up objects
387
to test. (Martin Pool)
389
* ``test_import_tariff`` now respects BZR_PLUGINS_AT and BZR_PLUGINS_DISABLE.
390
(Vincent Ladeuil, #595587)
11
:2.2b3: NOT RELEASED YET
397
This third beta in the 2.2 series brings with it all the goodness of 2.1.2
398
and 2.0.6 (though it preceeds 2.0.6 slightly). Of particular note for
399
users are compatibility fixes with bzr 1.5 and below servers, a hopeful
400
end to the EINTR errors caused by SIGWINCH interactions, a shiny new
401
bash completion script and bzr will no longer guess at identity details -
402
it was too unreliable in reality. Use ``bzr whoami`` on every new install.
403
For developers we have some API changes which may impact plugins as well
404
as a bunch of our regular improvements to internal clarity and test
13
407
Compatibility Breaks
14
408
********************
410
* An API break has been made to the lock_write method of ``Branch`` and
411
``Repository`` objects; they now return ``branch.BranchWriteLockResult``
412
and ``repository.RepositoryWriteLockResult`` objects. This makes
413
changing the API in future easier and permits some cleaner calling code.
414
The lock_read method has also changed from having no defined return
415
value to returning ``LogicalLockResult`` objects.
418
* ``bzr`` does not try to guess the username as ``username@hostname``
419
and requires it to be explictly set. This can be set using ``bzr
420
whoami``. (Parth Malwankar, #549310)
422
* ``bzrlib.commands.Command`` will now raise ValueError during
423
construction if there is no __doc__ set. (Note, this will be reverted in
424
2.2b4) (Robert Collins)
426
* The source tree no longer contains a contrib/zsh/_bzr completion
427
script. The new file contrib/zsh/README suggests alternatives.
428
(Martin von Gagern, #560030)
31
445
(Parth Malwankar, #304320)
447
* New command line option ``--authors`` to ``bzr log`` allows users to
448
select which of the apparent authors and committer should be
449
included in the log. Defaults depend on format. (Martin von Gagern, #513322)
451
* Support ``--directory`` option for a number of additional commands:
452
added, annotate, bind, cat, cat-revision, clean-tree, deleted,
453
export, ignore, ignored, lookup-revision, ls, modified, nick,
454
re-sign, unbind, unknowns.
455
(Martin von Gagern, #527878)
457
* The bash_completion plugin from the bzr-bash-completion project has
458
been merged into the tree. It provides a bash-completion command and
459
replaces the outdated ``contrib/bash/bzr`` script with a version
460
using the plugin. (Martin von Gagern, #560030)
462
* A new transport based on GIO (the gnome i/o library) provides access to
463
samba shares, webdav using gio+smb and gio+dav. It is also possible to
464
use gio for some already existing transport methods as gio+file,
471
* Alias information shown by ``bzr help`` is now accurate. This
472
was showing an internal object name for some plugin aliases.
473
(Parth Malwankar, #584650)
36
475
* ``.bazaar``, ``.bazaar/bazaar.conf`` and ``.bzr.log`` inherit user and
37
476
group ownership from the containing directory. This allow bzr to work
39
478
(Martin <gzlist@googlemail.com>, Parth Malwankar, #376388)
480
* ``bzr clean-tree`` should not delete nested bzrdirs. Required for proper
481
support of bzr-externals and scmproj plugins.
482
(Alexander Belchenko, bug #572098)
484
* ``bzr ignore`` will no longer add duplicate patterns to .bzrignore.
485
(Gordon Tyler, #572092)
41
487
* ``bzr log --exclude-common-ancestry -r X..Y`` displays the revisions that
42
488
are part of Y ancestry but not part of X ancestry (aka the graph
44
490
(Vincent Ladeuil, #320119)
492
* ``bzr lp-propose`` which was switched to use production Launchpad API
493
servers a few commits ago has been reverted to use edge: there is a
494
problem with using production which isn't trivially obvious, so we've
495
filed a bug to track it, and until thats fixed will be using edge.
496
(Robert Collins, #583667)
498
* ``bzr rm`` should not refuse to delete directories which contained a file
499
which has been moved elsewhere in the tree after the previous commit.
500
(Marius Kruger, Daniel Watkins, #129880)
46
502
* ``bzr selftest --parallel=fork`` wait for its children avoiding zombies.
47
503
(Vincent Ladeuil, #566670)
49
505
* ``bzr selftest`` should not use ui.note() since it's not unicode safe.
50
506
(Vincent Ladeuil, #563997)
508
* CommitBuilder refuses to create revisions whose trees have no root.
511
* Do not register a SIGWINCH signal handler, instead just poll for the
512
terminal width as needed. This avoids the "Interrupted System Call"
513
problems that occur on POSIX with all currently released versions of
515
(Andrew Bennetts, #583941)
52
517
* Don't mention --no-strict when we just issue the warning about unclean trees.
53
518
(Vincent Ladeuil, #401599)
527
1099
happens, and another warning will be written if the log file could not
528
1100
be closed after retrying 100 times. (Andrew Bennetts, #531746)
1105
:Codename: Do run run
1106
:2.1.3: NOT RELEASED YET
1108
Compatibility Breaks
1109
********************
1117
* ``bzr ignore PATTERNS`` exits with error if a bad pattern is supplied.
1118
``InvalidPattern`` exception error message now shows faulting
1120
(Parth Malwankar #300062)
1122
* Configuration files in ``${BZR_HOME}`` are now written in an atomic
1123
way which should help avoid problems with concurrent writers.
1124
(Vincent Ladeuil, #525571)
1126
* Don't traceback trying to unversion children files of an already
1127
unversioned directory. (Vincent Ladeuil, #494221)
1129
* ``HTTP/1.1` test servers now set a ``Content-Length`` header to comply
1130
with pedantic ``HTTP/1.1`` clients. (Vincent Ladeuil, #568421)
1132
* Prevent ``CHKMap.apply_delta`` from generating non-canonical CHK maps,
1133
which can result in "missing referenced chk root keys" errors when
1134
fetching from repositories with affected revisions.
1135
(Andrew Bennetts, #522637)
1137
* Progress bars prefer to truncate the text message rather than the
1138
counters. The spinner is shown between the network transfer indicator
1139
and the progress message. (Martin Pool)
1141
* Raise ValueError instead of a string exception.
1142
(John Arbash Meinel, #586926)
1144
* Recursive binding for checkouts is now detected by bzr. A clear error
1145
message is shown to the user. (Parth Malwankar, #405192)
1150
* Add ``bzrlib.merge.MergeIntoMerger``, which can merge part or all of a
1151
tree, and works with unrelated branches. (Andrew Bennetts)
1156
* ``bzr help patterns`` now explains case insensitive patterns and
1157
points to Python regular expression documentation.
1158
(Parth Malwankar, #594386)
1163
* Delete ``ProgressTask.note``, which was deprecated in 2.1.
1171
* Unit test added to ensure that "message" is not uses as a format variable
1172
name in BzrError subclasses as this conflicts with some Python versions.
1173
(Parth Malwankar, #603461)
533
:2.1.2: NOT RELEASED YET
1180
This release fixes two critical networking issues with older servers and
1181
with interrupted system call errors when pushing or pulling. We recommend
1182
upgrading to anyone running a 2.1.x version of bzr.
1187
* ``bzr clean-tree`` should not delete nested bzrdirs. Required for proper
1188
support of bzr-externals and scmproj plugins.
1189
(Alexander Belchenko, bug #572098)
538
1191
* ``bzr switch`` does not die if a ConfigurableFileMerger is used.
539
1192
(Aaron Bentley, #559436)
1194
* Do not register a SIGWINCH signal handler, instead just poll for the
1195
terminal width as needed. This avoids the "Interrupted System Call"
1196
problems that occur on POSIX with all currently released versions of
1198
(Andrew Bennetts, #583941)
541
1200
* Fixed ``AssertionError`` when accessing smart servers running Bazaar
542
1201
versions before 1.6.
543
1202
(Andrew Bennetts, #528041)