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
* ``bzrlib.transform.TreeTransformBase.final_kind``,
24
``bzrlib.transform.TreeTransform.tree_kind`` and
25
``bzrlib.transform.TransformPreview.tree_kind`` now return None instead
26
of raising NoSuchFile. (Vincent Ladeuil)
28
* `decode` parameter to get() method in FtpTransport and GioTransport classes
29
is deprecated. (Alexander Belchenko)
31
* `FileInWrongBranch` is deprecated in favour of `PathNotChild` and no
35
* `tree_files` and `internal_tree_files` are now deprecated in favor of
36
`WorkingTree.open_containing_paths`.
39
* `ControlDirFormat` and `ControlDir` have been split out of `BzrDirFormat`
40
and `BzrDir`, respectively. `ControlDirFormat`
41
and `ControlDir` should be used as the base classes for new non-.bzr
44
`BzrDirFormat.register_control_format` has been renamed to
45
`ControlDirFormat.register_format`.
47
`BzrDirFormat.register_server_control_format` has been removed.
49
Probing for control directories is now done by separate objects derived
50
from `bzrlib.controldir.Prober` and registered using
51
`bzrlib.controldir.ControlDirFormat.register_prober` or
52
`bzrlib.controldir.ControlDirFormat.register_server_prober`.
53
`BzrDirFormat.probe_transport` has been moved onto `Prober`.
55
`BzrDirFormat.register_format` has been renamed to
56
`BzrProber.register_bzrdir_format`.
59
* The old ``bzr selftest --benchmark`` option has been removed.
60
<https://launchpad.net/bzr-usertest> is an actively-maintained
67
* ``bzr break-lock --config [location]`` can now break config files
68
locks. (Vincent Ladeuil, #525571)
70
* ``bzrlib.config.LockableConfig`` is a base class for config files that
71
needs to be protected against multiple writers. All methods that
72
change a configuration variable value must be decorated with
73
@needs_write_lock (set_option() for example).
74
(Vincent Ladeuil, #525571)
76
* The ``lp:`` prefix will now use your known username (from
77
``bzr launchpad-login``) to expand ``~`` to your username. For example:
78
``bzr launchpad-login user && bzr push lp:~/project/branch`` will now
79
push to ``lp:~user/project/branch``. (John Arbash Meinel)
81
* New development format ``development8-subtree`` which is similar to the
82
``2a`` format and adds subtree support. (Jelmer Vernooij)
87
* Allow using both --using and --diff-options.
88
(Matthäus G. Chajdas, #234708)
90
* ``bzr add SYMLINK/FILE`` now works properly when the symlink points to a
91
previously-unversioned directory within the tree: the directory is
93
(Martin Pool, #192859)
95
* ``bzr ignore PATTERNS`` exits with error if a bad pattern is supplied.
96
``InvalidPattern`` exception error message now shows faulting
98
(Parth Malwankar #300062)
100
* ``clean-tree`` issues a warning if it is unable to delete a file
101
due to ``errno.EACCES`` instead of exiting with an error on Windows.
102
(Parth Malwankar, #430785)
104
* CommitBuilder now uses the committer instead of _config.username to generate
105
the revision-id. (Aaron Bentley, #614404)
107
* Configuration files in ``${BZR_HOME}`` are now protected against
108
concurrent writers by using a lock. (Vincent Ladeuil, #525571)
110
* Cope with Microsoft FTP Server and VSFTPd that return reply '250
111
Directory created' when mkdir succeeds. (Martin Pool, #224373)
113
* Decrease peak memory during ``bzr send``. The old code was caching all
114
text content and all inventory strings for all revisions before
115
computing the diffs. Now we only cache as long as there is a child that
116
will need them. Sending 2000 bzr revisions drops from 1.2GB peak to
117
256MB peak. (John Arbash Meinel, #614576)
119
* Don't print internal object name when print an invalid revision spec
120
error. (Neil Martinsen-Burrell, #598701)
122
* ``EPIPE`` can be raised during test server shutdown. This happened on
123
gentoo only so far. (Vincent Ladeuil, #627277)
125
* Errors occurring during http(s) test server starts should now be
126
handled cleanly. (Vincent Ladeuil, #392402)
128
* Fix ``AttributeError on parent.children`` when adding a file under a
129
directory that was a symlink in the previous commit.
130
(Martin Pool, #192859)
132
* Fix spurious paramiko warning on hardy by ensuring that ``selftest``
133
properly remove its warning filter. (Vincent Ladeuil, #625686)
135
* ``HTTP/1.1`` test servers now set a ``Content-Length`` header to comply
136
with pedantic ``HTTP/1.1`` clients. (Vincent Ladeuil, #568421)
138
* Most of the leaked threads during selftest are now fixed, allowing the
139
full test suite to pass on gentoo.
140
(Vincent Ladeuil, #392127)
142
* `PathNotChild` should not give a traceback.
143
(Martin Pool, #98735)
145
* ``PQM`` will no longer ignore syntax errors in submissions.
146
(Vincent Ladeuil, #626667)
148
* Prevent ``CHKMap.apply_delta`` from generating non-canonical CHK maps,
149
which can result in "missing referenced chk root keys" errors when
150
fetching from repositories with affected revisions.
151
(Andrew Bennetts, #522637)
153
* strace test-helper tests cope with the new Ubuntu policy of not allowing
154
users to attach to their own processes by default.
155
(Martin Pool, #626679)
157
* Test classes like ``TestCase``, ``TestLoader``, and ``TestSuite`` should
158
be available from ``bzrlib.tests.*``. They used to be, but were
159
accidentally removed. (John Arbash Meinel, #627438)
161
* ``Transport.stat`` on a symlink, including a transport pointing directly
162
to a symlink, now returns information about the symlink.
165
* Wait for the SSH server to actually finish, rather than just waiting for
166
it to negotiate the key exchange. (John Arbash Meinel, #626876)
171
* ``bzr remove`` now just backs up changed files instead of exiting,
172
forcing you to choose to either keep or delete them. Bazaar will now delete
173
the files if they can easily be recovered using revert, otherwise they
174
will be backed up (adding an extention of the form .~#~).
175
(Marius Kruger, #400554)
177
* ``bzr revert`` and ``bzr status`` are up to 15% faster on large trees
178
with many changes by not repeatedly building a list of all file-ids.
181
* Decrease memory consumption when many chk index pages are loaded. (Such
182
as during ``bzr co`` or ``bzr ls -R`` of a large tree.) Often we need to
183
read many chk pages because the individual chk map nodes will be spread
184
randomly. Peak memory for 'bzr ls -R' on a large tree dropped from 396MB
185
down to 247MB, expect even more significant savings on 64-bit platforms.
188
* ``DirState`` internals use a little bit less memory. For bzr.dev it
189
drops the memory from 1MB down to about 800kB. And replaces a few
190
thousand tuples and sets with StaticTuple. (John Arbash Meinel)
192
* Inventory entries now consume less memory (on 32-bit Ubuntu file entries
193
have dropped from 68 bytes to 40, and directory entries from 120 bytes
194
to 48). (Andrew Bennetts)
196
* When building new working trees, default to reading from the repository
197
rather than the source tree unless explicitly requested. (via
198
``--files-from`` and ``--hardlink`` for ``bzr branch`` and
199
``bzr checkout``. Generally, 2a format repositories extract
200
content faster than seeking and reading content from another tree,
201
especially in cold-cache situations. (John Arbash Meinel, #607298)
206
* Added a builder/writer sphinx extension that can generate texinfo files. The
207
generated files are syntactically correct but the info navigation nodes
208
needs more work. (Vincent Ladeuil, #219334)
210
* First tests defined for sphinx, including a new bzrlib.tests.features.sphinx
211
to make the tests conditional.
214
* Fix a lot of references in the docs to the old http://bazaar-vcs.org to
215
the new http://bazaar.canonical.com or http://wiki.bazaar.canonical.com
216
(John Arbash Meinel, #617503)
221
* Configuration files should now use the ``from_string`` constructor rather
222
than the ``file`` parameter of the ``_get_parser`` method. The later has
223
been deprecated. ``from_string`` also accept a ``save=True`` parameter to
224
have the configuration file immediately written to disk.
227
* ``IniBaseConfig`` objects should now use the ``from_string`` constructor
228
the rather than the ``file`` parameter of the ``_get_parser`` method. The
229
later has been deprecated. (Vincent Ladeuil)
231
* InventoryEntry instances now raise AttributeError if you try to assign
232
to attributes that are irrelevant to that kind of entry. e.g. setting
233
``symlink_target`` on an InventoryFile will fail. It is still okay to
234
read those attributes on any kind of InventoryEntry. The complete list
235
of affected attributes is: ``executable``, ``text_id``, ``text_sha1``,
236
``text_size`` (only valid for kind == file); ``symlink_target`` (only
237
valid for kind == link); and ``reference_revision`` (only valid for kind
238
== tree-reference). (Andrew Bennetts)
240
* InventoryEntry objects no longer have ``_put_in_tar`` or
241
``_put_on_disk`` methods. (Andrew Bennetts)
243
* The ``get_filename`` parameter in the ``config.IniBaseConfig``
244
constructor has been deprecated, use the ``file_name`` parameter instead.
250
* Remove used and broken code path in ``BranchInitHookParams.__repr__``.
256
* HTTP test servers will leak less threads (and sockets) and will not hang on
257
AIX anymore. (Vincent Ladeuil, #405745)
259
* The test suite now simply holds log files in memory, rather than writing them
260
out to disk and then reading them back in and deleting them.
263
* The way ``bzr selftest --parallel`` generates N partitions of tests to
264
run in parallel has changed. Instead of splitting the list of tests at
265
N-1 points, it distributes the tests one-by-one into the partitions in a
266
round robin fashion. This reduces the total time to run the tests in
267
parallel because a series of slow tests in the test suite will be
268
distributed evenly among the parallel test suites, rather than slowing
269
down just one suite. (Andrew Bennetts)
276
:2.2.1: NOT RELEASED YET
281
* ``bzr add SYMLINK/FILE`` now works properly when the symlink points to a
282
previously-unversioned directory within the tree: the directory is
283
marked versioned too.
284
(Martin Pool, #192859)
286
* CommitBuilder now uses the committer instead of _config.username to generate
287
the revision-id. (Aaron Bentley, #614404)
289
* Cope with Microsoft FTP server that returns reply '250 Directory
290
created' when mkdir succeeds. (Martin Pool, #224373)
292
* Fix ``AttributeError on parent.children`` when adding a file under a
293
directory that was a symlink in the previous commit.
294
(Martin Pool, #192859)
299
* Fix a lot of references in the docs to the old http://bazaar-vcs.org to
300
the new http://bazaar.canonical.com or http://wiki.bazaar.canonical.com
301
(John Arbash Meinel, #617503)
306
* Remove used and broken code path in ``BranchInitHookParams.__repr__``.
316
This release marks the start of another long-term-stable series. From
317
here, we will only make bugfix releases on the 2.2 series (2.2.1, etc),
318
while 2.3 will become our new development series. The 2.0 and 2.1 series
319
will also continue to get bugfixes. (Currently 2.0 is planned to be
320
supported for another 6 months.)
322
This is primarily a bugfix and polish release over the 2.1 series, with
323
a large number of bugs fixed (>120), and some performance improvements.
325
There are some compatibility changes in this release. For users of bzrlib
326
as a library, we now request that they call ``bzrlib.initialize`` and use
327
the returned context manager appropriately. For commandline users we no
328
longer guess user identity for ``bzr commit``, users must specify their
329
identity using ``bzr whoami`` (you don't need to specify your identity for
330
readonly operations).
332
Users are encouraged to upgrade from the other stable series.
337
* BzrError subclasses no longer support the name "message" to be used
338
as an argument for __init__ or in _fmt format specification as this
339
breaks in some Python versions. errors.LockError.__init__ argument
340
is now named "msg" instead of earlier "message".
341
(Parth Malwankar, #603461)
343
* The old ``bzr selftest --benchmark`` option has been removed.
344
<https://launchpad.net/bzr-usertest> is an actively-maintained
345
macrobenchmark suite.
351
* ``bzr ignore PATTERNS`` exits with error if a bad pattern is supplied.
352
``InvalidPattern`` exception error message now shows faulting
354
(Parth Malwankar #300062)
356
* Configuration files in ``${BZR_HOME}`` are now written in an atomic
357
way which should help avoid problems with concurrent writers.
358
(Vincent Ladeuil, #525571)
360
* Don't traceback trying to unversion children files of an already
361
unversioned directory. (Vincent Ladeuil, #494221)
363
* ``HTTP/1.1`` test servers now set a ``Content-Length`` header to comply
364
with pedantic ``HTTP/1.1`` clients. (Vincent Ladeuil, #568421)
366
* Progress bars prefer to truncate the text message rather than the
367
counters. The spinner is shown between the network transfer indicator
368
and the progress message. Progress bars are correctly cleared off when
369
they finish. (Martin Pool, #611127)
371
* Recursive binding for checkouts is now detected by bzr. A clear error
372
message is shown to the user. (Parth Malwankar, #405192)
377
* Add ``bzrlib.merge.MergeIntoMerger``, which can merge part or all of a
378
tree, and works with unrelated branches. (Andrew Bennetts)
380
* Add py2exe windows target ``bzrw.exe``. This allow for starting a Bazaar
381
GUI with out have a console open in the background.
382
(Gary van der Merwe, #433781)
387
* ``bzr help patterns`` now explains case insensitive patterns and
388
points to Python regular expression documentation.
389
(Parth Malwankar, #594386)
394
* Delete ``ProgressTask.note``, which was deprecated in 2.1.
399
* Unit test added to ensure that "message" is not uses as a format variable
400
name in BzrError subclasses as this conflicts with some Python versions.
401
(Parth Malwankar, #603461)
406
:Codename: Monkey Magic
410
This fourth and final beta in the 2.2 series now stabilizes the internal
411
APIs. Plugin authors are recommended to ensure their releases are
412
compatible, so that 2.2rc1 can be a true release candidate, containing
413
stable and compatible plugin versions.
415
For users of bzrlib as a library, one of the primary changes is to request
416
that they call ``bzrlib.initialize`` and use the returned context manager
419
Better interaction with ``bzr-loom`` to make sure branching from a loom
420
even over a smart server still yields a local loom. Not to mention lots of
426
* bzrlib library users now need to call ``__enter__`` and ``__exit__`` on
427
the result of ``bzrlib.initialize``. This change was made when fixing
428
the bad habit recent bzr versions have had of leaving progress bars
429
behind on the screen. That required calling another function before
430
exiting the program, and it made sense to provide a full context
431
manager at the same time. (Robert Collins)
433
* The ``bzr`` front end now requires a ``bzrlib.ui.ui_factory`` which is a
434
context manager in the Python 2.5 and above sense. The bzrlib base class
435
is such a manager, but third party UI factories which do not derive from
436
``bzrlib.ui.UIFactory`` will be incompatible with the command line front
439
* URLs like ``foo:bar/baz`` are now always parsed as a URL with scheme "foo"
440
and path "bar/baz", even if bzr does not recognize "foo" as a known URL
441
scheme. Previously these URLs would be treated as local paths.
448
* Support ``--directory`` option for a number of additional commands:
449
conflicts, merge-directive, missing, resolve, shelve, switch,
450
unshelve, whoami. (Martin von Gagern, #527878)
455
* ``bzr branch`` to a new repository with a default stacking policy no
456
longer transfers the full history unnecessarily.
457
(Andrew Bennetts, #597942)
459
* ``bzr init`` does not recursively scan directory contents anymore
460
leading to faster init for directories with existing content.
461
(Martin [gz], Parth Malwankar, #501307)
463
* ``bzr log --exclude-common-ancestry`` is now taken into account for
464
linear ancetries. (Vincent Ladeuil, #575631)
466
* ``bzr log -r branch:REMOTE`` can now properly log the remote branch,
467
rather than trying to fetch the data locally and failing because of a
468
readonly error. (Martin von Gagern, #149270)
470
* ``bzr pull`` now works when a lp: URL is explicitly defined as the parent
471
or pull location in locations.conf or branch.conf.
472
(Gordon Tyler, #534787)
474
* ``bzr reconfigure --unstacked`` now works with branches accessed via a
475
smart server. (Andrew Bennetts, #551525)
477
* ``BzrDir.find_branches`` should ignore branches with missing repositories.
478
(Marius Kruger, Robert Collins)
480
* ``BzrDir.find_bzrdirs`` should ignore dirs that raises PermissionDenied.
481
(Marius Kruger, Robert Collins)
483
* Ensure that wrong path specifications in ``BZR_PLUGINS_AT`` display
484
proper error messages. (Vincent Ladeuil, #591215)
486
* Explicitly removing ``--profile-imports`` option from parsed command-line
487
arguments on Windows, because bzr script does the same.
488
(Alexander Belchenko, #588277)
490
* Fetching was slightly confused about the best code to use and was
491
using a new code path for all branches, resulting in more lookups than
492
necessary on old branches. (Robert Collins, #593515)
494
* Final fix for 'no help for command' issue. We now show a clean message
495
when a command has no help, document how to set help more clearly, and
496
test that all commands available to the test suite have help.
497
(Robert Collins, #177500)
499
* Invalid patterns supplied to ``Globster`` or ``lazy_regex`` now raise
500
``InvalidPattern`` exception showing clear error message to the user.
501
(Parth Malwankar #300062)
503
* Progress output is cleaned up when exiting. (Aaron Bentley)
505
* Raise ValueError instead of a string exception.
506
(John Arbash Meinel, #586926)
508
* Relative imports in plugins are now handled correctly when using
509
BZR_PLUGINS_AT. (Vincent Ladeuil, #588959)
511
* ``ScriptRunner`` now strips off leading indentation from test scripts,
512
which previously caused "SyntaxError: No command for line".
515
* Show unicode filenames in diff headers using terminal encoding.
516
(Alexander Belchenko, Bug #382699)
517
NOTE for Windows users: If user need to save diff to file then user need to
518
change encoding of the terminal to ANSI encoding with command ``chcp XXX``
519
(e.g. ``chcp 1251`` for Russian Windows).
521
* URL displayed for use with ``break-lock`` when smart server sees lock
522
contention are now valid. Default timeout for lock contention retry is
523
now 30 seconds instead of 300 seconds.
524
(Parth Malwankar, #250451)
526
* ``walkdirs`` now raises a useful message when the filenames are not using
527
the filesystem encoding. (Eric Moritz, #488519)
529
* Enable debugging of bzr on windows with pdb and other tools. This was
530
broken because we call GetCommandLineW on windows. The fix adjusts the
531
command line we get to be the same length as sys.argv.
532
(Jason Spashett, Alexander Belchenko, #587868)
537
* Bazaar now reads data from SSH connections more efficiently on platforms
538
that provide the ``socketpair`` function, and when using paramiko.
539
(Andrew Bennetts, #590637)
541
* ``Branch.copy_content_into`` is now a convenience method dispatching to
542
a ``InterBranch`` multi-method. This permits ``bzr-loom`` and other
543
plugins to intercept this even when a ``RemoteBranch`` proxy is in use.
544
(Robert Collins, #201613)
546
* ``Branch`` formats can now be loaded lazily by registering a
547
``MetaDirBranchFormatFactory`` rather than an actual format. This will
548
cause the named format class to be loaded only when an enumeration of
549
formats is needed or when the format string for the object is
550
encountered. (Robert Collins, Jelmer Vernooij)
552
* The encoding that bzr uses to output things other than file content can
553
now be overridden via the output_encoding configuration option.
554
(Martin Pool, #340394)
556
* Use lazy imports in ``bzrlib/merge.py`` so that plugins like ``news_merge``
557
do not cause modules to be loaded unnecessarily just because the plugin
558
registers a merge hook. This improves ``bzr rocks`` time by about 25%
559
in a default installation (with just the core plugins).
565
* Added ``regression`` tag to our tags list. (Robert Collins)
567
* Improved our release checklist to have a bit less churn and leave things
568
ready-to-go for the next action (including other people doing
569
development). (Robert Collins)
571
* Remove obsolete discussion of PQM in documentation about how to
572
contribute to Bazaar. (Martin Pool, #588444)
577
* ``bzrlib.branch.InterBranch._get_branch_formats_to_test`` now returns
578
an iterable of format pairs, rather than just a single pair, permitting
579
InterBranch objects that work with multiple permutations to be
580
comprehensively tested. (Robert Collins)
582
* ``bzrlib.lsprof.profile`` will no longer silently generate bad threaded
583
profiles when concurrent profile requests are made. Instead the profile
584
requests will be serialised. Reentrant requests will now deadlock.
587
* ``bzrlib.knit.KnitSequenceMatcher``, which has been deprecated since
588
2007, has been deleted. Use ``PatienceSequenceMatcher`` from
589
``bzrlib.patiencediff`` instead. (Andrew Bennetts)
591
* ``bzrlib.re_compile_checked`` is now deprecated. Caller should handle
592
``bzrlib.errors.InvalidPattern`` exception thrown by ``re.match`` in
593
case the default error message not suitable for the use case.
596
* ``bzrlib.tests.blackbox.ExternalBase`` is deprecated. It provided only
597
one method ``check_output``, and we now recommend checking command
598
output using ``run_script``. (Martin Pool)
600
* ``bzrlib.transport.ssh.SSHVendor.connect_ssh`` now returns an object
601
that implements the interface of ``bzrlib.transport.ssh.SSHConnection``.
602
Third-party implementations of ``SSHVendor`` may need to be updated
603
accordingly. Similarly, any code using ``SSHConnection`` directly will
604
need to be updated. (Andrew Bennetts)
606
* The constructor of ``bzrilb.smart.medium.SmartSSHClientMedium`` has
607
changed to take an ``SSHParams`` instance (replacing many individual
608
values). (Andrew Bennetts)
613
* ``bzrlib.osutils.get_terminal_encoding`` will now only mutter its
614
selection when explicitly requested; this avoids many duplicate calls
615
being logged when helpers, wrappers and older code that manually calls
616
it are executed it is now logged deliberately by the ui setup code.
619
* Improved ``bzrlib.urlutils`` to handle lp:foo/bar URLs. (Gordon Tyler)
621
* ``bzrlib._c_static_tuple.StaticTuple`` now implements ``__sizeof__``, so
622
that ``sys.getsizeof`` and other memory analysis tools will report more
623
accurate results. (Andrew Bennetts)
625
* The symbol_versioning module can now cleanup after itself -
626
``suppress_deprecation_warnings`` now returns a cleanup function.
632
* Add ``bzrlib.tests.fixtures`` to hold code for setting up objects
633
to test. (Martin Pool)
635
* ``test_import_tariff`` now respects BZR_PLUGINS_AT and BZR_PLUGINS_DISABLE.
636
(Vincent Ladeuil, #595587)
11
:2.2b3: NOT RELEASED YET
643
This third beta in the 2.2 series brings with it all the goodness of 2.1.2
644
and 2.0.6 (though it preceeds 2.0.6 slightly). Of particular note for
645
users are compatibility fixes with bzr 1.5 and below servers, a hopeful
646
end to the EINTR errors caused by SIGWINCH interactions, a shiny new
647
bash completion script and bzr will no longer guess at identity details -
648
it was too unreliable in reality. Use ``bzr whoami`` on every new install.
649
For developers we have some API changes which may impact plugins as well
650
as a bunch of our regular improvements to internal clarity and test
13
653
Compatibility Breaks
14
654
********************
656
* An API break has been made to the lock_write method of ``Branch`` and
657
``Repository`` objects; they now return ``branch.BranchWriteLockResult``
658
and ``repository.RepositoryWriteLockResult`` objects. This makes
659
changing the API in future easier and permits some cleaner calling code.
660
The lock_read method has also changed from having no defined return
661
value to returning ``LogicalLockResult`` objects.
664
* ``bzr`` does not try to guess the username as ``username@hostname``
665
and requires it to be explictly set. This can be set using ``bzr
666
whoami``. (Parth Malwankar, #549310)
668
* ``bzrlib.commands.Command`` will now raise ValueError during
669
construction if there is no __doc__ set. (Note, this will be reverted in
670
2.2b4) (Robert Collins)
672
* The source tree no longer contains a contrib/zsh/_bzr completion
673
script. The new file contrib/zsh/README suggests alternatives.
674
(Martin von Gagern, #560030)
added
removed
NEWS
