5
Release 0.8 of bzr introduces a new format for history storage, called
6
'knit', as an evolution of to the 'weave' format used in 0.7. Local
7
and remote operations are faster using knits than weaves. Several
8
operations including 'init', 'init-repo', and 'upgrade' take a
9
--format option that controls this. Branching from an existing branch
10
will keep the same format.
12
It is possible to merge, pull and push between branches of different
13
formats but this is slower than moving data between homogenous
14
branches. It is therefore recommended (but not required) that you
15
upgrade all branches for a project at the same time. Information on
16
formats is shown by 'bzr info'.
18
bzr 0.8 now allows creation of 'repositories', which hold the history
19
of files and revisions for several branches. Previously bzr kept all
20
the history for a branch within the .bzr directory at the root of the
21
branch, and this is still the default. To create a repository, use
22
the new 'bzr init-repo' command. Branches exist as directories under
23
the repository and contain just a small amount of information
24
indicating the current revision of the branch.
26
bzr 0.8 also supports 'checkouts', which are similar to in cvs and
27
subversion. Checkouts are associated with a branch (optionally in a
28
repository), which contains all the historical information. The
29
result is that a checkout can be deleted without losing any
30
already-committed revisions. A new 'update' command is also available.
32
Repositories and checkouts are not supported with the 0.7 storage
33
format. To use them you must upgrad to either knits, or to the
34
'metaweave' format, which uses weaves but changes the .bzr directory
40
* Sftp paths can now be relative, or local, according to the lftp
41
convention. Paths now take the form:
42
sftp://user:pass@host:port/~/relative/path
44
sftp://user:pass@host:port/absolute/path
46
* The FTP transport now tries to reconnect after a temporary
47
failure. ftp put is made atomic. (Matthieu Moy)
49
* The FTP transport now maintains a pool of connections, and
50
reuses them to avoid multiple connections to the same host (like
51
sftp did). (Daniel Silverstone)
53
* The bzr_man.py file has been removed. To create the man page now,
54
use ./generate_docs.py man. The new program can also create other files.
55
Run "python generate_docs.py --help" for usage information. (Hans
56
Ulrich Niedermann & James Blackwell).
58
* Man Page now gives full help (James Blackwell). Help also updated to
59
reflect user config now being stored in .bazaar (Hans Ulrich
62
* It's now possible to set aliases in bazaar.conf (Erik Bågfors)
64
* Pull now accepts a --revision argument (Erik Bågfors)
66
* 'bzr re-sign' now allows multiple revisions to be supplied on the command
67
line. You can now use the following command to sign all of your old commits.
68
find .bzr/revision-store// -name my@email-* \
69
| sed 's/.*\/\/..\///' \
72
* Upgrade can now upgrade over the network. (Robert Collins)
74
* Two new commands 'bzr checkout' and 'bzr update' allow for CVS/SVN-alike
75
behaviour. By default they will cache history in the checkout, but
76
with --lightweight almost all data is kept in the master branch.
79
* 'revert' unversions newly-versioned files, instead of deleting them.
81
* 'merge' is more robust. Conflict messages have changed.
83
* 'merge' and 'revert' no longer clobber existing files that end in '~' or
86
* Default log format can be set in configuration and plugins can register
87
their own formatters. (Erik Bågfors)
89
* New 'reconcile' command will check branch consistency and repair indexes
90
that can become out of sync in pre 0.8 formats. (Robert Collins,
93
* New 'bzr init --format' and 'bzr upgrade --format' option to control
94
what storage format is created or produced. (Robert Collins,
97
* Add parent location to 'bzr info', if there is one. (Olaf Conradi)
99
* New developer commands 'weave-list' and 'weave-join'. (Martin Pool)
101
* New 'init-repository' command, plus support for repositories in 'init'
102
and 'branch' (Aaron Bentley, Erik Bågfors, Robert Collins)
104
* Improve output of 'info' command. Show all relevant locations related to
105
working tree, branch and repository. Use kibibytes for binary quantities.
106
Fix off-by-one error in missing revisions of working tree. Make 'info'
107
work on branches, repositories and remote locations. Show locations
108
relative to the shared repository, if applicable. Show locking status
109
of locations. (Olaf Conradi)
111
* Diff and merge now safely handle binary files. (Aaron Bentley)
113
* 'pull' and 'push' now normalise the revision history, so that any two
114
branches with the same tip revision will have the same output from 'log'.
117
* 'merge' accepts --remember option to store parent location, like 'push'
118
and 'pull'. (Olaf Conradi)
120
* bzr status and diff when files given as arguments do not exist
121
in the relevant trees. (Martin Pool, #3619)
123
* Add '.hg' to the default ignore list. (Martin Pool)
125
* 'knit' is now the default disk format. This improves disk performance and
126
utilization, increases incremental pull performance, robustness with SFTP
127
and allows checkouts over SFTP to perform acceptably.
128
The initial Knit code was contributed by Johan Rydberg based on a
129
specification by Martin Pool.
130
(Robert Collins, Aaron Bentley, John Rydberg, Martin Pool).
132
* New tool to generate all-in-one html version of the manual. (Alexander
135
* Hitting CTRL-C while doing an SFTP push will no longer cause stale locks
136
to be left in the SFTP repository. (Robert Collins, Martin Pool).
138
* New option 'diff --prefix' to control how files are named in diff
139
output, with shortcuts '-p0' and '-p1' corresponding to the options for
140
GNU patch. (Alexander Belchenko, Goffredo Baroncelli, Martin Pool)
142
* Add --revision option to 'annotate' command. (Olaf Conradi)
144
* Add --revision option to 'annotate' command. (Olaf Conradi)
146
* If bzr shows an unexpected revision-history after pulling (perhaps due
147
to a reweave) it can now be corrected by 'bzr reconcile'.
152
* Commit is now verbose by default, and shows changed filenames and the
153
new revision number. (Robert Collins, Martin Pool)
155
* Unify 'mv', 'move', 'rename'. (#5379, Matthew Fuller)
157
* 'bzr -h' shows help. (#35940, Martin Pool, Ian Bicking)
159
* Make 'pull' and 'push' remember location on failure using --remember.
162
* For compatibility, make old format for using weaves inside metadir
163
available as 'metaweave' format. Rename format 'metadir' to 'default'.
164
Clean up help for option --format in commands 'init', 'init-repo' and
165
'upgrade'. (Olaf Conradi)
169
* The internal storage of history, and logical branch identity have now
170
been split into Branch, and Repository. The common locking and file
171
management routines are now in bzrlib.lockablefiles.
172
(Aaron Bentley, Robert Collins, Martin Pool)
174
* Transports can now raise DependencyNotPresent if they need a library
175
which is not installed, and then another implementation will be
178
* Remove obsolete (and no-op) `decode` parameter to `Transport.get`.
181
* Using Tree Transform for merge, revert, tree-building
183
* WorkingTree.create, Branch.create, WorkingTree.create_standalone,
184
Branch.initialize are now deprecated. Please see BzrDir.create_* for
185
replacement API's. (Robert Collins)
187
* New BzrDir class represents the .bzr control directory and manages
188
formatting issues. (Robert Collins)
190
* New repository.InterRepository class encapsulates Repository to
191
Repository actions and allows for clean selection of optimised code
192
paths. (Robert Collins)
194
* bzrlib.fetch.fetch and bzrlib.fetch.greedy_fetch are now deprecated,
195
please use 'branch.fetch' or 'repository.fetch' depending on your
196
needs. (Robert Collins)
198
* deprecated methods now have a 'is_deprecated' flag on them that can
199
be checked, if you need to determine whether a given callable is
200
deprecated at runtime. (Robert Collins)
202
* Progress bars are now nested - see
203
bzrlib.ui.ui_factory.nested_progress_bar. (Robert Collins, Robey Pointer)
205
* New API call get_format_description() for each type of format.
208
* Changed branch.set_parent() to accept None to remove parent.
211
* Deprecated BzrError AmbiguousBase. (Olaf Conradi)
213
* WorkingTree.branch is now a read only property. (Robert Collins)
215
* bzrlib.ui.text.TextUIFactory now accepts a bar_type parameter which
216
can be None or a factory that will create a progress bar. This is
217
useful for testing or for overriding the bzrlib.progress heuristic.
220
* New API method get_physical_lock_status() to query locks present on a
221
transport. (Olaf Conradi)
223
* Repository.reconcile now takes a thorough keyword parameter to allow
224
requesting an indepth reconciliation, rather than just a data-loss
225
check. (Robert Collins)
227
* bzrlib.ui.ui_factory protocol now supports 'get_boolean' to prompt
228
the user for yes/no style input. (Robert Collins)
232
* SFTP tests now shortcut the SSH negotiation, reducing test overhead
233
for testing SFTP protocol support. (Robey Pointer)
235
* Branch formats are now tested once per implementation (see bzrlib.
236
tests.branch_implementations. This is analagous to the transport
237
interface tests, and has been followed up with working tree,
238
repository and BzrDir tests. (Robert Collins)
240
* New test base class TestCaseWithTransport provides a transport aware
241
test environment, useful for testing any transport-interface using
242
code. The test suite option --transport controls the transport used
243
by this class (when its not being used as part of implementation
244
contract testing). (Robert Collins)
246
* Close logging handler on disabling the test log. This will remove the
247
handler from the internal list inside python's logging module,
248
preventing shutdown from closing it twice. (Olaf Conradi)
250
* Move test case for uncommit to blackbox tests. (Olaf Conradi)
252
* run_bzr and run_bzr_captured now accept a 'stdin="foo"' parameter which
253
will provide String("foo") to the command as its stdin.
259
* .bzrignore is excluded from exports, on the grounds that it's a bzr
260
internal-use file and may not be wanted. (Jamie Wilkinson)
262
* The "bzr directories" command were removed in favor of the new
263
--kind option to the "bzr inventory" command. To list all
264
versioned directories, now use "bzr inventory --kind directory".
267
* Under Windows configuration directory is now %APPDATA%\bazaar\2.0
268
by default. (John Arbash Meinel)
270
* The parent of Bzr configuration directory can be set by BZR_HOME
271
environment variable. Now the path for it is searched in BZR_HOME, then
272
in HOME. Under Windows the order is: BZR_HOME, APPDATA (usually
273
points to C:\Documents and Settings\User Name\Application Data), HOME.
276
* Plugins with the same name in different directories in the bzr plugin
277
path are no longer loaded: only the first successfully loaded one is
278
used. (Robert Collins)
280
* Use systems' external ssh command to open connections if possible.
281
This gives better integration with user settings such as ProxyCommand.
284
* Permissions on files underneath .bzr/ are inherited from the .bzr
285
directory. So for a shared repository, simply doing 'chmod -R g+w .bzr/'
286
will mean that future file will be created with group write permissions.
288
* configure.in and config.guess are no longer in the builtin default
291
* '.sw[nop]' pattern ignored, to ignore vim swap files for nameless
292
files. (John Arbash Meinel, Martin Pool)
296
* "bzr INIT dir" now initializes the specified directory, and creates
297
it if it does not exist. (John Arbash Meinel)
299
* New remerge command (Aaron Bentley)
301
* Better zsh completion script. (Steve Borho)
303
* 'bzr diff' now returns 1 when there are changes in the working
304
tree. (Robert Collins)
306
* 'bzr push' now exists and can push changes to a remote location.
307
This uses the transport infrastructure, and can store the remote
308
location in the ~/.bazaar/branches.conf configuration file.
311
* Test directories are only kept if the test fails and the user requests
314
* Tweaks to short log printing
316
* Added branch nicks, new nick command, printing them in log output.
319
* If $BZR_PDB is set, pop into the debugger when an uncaught exception
320
occurs. (Martin Pool)
322
* Accept 'bzr resolved' (an alias for 'bzr resolve'), as this is
323
the same as Subversion. (Martin Pool)
325
* New ftp transport support (on ftplib), for ftp:// and aftp://
326
URLs. (Daniel Silverstone)
328
* Commit editor temporary files now start with 'bzr_log.', to allow
329
text editors to match the file name and set up appropriate modes or
330
settings. (Magnus Therning)
332
* Improved performance when integrating changes from a remote weave.
333
(Goffredo Baroncelli)
335
* Sftp will attempt to cache the connection, so it is more likely that
336
a connection will be reused, rather than requiring multiple password
339
* bzr revno now takes an optional argument indicating the branch whose
340
revno should be printed. (Michael Ellerman)
342
* bzr cat defaults to printing the last version of the file.
343
(#3632, Matthieu Moy)
345
* New global option 'bzr --lsprof COMMAND' runs bzr under the lsprof
346
profiler. (Denys Duchier)
348
* Faster commits by reading only the headers of affected weave files.
351
* 'bzr add' now takes a --dry-run parameter which shows you what would be
352
added, but doesn't actually add anything. (Michael Ellerman)
354
* 'bzr add' now lists how many files were ignored per glob. add --verbose
355
lists the specific files. (Aaron Bentley)
357
* 'bzr missing' now supports displaying changes in diverged trees and can
358
be limited to show what either end of the comparison is missing.
359
(Aaron Bently, with a little prompting from Daniel Silverstone)
363
* SFTP can walk up to the root path without index errors. (Robert Collins)
365
* Fix bugs in running bzr with 'python -O'. (Martin Pool)
367
* Error when run with -OO
369
* Fix bug in reporting http errors that don't have an http error code.
372
* Handle more cases of pipe errors in display commands
374
* Change status to 3 for all errors
376
* Files that are added and unlinked before committing are completely
377
ignored by diff and status
379
* Stores with some compressed texts and some uncompressed texts are now
380
able to be used. (John A Meinel)
382
* Fix for bzr pull failing sometimes under windows
384
* Fix for sftp transport under windows when using interactive auth
386
* Show files which are both renamed and modified as such in 'bzr
387
status' output. (#4503, Daniel Silverstone)
389
* Make annotate cope better with revisions committed without a valid
390
email address. (Marien Zwart)
392
* Fix representation of tab characters in commit messages. (Harald
395
* List of plugin directories in BZR_PLUGIN_PATH environment variable is
396
now parsed properly under Windows. (Alexander Belchenko)
398
* Show number of revisions pushed/pulled/merged. (Robey Pointer)
400
* Keep a cached copy of the basis inventory to speed up operations
401
that need to refer to it. (Johan Rydberg, Martin Pool)
403
* Fix bugs in bzr status display of non-ascii characters. (Martin
406
* Remove Makefile.in from default ignore list. (#6413, Tollef Fog
409
* Fix failure in 'bzr added'. (Nathan McCallum, Martin Pool)
413
* Fix selftest asking for passwords when there are no SFTP keys.
414
(Robey Pointer, Jelmer Vernooij)
416
* Fix selftest run with 'python -O'. (Martin Pool)
418
* Fix HTTP tests under Windows. (John Arbash Meinel)
420
* Make tests work even if HOME is not set (Aaron Bentley)
422
* Updated build_tree to use fixed line-endings for tests which read
423
the file cotents and compare. Make some tests use this to pass under
424
Windows. (John Arbash Meinel)
426
* Skip stat and symlink tests under Windows. (Alexander Belchenko)
428
* Delay in selftest/testhashcash is now issued under win32 and Cygwin.
431
* Use terminal width to align verbose test output. (Martin Pool)
433
* Blackbox tests are maintained within the bzrlib.tests.blackbox directory.
434
If adding a new test script please add that to
435
bzrlib.tests.blackbox.__init__. (Robert Collins)
437
* Much better error message if one of the test suites can't be
438
imported. (Martin Pool)
440
* Make check now runs the test suite twice - once with the default locale,
441
and once with all locales forced to C, to expose bugs. This is not
442
trivially done within python, so for now its only triggered by running
443
Make check. Integrators and packagers who wish to check for full
444
platform support should run 'make check' to test the source.
447
* Tests can now run TestSkipped if they can't execute for any reason.
448
(Martin Pool) (NB: TestSkipped should only be raised for correctable
449
reasons - see the wiki spec ImprovingBzrTestSuite).
451
* Test sftp with relative, absolute-in-homedir and absolute-not-in-homedir
452
paths for the transport tests. Introduce blackbox remote sftp tests that
453
test the same permutations. (Robert Collins, Robey Pointer)
455
* Transport implementation tests are now independent of the local file
456
system, which allows tests for esoteric transports, and for features
457
not available in the local file system. They also repeat for variations
458
on the URL scheme that can introduce issues in the transport code,
459
see bzrlib.transport.TransportTestProviderAdapter() for this.
462
* TestCase.build_tree uses the transport interface to build trees, pass
463
in a transport parameter to give it an existing connection.
468
* WorkingTree.pull has been split across Branch and WorkingTree,
469
to allow Branch only pulls. (Robert Collins)
471
* commands.display_command now returns the result of the decorated
472
function. (Robert Collins)
474
* LocationConfig now has a set_user_option(key, value) call to save
475
a setting in its matching location section (a new one is created
476
if needed). (Robert Collins)
478
* Branch has two new methods, get_push_location and set_push_location
479
to respectively, get and set the push location. (Robert Collins)
481
* commands.register_command now takes an optional flag to signal that
482
the registrant is planning to decorate an existing command. When
483
given multiple plugins registering a command is not an error, and
484
the original command class (whether built in or a plugin based one) is
485
returned to the caller. There is a new error 'MustUseDecorated' for
486
signalling when a wrapping command should switch to the original
487
version. (Robert Collins)
489
* Some option parsing errors will raise 'BzrOptionError', allowing
490
granular detection for decorating commands. (Robert Collins).
492
* Branch.read_working_inventory has moved to
493
WorkingTree.read_working_inventory. This necessitated changes to
494
Branch.get_root_id, and a move of Branch.set_inventory to WorkingTree
495
as well. To make it clear that a WorkingTree cannot always be obtained
496
Branch.working_tree() will raise 'errors.NoWorkingTree' if one cannot
497
be obtained. (Robert Collins)
499
* All pending merges operations from Branch are now on WorkingTree.
502
* The follow operations from Branch have moved to WorkingTree:
510
* bzrlib.add.smart_add_branch is now smart_add_tree. (Robert Collins)
512
* New "rio" serialization format, similar to rfc-822. (Martin Pool)
514
* Rename selftests to `bzrlib.tests.test_foo`. (John A Meinel, Martin
517
* bzrlib.plugin.all_plugins has been changed from an attribute to a
518
query method. (Robert Collins)
520
* New options to read only the table-of-contents of a weave.
523
* Raise NoSuchFile when someone tries to add a non-existant file.
526
* Simplify handling of DivergedBranches in cmd_pull().
530
* Branch.controlfile* logic has moved to lockablefiles.LockableFiles, which
531
is exposed as Branch().control_files. Also this has been altered with the
532
controlfile pre/suffix replaced by simple method names like 'get' and
533
'put'. (Aaron Bentley, Robert Collins).
535
* Deprecated functions and methods can now be marked as such using the
536
bzrlib.symbol_versioning module. Marked method have their docstring
537
updated and will issue a DeprecationWarning using the warnings module
538
when they are used. (Robert Collins)
540
* bzrlib.osutils.safe_unicode now exists to provide parameter coercion
541
for functions that need unicode strings. (Robert Collins)
547
* pull now takes --verbose to show you what revisions are added or removed
550
* merge now takes a --show-base option to include the base text in
554
* The config files are now read using ConfigObj, so '=' should be used as
555
a separator, not ':'.
558
5
* New 'bzr commit --strict' option refuses to commit if there are
559
6
any unknown files in the tree. To commit, make sure all files are