BUG FIXES:

• Print a warning instead of aborting the python setup.py install process if building of a C extension is not possible. (Lukáš Lalinský, Alexander Belchenko)
• Fix commit ordering in corner case (Aaron Bentley, #94975)
• Fix ''bzr info bzr://host/'' and other operations on ''bzr://' URLs with an implicit port. We were incorrectly raising PathNotChild due to inconsistent treatment of the ''_port'' attribute on the Transport object. (Andrew Bennetts, #133965)
• Make RemoteRepository.sprout cope gracefully with servers that don't support the Repository.tarball request. (Andrew Bennetts)

• Replaced incorrect tarball for previous release; a debug statement was left in bzrlib/remote.py.

CHANGES:

• The default branch and repository format has changed to dirstate-tags, so tag commands are active by default. This format is compatible with Bazaar 0.15 and later. This incidentally fixes bug #126141. (Martin Pool)
• --quiet or -q is no longer a global option. If present, it must now appear after the command name. Scripts doing things like bzr -q missing need to be rewritten as bzr missing -q. (Ian Clatworthy)

FEATURES:

• New option --author in bzr commit to specify the author of the change, if it's different from the committer. bzr log and bzr annotate display the author instead of the committer. (Lukáš Lalinský)

• In addition to global options and command specific options, a set of standard options are now supported. Standard options are legal for all commands. The initial set of standard options are:

  • --help or -h - display help message
  • --verbose or -v - display additional information
  • --quiet or -q - only output warnings and errors.

  Unlike global options, standard options can be used in aliases and may have command-specific help. (Ian Clatworthy)

• Verbosity level processing has now been unified. If --verbose or -v is specified on the command line multiple times, the verbosity level is made positive the first time then increased. If --quiet or -q is specified on the command line multiple times, the verbosity level is made negative the first time then decreased. To get the default verbosity level of zero, either specify none of the above , --no-verbose or --no-quiet. Note that most commands currently ignore the magnitude of the verbosity level but do respect quiet vs normal vs verbose when generating output. (Ian Clatworthy)

• Branch.hooks now supports pre_commit hook. The hook's signature is documented in BranchHooks constructor. (Nam T. Nguyen, #102747)

BUG FIXES:

• bzr plugins now lists the version number for each plugin in square brackets after the path. (Robert Collins, #125421)
• Pushing, pulling and branching branches with subtree references was not copying the subtree weave, preventing the file graph from being accessed and causing errors in commits in clones. (Robert Collins)
• Suppress warning "integer argument expected, got float" from Paramiko, which sometimes caused false test failures. (Martin Pool)
• Fix bug in bundle 4 that could cause attempts to write data to wrong versionedfile. (Aaron Bentley)
• Diffs generated using "diff -p" no longer break the patch parser. (Aaron Bentley)
• get_transport treats an empty possible_transports list the same as a non- empty one. (Aaron Bentley)
• patch verification for merge directives is reactivated, and works with CRLF and CR files. (Aaron Bentley)
• Accept ..as a path in revision specifiers. This fixes for example "-r branch:..other-branch" on Windows. (Lukáš Lalinský)
• BZR_PLUGIN_PATH may now contain trailing slashes. (Blake Winton, #129299)
• man page no longer lists hidden options (#131667, Aaron Bentley)
• uncommit --help now explains the -r option adequately. (Daniel Watkins, #106726)
• Error messages are now better formatted with parameters (such as filenames) quoted when necessary. This avoids confusion when directory names ending in a '.' at the end of messages were confused with a full stop that may or not have been there. (Daniel Watkins, #129791)
• Fix status FILE -r X..Y. (Lukáš Lalinský)
• If a particular command is an alias, help will show the alias instead of claiming there is no help for said alias. (Daniel Watkins, #133548)
• TreeTransform-based operations, like pull, merge, revert, and branch, now roll back if they encounter an error. (Aaron Bentley, #67699)
• bzr commit now exits cleanly if a character unsupported by the current encoding is used in the commit message. (Daniel Watkins, #116143)
• bzr send uses default values for ranges when only half of an elipsis is specified ("-r..5" or "-r5.."). (#61685, Aaron Bentley)
• Avoid trouble when Windows ssh calls itself 'plink' but no plink binary is present. (Martin Albisetti, #107155)
• bzr remove should remove clean subtrees. Now it will remove (without needing --force) subtrees that contain no files with text changes or modified files. With --force it removes the subtree regardless of text changes or unknown files. Directories with renames in or out (but not changed otherwise) will now be removed without needing --force. Unknown ignored files will be deleted without needing --force. (Marius Kruger, #111665)
• When two plugins conflict, the source of both the losing and now the winning definition is shown. (Konstantin Mikhaylov, #5454)
• When committing to a branch, the location being committed to is displayed. (Daniel Watkins, #52479)
• bzr --version takes care about encoding of stdout, especially when output is redirected. (Alexander Belchenko, #131100)
• Prompt for an ftp password if none is provided. (Vincent Ladeuil, #137044)
• Reuse bound branch associated transport to avoid multiple connections. (Vincent Ladeuil, #128076, #131396)
• Overwrite conflicting tags by push and pull if the --overwrite option is specified. (Lukáš Lalinský, #93947)
• In checkouts, tags are copied into the master branch when created, changed or deleted, and are copied into the checkout when it is updated. (Martin Pool, #93856, #93860)

IMPROVEMENTS:

• Add the option "--show-diff" to the commit command in order to display the diff during the commit log creation. (Goffredo Baroncelli)
• pull and merge are much faster at installing bundle format 4. (Aaron Bentley)
• pull -v no longer includes deltas, making it much faster. (Aaron Bentley)
• send now sends the directive as an attachment by default. (Aaron Bentley, Lukáš Lalinský, Alexander Belchenko)
• Documentation updates (Martin Albisetti)
• Help on debug flags is now included in help global-options. (Daniel Watkins, #124853)
• Parameters passed on the command line are checked to ensure they are supported by the encoding in use. (Daniel Watkins)
• The compression used within the bzr repository has changed from zlib level 9 to the zlib default level. This improves commit performance with only a small increase in space used (and in some cases a reduction in space). (Robert Collins)
• Initial commit no longer SHAs files twice and now reuses the path rather than looking it up again, making it faster. (Ian Clatworthy)
• New option -c/--change for diff and status to show changes in one revision. (Lukáš Lalinský)
• If versioned files match a given ignore pattern, a warning is now given. (Daniel Watkins, #48623)
• bzr status now has -S as a short name for --short and -V as a short name for --versioned. These have been added to assist users migrating from Subversion: bzr status -SV is now like svn status -q. (Daniel Watkins, #115990)
• Added C implementation of PatienceSequenceMatcher, which is about 10x faster than the Python version. This speeds up commands that need file diffing, such as bzr commit or bzr diff. (Lukáš Lalinský)
• HACKING has been extended with a large section on core developer tasks. (Ian Clatworthy)
• Add branches and standalone-trees as online help topics and include them as Concepts within the User Reference. (Paul Moore, Ian Clatworthy)

API BREAKS:

• Branch.append_revision is removed altogether; please use Branch.set_last_revision_info instead. (Martin Pool)
• CommitBuilder now advertises itself as requiring the root entry to be supplied. This only affects foreign repository implementations which reuse CommitBuilder directly and have changed record_entry_contents to require that the root not be supplied. This should be precisely zero plugins affected. (Robert Collins)
• The add_lines methods on VersionedFile implementations has changed its return value to include the sha1 and length of the inserted text. This allows the avoidance of double-sha1 calculations during commit. (Robert Collins)
• Transport.should_cache has been removed. It was not called in the previous release. (Martin Pool)

TESTING:

• Tests may now raise TestNotApplicable to indicate they shouldn't be run in a particular scenario. (Martin Pool)
• New function multiply_tests_from_modules to give a simpler interface to test parameterization. (Martin Pool, Robert Collins)
• Transport.should_cache has been removed. It was not called in the previous release. (Martin Pool)
• NULL_REVISION is returned to indicate the null revision, not None. (Aaron Bentley)
• Use UTF-8 encoded StringIO for log tests to avoid failures on non-ASCII committer names. (Lukáš Lalinský)

INTERNALS:

• bzrlib.plugin.all_plugins has been deprecated in favour of bzrlib.plugin.plugins() which returns PlugIn objects that provide useful functionality for determining the path of a plugin, its tests, and its version information. (Robert Collins)
• Add the option user_encoding to the function 'show_diff_trees()' in order to move the user encoding at the UI level. (Goffredo Baroncelli)
• Add the function make_commit_message_template_encoded() and the function edit_commit_message_encoded() which handle encoded strings. This is done in order to mix the commit messages (which is a unicode string), and the diff which is a raw string. (Goffredo Baroncelli)
• CommitBuilder now defaults to using add_lines_with_ghosts, reducing overhead on non-weave repositories which don't require all parents to be present. (Robert Collins)
• Deprecated method find_previous_heads on bzrlib.inventory.InventoryEntry. This has been superseded by the use of parent_candidates and a separate heads check via the repository API. (Robert Collins)
• New trace function mutter_callsite will print out a subset of the stack to the log, which can be useful for gathering debug details. (Robert Collins)
• bzrlib.pack.ContainerWriter now tracks how many records have been added via a public attribute records_written. (Robert Collins)
• New method bzrlib.transport.Transport.get_recommended_page_size. This provides a hint to users of transports as to the reasonable minimum data to read. In principle this can take latency and bandwidth into account on a per-connection basis, but for now it just has hard coded values based on the url. (e.g. http:// has a large page size, file:// has a small one.) (Robert Collins)
• New method on bzrlib.transport.Transport open_write_stream allows incremental addition of data to a file without requiring that all the data be buffered in memory. (Robert Collins)
• New methods on bzrlib.knit.KnitVersionedFile: get_data_stream(versions), insert_data_stream(stream) and get_format_signature(). These provide some infrastructure for efficiently streaming the knit data for a set of versions over the smart protocol.
• Knits with no annotation cache still produce correct annotations. (Aaron Bentley)
• Three new methods have been added to bzrlib.trace: set_verbosity_level, get_verbosity_level and is_verbose. set_verbosity_level expects a numeric value: negative for quiet, zero for normal, positive for verbose. The size of the number can be used to determine just how quiet or verbose the application should be. The existing be_quiet and is_quiet routines have been integrated into this new scheme. (Ian Clatworthy)
• Options can now be delcared with a custom_callback parameter. If set, this routine is called after the option is processed. This feature is now used by the standard options verbose and quiet so that setting one implicitly resets the other. (Ian Clatworthy)
• Rather than declaring a new option from scratch in order to provide custom help, a centrally registered option can be decorated using the new bzrlib.Option.custom_help routine. In particular, this routine is useful when declaring better help for the verbose and quiet standard options as the base definition of these is now more complex than before thanks to their use of a custom callback. (Ian Clatworthy)

• Tree._iter_changes(specific_file=[]) now iterates through no files, instead of iterating through all files. None is used to iterate through all files. (Aaron Bentley)
• WorkingTree.revert() now accepts None to revert all files. The use of [] to revert all files is deprecated. (Aaron Bentley)

IMPROVEMENTS:

• Documentation is now organized into multiple directories with a level added for different languages or locales. Added the Mini Tutorial and Quick Start Summary (en) documents from the Wiki, improving the content and readability of the former. Formatted NEWS as Release Notes complete with a Table of Conents, one heading per release. Moved the Developer Guide into the main document catalog and provided a link from the developer document catalog back to the main one. (Ian Clatworthy, Sabin Iacob, Alexander Belchenko)

API CHANGES:

• The static convenience method BzrDir.create_repository is deprecated. Callers should instead create a BzrDir instance and call create_repository on that. (Martin Pool)

BUGFIXES:

• bzr init should connect to the remote location one time only. We have been connecting several times because we forget to pass around the Transport object. This modifies BzrDir.create_branch_convenience, so that we can give it the Transport we already have. (John Arbash Meinel, Vincent Ladeuil, #111702)
• Get rid of sftp connection cache (get rid of the FTP one too). (Vincent Ladeuil, #43731)
• bzr branch {local|remote} remote don't try to create a working tree anymore. (Vincent Ladeuil, #112173)
• All identified multiple connections for a single bzr command have been fixed. See bzrlib/tests/commands directory. (Vincent Ladeuil)
• bzr rm now does not insist on --force to delete files that have been renamed but not otherwise modified. (Marius Kruger, #111664)
• bzr selftest --bench no longer emits deprecation warnings (Lukáš Lalinský)
• bzr status now honours FILE parameters for conflict lists (Aaron Bentley, #127606)
• bzr checkout now honours -r when reconstituting a working tree. It also honours -r 0. (Aaron Bentley, #127708)
• bzr add * no more fails on Windows if working tree contains non-ascii file names. (Kuno Meyer, #127361)
• allow easy_install bzr runs without fatal errors. (Alexander Belchenko, #125521)
• Graph._filter_candidate_lca does not raise KeyError if a candidate is eliminated just before it would normally be examined. (Aaron Bentley)
• SMTP connection failures produce a nice message, not a traceback. (Aaron Bentley)

IMPROVEMENTS:

• Don't show "dots" progress indicators when run non-interactively, such as from cron. (Martin Pool)
• info now formats locations more nicely and lists "submit" and "public" branches (Aaron Bentley)
• New pack command that will trigger database compression within the repository (Robert Collins)
• Implement _KnitIndex._load_data in a pyrex extension. The pyrex version is approximately 2-3x faster at parsing a .kndx file. Which yields a measurable improvement for commands which have to read from the repository, such as a 1s => 0.75s improvement in bzr diff when there are changes to be shown. (John Arbash Meinel)
• Merge is now faster. Depending on the scenario, it can be more than 2x faster. (Aaron Bentley)
• Give a clearer warning, and allow python setup.py install to succeed even if pyrex is not available. (John Arbash Meinel)
• DirState._read_dirblocks now has an optional Pyrex implementation. This improves the speed of any command that has to read the entire DirState. (diff, status, etc, improve by about 10%). bisect_dirblocks has also been improved, which helps all _get_entry type calls (whenever we are searching for a particular entry in the in-memory DirState). (John Arbash Meinel)
• bzr pull and bzr push no longer do a complete walk of the branch revision history for ui display unless -v is supplied. (Robert Collins)
• bzr log -rA..B output shifted to the left margin if the log only contains merge revisions. (Kent Gibson)
• The plugins command is now public with improved help. (Ian Clatworthy)
• New bundle and merge directive formats are faster to generate, and
• Annotate merge now works when there are local changes. (Aaron Bentley)
• Commit now only shows the progress in terms of directories instead of entries. (Ian Clatworthy)
• Fix KnitRepository.get_revision_graph to not request the graph 2 times. This makes get_revision_graph 2x faster. (John Arbash Meinel)
• Fix VersionedFile.get_graph() to avoid using set.difference_update(other), which has bad scaling when other is large. This improves VF.get_graph([version_id]) for a 12.5k graph from 2.9s down to 200ms. (John Arbash Meinel)
• The --lsprof-file option now generates output for KCacheGrind if the file starts with callgrind.out. This matches the default file filtering done by KCacheGrind's Open Dialog. (Ian Clatworthy)
• Fix bzr update to avoid an unnecessary branch.get_master_branch call, which avoids 1 extra connection to the remote server. (Partial fix for #128076, John Arbash Meinel)
• Log errors from the smart server in the trace file, to make debugging test failures (and live failures!) easier. (Andrew Bennetts)
• The HTML version of the man page has been superceded by a more comprehensive manual called the Bazaar User Reference. This manual is completed generated from the online help topics. As part of this change, limited reStructuredText is now explicitly supported in help topics and command help with 'unnatural' markup being removed prior to display by the online help or inclusion in the man page. (Ian Clatworthy)
• HTML documentation now use files extension *.html (Alexander Belchenko)
• The cache of ignore definitions is now cleared in WorkingTree.unlock() so that changes to .bzrignore aren't missed. (#129694, Daniel Watkins)
• bzr selftest --strict fails if there are any missing features or expected test failures. (Daniel Watkins, #111914)
• Link to registration survey added to README. (Ian Clatworthy)
• Windows standalone installer show link to registration survey when installation finished. (Alexander Belchenko)

LIBRARY API BREAKS:

• Deprecated dictionary bzrlib.option.SHORT_OPTIONS removed. Options are now required to provide a help string and it must comply with the style guide by being one or more sentences with an initial capital and final period. (Martin Pool)
• KnitIndex.get_parents now returns tuples. (Robert Collins)
• Ancient unused Repository.text_store attribute has been removed. (Robert Collins)
• The bzrlib.pack interface has changed to use tuples of bytestrings rather than just bytestrings, making it easier to represent multiple element names. As this interface was not used by any internal facilities since it was introduced in 0.18 no API compatibility is being preserved. The serialised form of these packs is identical with 0.18 when a single element tuple is in use. (Robert Collins)

INTERNALS:

• merge now uses iter_changes to calculate changes, which makes room for future performance increases. It is also more consistent with other operations that perform comparisons, and reduces reliance on Tree.inventory. (Aaron Bentley)
• Refactoring of transport classes connected to a remote server. ConnectedTransport is a new class that serves as a basis for all transports needing to connect to a remote server. transport.split_url have been deprecated, use the static method on the object instead. URL tests have been refactored too. (Vincent Ladeuil)
• Better connection sharing for ConnectedTransport objects. transport.get_transport() now accepts a 'possible_transports' parameter. If a newly requested transport can share a connection with one of the list, it will. (Vincent Ladeuil)
• Most functions now accept bzrlib.revision.NULL_REVISION to indicate the null revision, and consider using None for this purpose deprecated. (Aaron Bentley)
• New index module with abstract index functionality. This will be used during the planned changes in the repository layer. Currently the index layer provides a graph aware immutable index, a builder for the same index type to allow creating them, and finally a composer for such indices to allow the use of many indices in a single query. The index performance is not optimised, however the API is stable to allow development on top of the index. (Robert Collins)
• bzrlib.dirstate.cmp_by_dirs can be used to compare two paths by their directory sections. This is equivalent to comparing path.split('/'), only without having to split the paths. This has a Pyrex implementation available. (John Arbash Meinel)
• New transport decorator 'unlistable+' which disables the list_dir functionality for testing.
• Deprecated change_entry in transform.py. (Ian Clatworthy)
• RevisionTree.get_weave is now deprecated. Tree.plan_merge is now used for performing annotate-merge. (Aaron Bentley)
• New EmailMessage class to create email messages. (Adeodato Simó)
• Unused functions on the private interface KnitIndex have been removed. (Robert Collins)
• New knit.KnitGraphIndex which provides a KnitIndex layered on top of a index.GraphIndex. (Robert Collins)
• New knit.KnitVersionedFile.iter_parents method that allows querying the parents of many knit nodes at once, reducing round trips to the underlying index. (Robert Collins)
• Graph now has an is_ancestor method, various bits use it. (Aaron Bentley)
• The -Dhpss flag now includes timing information. As well as logging when a new connection is opened. (John Arbash Meinel)
• bzrlib.pack.ContainerWriter now returns an offset, length tuple to callers when inserting data, allowing generation of readv style access during pack creation, without needing a separate pass across the output pack to gather such details. (Robert Collins)
• bzrlib.pack.make_readv_reader allows readv based access to pack files that are stored on a transport. (Robert Collins)
• New Repository.has_same_location method that reports if two repository objects refer to the same repository (although with some risk of false negatives). (Andrew Bennetts)
• InterTree.compare now passes require_versioned on correctly. (Marius Kruger)
• New methods on Repository - start_write_group, commit_write_group, abort_write_group and is_in_write_group - which provide a clean hook point for transactional Repositories - ones where all the data for a fetch or commit needs to be made atomically available in one step. This allows the write lock to remain while making a series of data insertions. (e.g. data conversion). (Robert Collins)
• In bzrlib.knit the internal interface has been altered to use 3-tuples (index, pos, length) rather than two-tuples (pos, length) to describe where data in a knit is, allowing knits to be split into many files. (Robert Collins)
• bzrlib.knit._KnitData split into cache management and physical access with two access classes - _PackAccess and _KnitAccess defined. The former provides access into a .pack file, and the latter provides the current production repository form of .knit files. (Robert Collins)

TESTING:

• Remove selftest --clean-output, --numbered-dirs and --keep-output options, which are obsolete now that tests are done within directories in $TMPDIR. (Martin Pool)
• The SSH_AUTH_SOCK environment variable is now reset to avoid interaction with any running ssh agents. (Jelmer Vernooij, #125955)
• run_bzr_subprocess handles parameters the same way as run_bzr: either a string or a list of strings should be passed as the first parameter. Varargs-style parameters are deprecated. (Aaron Bentley)

BUGFIXES:

• Fix 'bzr add' crash under Win32 (Kuno Meyer)

BUGFIXES:

• Do not suppress pipe errors, etc. in non-display commands (Alexander Belchenko, #87178)
• Display a useful error message when the user requests to annotate a file that is not present in the specified revision. (James Westby, #122656)
• Commands that use status flags now have a reference to 'help status-flags'. (Daniel Watkins, #113436)
• Work around python-2.4.1 inhability to correctly parse the authentication header. (Vincent Ladeuil, #121889)
• Use exact encoding for merge directives. (Adeodato Simó, #120591)
• Fix tempfile permissions error in smart server tar bundling under Windows. (Martin _, #119330)
• Fix detection of directory entries in the inventory. (James Westby)
• Fix handling of http code 400: Bad Request When issuing too many ranges. (Vincent Ladeuil, #115209)
• Issue a CONNECT request when connecting to an https server via a proxy to enable SSL tunneling. (Vincent Ladeuil, #120678)
• Fix bzr log -r to support selecting merge revisions, both individually and as part of revision ranges. (Kent Gibson, #4663)
• Don't leave cruft behind when failing to acquire a lockdir. (Martin Pool, #109169)
• Don't use the '-f' strace option during tests. (Vincent Ladeuil, #102019).
• Warn when setting push_location to a value that will be masked by locations.conf. (Aaron Bentley, #122286)
• Fix commit ordering in corner case (Aaron Bentley, #94975)
• Make annotate behave in a non-ASCII world (Adeodato Simó).

IMPROVEMENTS:

• The --lsprof-file option now dumps a text rendering of the profiling information if the filename ends in ".txt". It will also convert the profiling information to a format suitable for KCacheGrind if the output filename ends in ".callgrind". Fixes to the lsprofcalltree conversion process by Jean Paul Calderone and Itamar were also merged. See http://ddaa.net/blog/python/lsprof-calltree. (Ian Clatworthy)

• info now defaults to non-verbose mode, displaying only paths and abbreviated format info. info -v displays all the information formerly displayed by info. (Aaron Bentley, Adeodato Simó)

• bzr missing now has better option names --this and --other. (Elliot Murphy)

• The internal weave-list command has become versionedfile-list, and now lists knits as well as weaves. (Aaron Bentley)

• Automatic merge base selection uses a faster algorithm that chooses better bases in criss-cross merge situations (Aaron Bentley)

• Progress reporting in commit has been improved. The various logical stages are now reported on as follows, namely:

  • Collecting changes [Entry x/y] - Stage n/m
  • Saving data locally - Stage n/m
  • Uploading data to master branch - Stage n/m
  • Updating the working tree - Stage n/m
  • Running post commit hooks - Stage n/m

  If there is no master branch, the 3rd stage is omitted and the total number of stages is adjusted accordingly.

  Each hook that is run after commit is listed with a name (as hooks can be slow it is useful feedback). (Ian Clatworthy, Robert Collins)

• Various operations that are now faster due to avoiding unnecessary topological sorts. (Aaron Bentley)

• Make merge directives robust against broken bundles. (Aaron Bentley)

• The lsprof filename note is emitted via trace.note(), not standard output. (Aaron Bentley)

• bzrlib now exports explicit API compatibility information to assist library users and plugins. See the bzrlib.api module for details. (Robert Collins)

• Remove unnecessary lock probes when acquiring a lockdir. (Martin Pool)

• bzr --version now shows the location of the bzr log file, which is especially useful on Windows. (Martin Pool)

• -D now supports hooks to get debug tracing of hooks (though its currently minimal in nature). (Robert Collins)

• Long log format reports deltas on merge revisions. (John Arbash Meinel, Kent Gibson)

• Make initial push over ftp more resilient. (John Arbash Meinel)

• Print a summary of changes for update just like pull does. (Daniel Watkins, #113990)

• Add a -Dhpss option to trace smart protocol requests and responses. (Andrew Bennetts)

LIBRARY API BREAKS:

• Testing cleanups - bzrlib.repository.RepositoryTestProviderAdapter has been moved to bzrlib.tests.repository_implementations; bzrlib.repository.InterRepositoryTestProviderAdapter has been moved to bzrlib.tests.interrepository_implementations; bzrlib.transport.TransportTestProviderAdapter has moved to bzrlib.tests.test_transport_implementations. bzrlib.branch.BranchTestProviderAdapter has moved to bzrlib.tests.branch_implementations. bzrlib.bzrdir.BzrDirTestProviderAdapter has moved to bzrlib.tests.bzrdir_implementations. bzrlib.versionedfile.InterVersionedFileTestProviderAdapter has moved to bzrlib.tests.interversionedfile_implementations. bzrlib.store.revision.RevisionStoreTestProviderAdapter has moved to bzrlib.tests.revisionstore_implementations. bzrlib.workingtree.WorkingTreeTestProviderAdapter has moved to bzrlib.tests.workingtree_implementations. These changes are an API break in the testing infrastructure only. (Robert Collins)
• Relocate TestCaseWithRepository to be more central. (Robert Collins)
• bzrlib.add.smart_add_tree will no longer perform glob expansion on win32. Callers of the function should do this and use the new MutableTree.smart_add method instead. (Robert Collins)
• bzrlib.add.glob_expand_for_win32 is now bzrlib.win32utils.glob_expand. (Robert Collins)
• bzrlib.add.FastPath is now private and moved to bzrlib.mutabletree._FastPath. (Robert Collins, Martin Pool)
• LockDir.wait removed. (Martin Pool)
• The SmartServer hooks API has changed for the server_started and server_stopped hooks. The first parameter is now an iterable of backing URLs rather than a single URL. This is to reflect that many URLs may map to the external URL of the server. E.g. the server interally may have a chrooted URL but also the local file:// URL will be at the same location. (Robert Collins)

INTERNALS:

• New SMTPConnection class to unify email handling. (Adeodato Simó)
• Fix documentation of BzrError. (Adeodato Simó)
• Make BzrBadParameter an internal error. (Adeodato Simó)
• Remove use of 'assert False' to raise an exception unconditionally. (Martin Pool)
• Give a cleaner error when failing to decode knit index entry. (Martin Pool)
• TreeConfig would mistakenly search the top level when asked for options from a section. It now respects the section argument and only searches the specified section. (James Westby)
• Improve make api-docs output. (John Arbash Meinel)
• Use os.lstat rather than os.stat for osutils.make_readonly and osutils.make_writeable. This makes the difftools plugin more robust when dangling symlinks are found. (Elliot Murphy)
• New -Dlock option to log (to ~/.bzr.log) information on when lockdirs are taken or released. (Martin Pool)
• bzrlib Hooks are now nameable using Hooks.name_hook. This allows a nicer UI when hooks are running as the current hook can be displayed. (Robert Collins)
• Transport.get has had its interface made more clear for ease of use. Retrieval of a directory must now fail with either 'PathError' at open time, or raise 'ReadError' on a read. (Robert Collins)
• New method _maybe_expand_globs on the Command class for dealing with unexpanded glob lists - e.g. on the win32 platform. This was moved from bzrlib.add._prepare_file_list. (Robert Collins)
• bzrlib.add.smart_add and bzrlib.add.smart_add_tree are now deprecated in favour of MutableTree.smart_add. (Robert Collins, Martin Pool)
• New method external_url on Transport for obtaining the url to hand to external processes. (Robert Collins)
• Teach windows installers to build pyrex/C extensions. (Alexander Belchenko)

TESTING:

• Removed the --keep-output option from selftest and clean up test directories as they're used. This reduces the IO load from running the test suite and cuts the time by about half. (Andrew Bennetts, Martin Pool)
• Add scenarios as a public attribute on the TestAdapter classes to allow modification of the generated scenarios before adaption and easier testing. (Robert Collins)
• New testing support class TestScenarioApplier which multiplies out a single teste by a list of supplied scenarios. (RobertCollins)
• Setting repository_to_test_repository on a repository_implementations test will cause it to be called during repository creation, allowing the testing of repository classes which are not based around the Format concept. For example a repository adapter can be tested in this manner, by altering the repository scenarios to include a scenario that sets this attribute during the test parameterisation in bzrlib.tests.repository.repository_implementations. (Robert Collins)
• Clean up many of the APIs for blackbox testing of Bazaar. The standard interface is now self.run_bzr. The command to run can be passed as either a list of parameters, a string containing the command line, or (deprecated) varargs parameters. (Martin Pool)
• The base TestCase now isolates tests from -D parameters by clearing debug.debug_flags and restores it afterwards. (Robert Collins)
• Add a relpath parameter to get_transport methods in test framework to avoid useless cloning. (Vincent Ladeuil, #110448)

BUGFIXES:

• Fix crash of commit due to wrong lookup of filesystem encoding. (Colin Watson, #120647)
• Revert logging just to stderr in commit as broke unicode filenames. (Aaron Bentley, Ian Clatworthy, #120930)

NOTES WHEN UPGRADING:

• The kind() and is_executable() APIs on the WorkingTree interface no longer implicitly (read) locks and unlocks the tree. This might impact some plug-ins and tools using this part of the API. If you find an issue that may be caused by this change, please let us know, particularly the plug-in/tool maintainer. If encountered, the API fix is to surround kind() and is_executable() calls with lock_read() and unlock() like so:

  work_tree.lock_read()
  try:
      kind = work_tree.kind(...)
  finally:
      work_tree.unlock()
  

INTERNALS:

• Rework of LogFormatter API to provide beginning/end of log hooks and to encapsulate the details of the revision to be logged in a LogRevision object. In long log formats, merge revision ids are only shown when --show-ids is specified, and are labelled "revision-id:", as per mainline revisions, instead of "merged:". (Kent Gibson)
• New BranchBuilder API which allows the construction of particular histories quickly. Useful for testing and potentially other applications too. (Robert Collins)

IMPROVEMENTS:

• There are two new help topics, working-trees and repositories that attempt to explain these concepts. (James Westby, John Arbash Meinel, Aaron Bentley)
• Added bzr log --limit to report a limited number of revisions. (Kent Gibson, #3659)
• Revert does not try to preserve file contents that were originally produced by reverting to a historical revision. (Aaron Bentley)
• bzr log --short now includes [merge] for revisions which have more than one parent. This is a small improvement to help understanding what changes have occurred (John Arbash Meinel, #83887)
• TreeTransform avoids many renames when contructing large trees, improving speed. 3.25x speedups have been observed for construction of kernel-sized-trees, and checkouts are 1.28x faster. (Aaron Bentley)
• Commit on large trees is now faster. In my environment, a commit of a small change to the Mozilla tree (55k files) has dropped from 66 seconds to 32 seconds. For a small tree of 600 files, commit of a small change is 33% faster. (Ian Clatworthy)
• New --create-prefix option to bzr init, like for push. (Daniel Watkins, #56322)

BUGFIXES:

• bzr push should only connect to the remote location one time. We have been connecting 3 times because we forget to pass around the Transport object. This adds BzrDir.clone_on_transport(), so that we can pass in the Transport that we already have. (John Arbash Meinel, #75721)
• DirState.set_state_from_inventory() needs to properly order based on split paths, not just string paths. (John Arbash Meinel, #115947)
• Let TestUIFactoy encode the password prompt with its own stdout. (Vincent Ladeuil, #110204)
• pycurl should take use the range header that takes the range hint into account. (Vincent Ladeuil, #112719)
• WorkingTree4.get_file_sha1 no longer raises an exception when invoked on a missing file. (Aaron Bentley, #118186)
• WorkingTree.remove works correctly with tree references, and when pwd is not the tree root. (Aaron Bentley)
• Merge no longer fails when a file is renamed in one tree and deleted in the other. (Aaron Bentley, #110279)
• revision-info now accepts dotted revnos, doesn't require a tree, and defaults to the last revision (Matthew Fuller, #90048)
• Tests no longer fail when BZR_REMOTE_PATH is set in the environment. (Daniel Watkins, #111958)
• bzr branch -r revid:foo can be used to branch any revision in your repository. (Previously Branch6 only supported revisions in your mainline). (John Arbash Meinel, #115343)

BUGFIXES:

• Handle when you have 2 directories with similar names, but one has a hyphen. ('abc' versus 'abc-2'). The WT4._iter_changes iterator was using direct comparison and 'abc/a' sorts after 'abc-2', but ('abc', 'a') sorts before ('abc-2',). (John Arbash Meinel, #111227)
• Handle when someone renames a file on disk without telling bzr. Previously we would report the first file as missing, but not show the new unknown file. (John Arbash Meinel, #111288)
• Avoid error when running hooks after pulling into or pushing from a branch bound to a smartserver branch. (Martin Pool, #111968)

IMPROVEMENTS:

• Move developer documentation to doc/developers/. This reduces clutter in the root of the source tree and allows HACKING to be split into multiple files. (Robert Collins, Alexander Belchenko)
• Clean up the WorkingTree4._iter_changes() internal loops as well as DirState.update_entry(). This optimizes the core logic for bzr diff and bzr status significantly improving the speed of both. (John Arbash Meinel)

BUGFIXES:

• Handle the case when you delete a file, and then rename another file on top of it. Also handle the case of bzr rm --keep foo. bzr status should show the removed file and an unknown file in its place. (John Arbash Meinel, #109993)
• Bundles properly read and write revision properties that have an empty value. And when the value is not ASCII. (John Arbash Meinel, #109613)
• Fix the bzr commit message to be in text mode. (Alexander Belchenko, #110901)
• Also handle when you rename a file and create a file where it used to be. (John Arbash Meinel, #110256)
• WorkingTree4._iter_changes should not descend into unversioned directories. (John Arbash Meinel, #110399)

NOTES WHEN UPGRADING:

• bzr remove and bzr rm will now remove the working file, if it could be recovered again. This has been done for consistency with svn and the unix rm command. The old remove behaviour has been retained in the new option bzr remove --keep, which will just stop versioning the file, but not delete it. bzr remove --force have been added which will always delete the files. bzr remove is also more verbose. (Marius Kruger, #82602)

IMPROVEMENTS:

• Merge directives can now be supplied as input to merge and pull, like bundles can. (Aaron Bentley)
• Sending the SIGQUIT signal to bzr, which can be done on Unix by pressing Control-Backslash, drops bzr into a debugger. Type 'c' to continue. This can be disabled by setting the environment variable BZR_SIGQUIT_PDB=0. (Martin Pool)
• selftest now supports --list-only to list tests instead of running them. (Ian Clatworthy)
• selftest now supports --exclude PATTERN (or -x PATTERN) to exclude tests with names that match that regular expression. (Ian Clatworthy, #102679)
• selftest now supports --randomize SEED to run tests in a random order. SEED is typically the value 'now' meaning 'use the current time'. (Ian Clatworthy, #102686)
• New option --fixes to commit, which stores bug fixing annotations as revision properties. Built-in support for Launchpad, Debian, Trac and Bugzilla bug trackers. (Jonathan Lange, James Henstridge, Robert Collins)
• New API, bzrlib.bugtracker.tracker_registry, for adding support for other bug trackers to fixes. (Jonathan Lange, James Henstridge, Robert Collins)
• selftest has new short options -f and -1. (Martin Pool)
• bzrlib.tsort.MergeSorter optimizations. Change the inner loop into using local variables instead of going through self._var. Improves the time to merge_sort a 10k revision graph by approximately 40% (~700->400ms). (John Arbash Meinel)
• make docs now creates a man page at man1/bzr.1 fixing bug 107388. (Robert Collins)
• bzr help now provides cross references to other help topics using the _see_also facility on command classes. Likewise the bzr_man documentation, and the bzr.1 man page also include this information. (Robert Collins)
• Tags are now included in logs, that use the long log formatter. (Erik Bågfors, Alexander Belchenko)
• bzr help provides a clearer message when a help topic cannot be found. (Robert Collins, #107656)
• bzr help now accepts optional prefixes for command help. The help for all commands can now be found at bzr help commands/COMMANDNAME as well as bzr help COMMANDNAME (which only works for commands where the name is not the same as a more general help topic). (Robert Collins)
• bzr help PLUGINNAME will now return the module docstring from the plugin PLUGINNAME. (Robert Collins, #50408)
• New help topic urlspec which lists the availables transports. (Goffredo Baroncelli)
• doc/server.txt updated to document the default bzr:// port and also update the blurb about the hpss' current status. (Robert Collins, #107125).
• bzr serve now listens on interface 0.0.0.0 by default, making it serve out to the local LAN (and anyone in the world that can reach the machine running bzr serve. (Robert Collins, #98918)
• A new smart server protocol version has been added. It prefixes requests and responses with an explicit version identifier so that future protocol revisions can be dealt with gracefully. (Andrew Bennetts, Robert Collins)
• The bzr protocol version 2 indicates success or failure in every response without depending on particular commands encoding that consistently, allowing future client refactorings to be much more robust about error handling. (Robert Collins, Martin Pool, Andrew Bennetts)
• The smart protocol over HTTP client has been changed to always post to the same .bzr/smart URL under the original location when it can. This allows HTTP servers to only have to pass URLs ending in .bzr/smart to the smart server handler, and not arbitrary .bzr/*/smart URLs. (Andrew Bennetts)
• digest authentication is now supported for proxies and HTTP by the urllib based http implementation. Tested against Apache 2.0.55 and Squid 2.6.5. Basic and digest authentication are handled coherently for HTTP and proxy: if the user is provided in the url (bzr command line for HTTP, proxy environment variables for proxies), the password is prompted for (only once). If the password is provided, it is taken into account. Once the first authentication is successful, all further authentication roundtrips are avoided by preventively setting the right authentication header(s). (Vincent Ladeuil).

INTERNALS:

• bzrlib API compatability with 0.8 has been dropped, cleaning up some code paths. (Robert Collins)
• Change the format of chroot urls so that they can be safely manipulated by generic url utilities without causing the resulting urls to have escaped the chroot. A side effect of this is that creating a chroot requires an explicit action using a ChrootServer. (Robert Collins, Andrew Bennetts)
• Deprecate Branch.get_root_id() because branches don't have root ids, rather than fixing bug #96847. (Aaron Bentley)
• WorkingTree.apply_inventory_delta provides a better alternative to WorkingTree._write_inventory. (Aaron Bentley)
• Convenience method TestCase.expectFailure ensures that known failures do not silently pass. (Aaron Bentley)
• Transport.local_abspath now raises NotLocalUrl rather than TransportNotPossible. (Martin Pool, Ian Clatworthy)
• New SmartServer hooks facility. There are two initial hooks documented in bzrlib.transport.smart.SmartServerHooks. The two initial hooks allow plugins to execute code upon server startup and shutdown. (Robert Collins).
• SmartServer in standalone mode will now close its listening socket when it stops, rather than waiting for garbage collection. This primarily fixes test suite hangs when a test tries to connect to a shutdown server. It may also help improve behaviour when dealing with a server running on a specific port (rather than dynamically assigned ports). (Robert Collins)
• Move most SmartServer code into a new package, bzrlib/smart. bzrlib/transport/remote.py contains just the Transport classes that used to be in bzrlib/transport/smart.py. (Andrew Bennetts)
• urllib http implementation avoid roundtrips associated with 401 (and 407) errors once the authentication succeeds. (Vincent Ladeuil).
• urlib http now supports querying the user for a proxy password if needed. Realm is shown in the prompt for both HTTP and proxy authentication when the user is required to type a password. (Vincent Ladeuil).
• Renamed SmartTransport (and subclasses like SmartTCPTransport) to RemoteTransport (and subclasses to RemoteTCPTransport, etc). This is more consistent with its new home in bzrlib/transport/remote.py, and because it's not really a "smart" transport, just one that does file operations via remote procedure calls. (Andrew Bennetts)
• The lock_write method of LockableFiles, Repository and Branch now accept a token keyword argument, so that separate instances of those objects can share a lock if it has the right token. (Andrew Bennetts, Robert Collins)
• New method get_branch_reference on BzrDir allows the detection of branch references - which the smart server component needs.
• The Repository API make_working_trees is now permitted to return False when set_make_working_trees is not implemented - previously an unimplemented set_make_working_trees implied the result True from make_working_trees. This has been changed to accomodate the smart server, where it does not make sense (at this point) to ever make working trees by default. (Robert Collins)
• Command objects can now declare related help topics by having _see_also set to a list of related topic. (Robert Collins)
• bzrlib.help now delegates to the Command class for Command specific help. (Robert Collins)
• New class TransportListRegistry, derived from the Registry class, which simplifies tracking the available Transports. (Goffredo Baroncelli)
• New function Branch.get_revision_id_to_revno_map which will return a dictionary mapping revision ids to dotted revnos. Since dotted revnos are defined in the context of the branch tip, it makes sense to generate them from a Branch object. (John Arbash Meinel)
• Fix the 'Unprintable error' message display to use the repr of the exception that prevented printing the error because the str value for it is often not useful in debugging (e.g. KeyError('foo') has a str() of 'foo' but a repr of 'KeyError('foo')' which is much more useful. (Robert Collins)
• urlutils.normalize_url now unescapes unreserved characters, such as "~". (Andrew Bennetts)

BUGFIXES:

• Don't fail bundle selftest if email has 'two' embedded. (Ian Clatworthy, #98510)
• Remove --verbose from bzr bundle. It didn't work anyway. (Robert Widhopf-Fenk, #98591)
• Remove --basis from the checkout/branch commands - it didn't work properly and is no longer beneficial. (Robert Collins, #53675, #43486)
• Don't produce encoding error when adding duplicate files. (Aaron Bentley)
• Fix bzr log <file> so it only logs the revisions that changed the file, and does it faster. (Kent Gibson, John Arbash Meinel, #51980, #69477)
• Fix InterDirstateTre._iter_changes to handle when we come across an empty versioned directory, which now has files in it. (John Arbash Meinel, #104257)
• Teach common_ancestor to shortcut when the tip of one branch is inside the ancestry of the other. Saves a lot of graph processing (with an ancestry of 16k revisions, bzr merge ../already-merged changes from 2m10s to 13s). (John Arbash Meinel, #103757)
• Fix show_diff_trees to handle the case when a file is modified, and the containing directory is renamed. (The file path is different in this versus base, but it isn't marked as a rename). (John Arbash Meinel, #103870)
• FTP now works even when the FTP server does not support atomic rename. (Aaron Bentley, #89436)
• Correct handling in bundles and merge directives of timezones with that are not an integer number of hours offset from UTC. Always represent the epoch time in UTC to avoid problems with formatting earlier times on win32. (Martin Pool, Alexander Belchenko, John Arbash Meinel)
• Typo in the help for register-branch fixed. (Robert Collins, #96770)
• "dirstate" and "dirstate-tags" formats now produce branches compatible with old versions of bzr. (Aaron Bentley, #107168))
• Handle moving a directory when children have been added, removed, and renamed. (John Arbash Meinel, #105479)
• Don't preventively use basic authentication for proxy before receiving a 407 error. Otherwise people willing to use other authentication schemes may expose their password in the clear (or nearly). This add one roundtrip in case basic authentication should be used, but plug the security hole. (Vincent Ladeuil)
• Handle http and proxy digest authentication. (Vincent Ladeuil, #94034).

TESTING:

• Added bzrlib.strace.strace which will strace a single callable and return a StraceResult object which contains just the syscalls involved in running it. (Robert Collins)
• New test method reduceLockdirTimeout to drop the default (ui-centric) default time down to one suitable for tests. (Andrew Bennetts)
• Add new vfs_transport_factory attribute on tests which provides the common vfs backing for both the readonly and readwrite transports. This allows the RemoteObject tests to back onto local disk or memory, and use the existing transport_server attribute all tests know about to be the smart server transport. This in turn allows tests to differentiate between 'transport to access the branch', and 'transport which is a VFS' - which matters in Remote* tests. (Robert Collins, Andrew Bennetts)
• The make_branch_and_tree method for tests will now create a lightweight checkout for the tree if the vfs_transport_factory is not a LocalURLServer. (Robert Collins, Andrew Bennetts)
• Branch implementation tests have been audited to ensure that all urls passed to Branch APIs use proper urls, except when local-disk paths are intended. This is so that tests correctly access the test transport which is often not equivalent to local disk in Remote* tests. As part of this many tests were adjusted to remove dependencies on local disk access. (Robert Collins, Andrew Bennetts)
• Mark bzrlib.tests and bzrlib.tests.TestUtil as providing assertFOO helper functions by adding a __unittest global attribute. (Robert Collins, Andrew Bennetts, Martin Pool, Jonathan Lange)
• Refactored proxy and authentication handling to simplify the implementation of new auth schemes for both http and proxy. (Vincent Ladeuil)

BUGFIXES:

• Handle incompatible repositories as a user issue when fetching. (Aaron Bentley)
• Don't give a recommendation to upgrade when branching or checking out a branch that contains an old-format working tree. (Martin Pool)

CHANGES:

• A warning is now displayed when opening working trees in older formats, to encourage people to upgrade to WorkingTreeFormat4. (Martin Pool)

IMPROVEMENTS:

• HTTP redirections are now taken into account when a branch (or a bundle) is accessed for the first time. A message is issued at each redirection to inform the user. In the past, http redirections were silently followed for each request which significantly degraded the performances. The http redirections are not followed anymore by default, instead a RedirectRequested exception is raised. For bzrlib users needing to follow http redirections anyway, bzrlib.transport.do_catching_redirections provide an easy transition path. (vila)

INTERNALS:

• Added ReadLock.temporary_write_lock() to allow upgrading an OS read lock to an OS write lock. Linux can do this without unlocking, Win32 needs to unlock in between. (John Arbash Meinel)
• New parameter recommend_upgrade to BzrDir.open_workingtree to silence (when false) warnings about opening old formats. (Martin Pool)
• Fix minor performance regression with bzr-0.15 on pre-dirstate trees. (We were reading the working inventory too many times). (John Arbash Meinel)
• Remove Branch.get_transaction() in favour of a simple cache of revision_history. Branch subclasses should override _gen_revision_history rather than revision_history to make use of this cache, and call _clear_revision_history_cache and _cache_revision_history at appropriate times. (Andrew Bennetts)

BUGFIXES:

• Take smtp_server from user config into account. (vila, #92195)
• Restore Unicode filename handling for versioned and unversioned files. (John Arbash Meinel, #92608)
• Don't fail during bzr commit if a file is marked removed, and the containing directory is auto-removed. (John Arbash Meinel, #93681)
• bzr status FILENAME failed on Windows because of an uncommon errno. (ERROR_DIRECTORY == 267 != ENOTDIR). (Wouter van Heyst, John Arbash Meinel, #90819)
• bzr checkout source should create a local branch in the same format as source. (John Arbash Meinel, #93854)
• bzr commit with a kind change was failing to update the last-changed-revision for directories. The InventoryDirectory._unchanged only looked at the parent_id and name, ignoring the fact that the kind could have changed, too. (John Arbash Meinel, #90111)
• bzr mv dir/subdir other was incorrectly updating files inside the directory. So that there was a chance it would break commit, etc. (John Arbash Meinel, #94037)
• Correctly handles mutiple permanent http redirections. (vila, #88780)

NOTES WHEN UPGRADING:

• Release 0.15rc2 of bzr changes the bzr init-repo command to default to --trees instead of --no-trees. Existing shared repositories are not affected.

IMPROVEMENTS:

• New merge-directive command to generate machine- and human-readable merge requests. (Aaron Bentley)
• New submit: revision specifier makes it easy to diff against the common ancestor with the submit location (Aaron Bentley)
• Added support for Putty's SSH implementation. (Dmitry Vasiliev)
• Added bzr status --versioned to report only versioned files, not unknowns. (Kent Gibson)
• Merge now autodetects the correct line-ending style for its conflict markers. (Aaron Bentley)

INTERNALS:

• Refactored SSH vendor registration into SSHVendorManager class. (Dmitry Vasiliev)

BUGFIXES:

• New --numbered-dirs option to bzr selftest to use numbered dirs for TestCaseInTempDir. This is default behavior on Windows. Anyone can force named dirs on Windows with --no-numbered-dirs. (Alexander Belchenko)
• Fix RevisionSpec_revid to handle the Unicode strings passed in from the command line. (Marien Zwart, #90501)
• Fix TreeTransform._iter_changes when both the source and destination are missing. (Aaron Bentley, #88842)
• Fix commit of merges with symlinks in dirstate trees. (Marien Zwart)
• Switch the bzr init-repo default from --no-trees to --trees. (Wouter van Heyst, #53483)

SURPRISES:

• The default disk format has changed. Please run 'bzr upgrade' in your working trees to upgrade. This new default is compatible for network operations, but not for local operations. That is, if you have two versions of bzr installed locally, after upgrading you can only use the bzr 0.15 version. This new default does not enable tags or nested-trees as they are incompatible with bzr versions before 0.15 over the network.
• For users of bzrlib: Two major changes have been made to the working tree api in bzrlib. The first is that many methods and attributes, including the inventory attribute, are no longer valid for use until one of lock_read/lock_write/lock_tree_write has been called, and become invalid again after unlock is called. This has been done to improve performance and correctness as part of the dirstate development. (Robert Collins, John A Meinel, Martin Pool, and others).
• For users of bzrlib: The attribute 'tree.inventory' should be considered readonly. Previously it was possible to directly alter this attribute, or its contents, and have the tree notice this. This has been made unsupported - it may work in some tree formats, but in the newer dirstate format such actions will have no effect and will be ignored, or even cause assertions. All operations possible can still be carried out by a combination of the tree API, and the bzrlib.transform API. (Robert Collins, John A Meinel, Martin Pool, and others).

IMPROVEMENTS:

• Support for OS Windows 98. Also .bzr.log on any windows system saved in My Documents folder. (Alexander Belchenko)
• bzr mv enhanced to support already moved files. In the past the mv command would have failed if the source file doesn't exist. In this situation bzr mv would now detect that the file has already moved and update the repository accordingly, if the target file does exist. A new option --after has been added so that if two files already exist, you could notify Bazaar that you have moved a (versioned) file and replaced it with another. Thus in this case bzr move --after will only update the Bazaar identifier. (Steffen Eichenberg, Marius Kruger)
• ls now works on treeless branches and remote branches. (Aaron Bentley)
• bzr help global-options describes the global options. (Aaron Bentley)
• bzr pull --overwrite will now correctly overwrite checkouts. (Robert Collins)
• Files are now allowed to change kind (e.g. from file to symlink). Supported by commit, revert and status (Aaron Bentley)
• inventory and unknowns hidden in favour of ls (Aaron Bentley)
• bzr help checkouts descibes what checkouts are and some possible uses of them. (James Westby, Aaron Bentley)
• A new -d option to push, pull and merge overrides the default directory. (Martin Pool)
• Branch format 6: smaller, and potentially faster than format 5. Supports append_history_only mode, where the log view and revnos do not change, except by being added to. Stores policy settings in ".bzr/branch/branch.conf".
• append_only branches: Format 6 branches may be configured so that log view and revnos are always consistent. Either create the branch using "bzr init --append-revisions-only" or edit the config file as descriped in docs/configuration.txt.
• rebind: Format 6 branches retain the last-used bind location, so if you "bzr unbind", you can "bzr bind" to bind to the previously-selected bind location.
• Builtin tags support, created and deleted by the tag command and stored in the branch. Tags can be accessed with the revisionspec -rtag:, and listed with bzr tags. Tags are not versioned at present. Tags require a network incompatible upgrade. To perform this upgrade, run bzr upgrade --dirstate-tags in your branch and repositories. (Martin Pool)
• The bzr:// transport now has a well-known port number, 4155, which it will use by default. (Andrew Bennetts, Martin Pool)
• Bazaar now looks for user-installed plugins before looking for site-wide plugins. (Jonathan Lange)
• bzr resolve now detects and marks resolved text conflicts. (Aaron Bentley)

INTERNALS:

• Internally revision ids and file ids are now passed around as utf-8 bytestrings, rather than treating them as Unicode strings. This has performance benefits for Knits, since we no longer need to decode the revision id for each line of content, nor for each entry in the index. This will also help with the future dirstate format. (John Arbash Meinel)
• Reserved ids (any revision-id ending in a colon) are rejected by versionedfiles, repositories, branches, and working trees (Aaron Bentley)
• Minor performance improvement by not creating a ProgressBar for every KnitIndex we create. (about 90ms for a bzr.dev tree) (John Arbash Meinel)
• New easier to use Branch hooks facility. There are five initial hooks, all documented in bzrlib.branch.BranchHooks.__init__ - 'set_rh', 'post_push', 'post_pull', 'post_commit', 'post_uncommit'. These hooks fire after the matching operation on a branch has taken place, and were originally added for the branchrss plugin. (Robert Collins)
• New method Branch.push() which should be used when pushing from a branch as it makes performance and policy decisions to match the UI level command push. (Robert Collins).
• Add a new method Tree.revision_tree which allows access to cached trees for arbitrary revisions. This allows the in development dirstate tree format to provide access to the callers to cached copies of inventory data which are cheaper to access than inventories from the repository. (Robert Collins, Martin Pool)
• New Branch.last_revision_info method, this is being done to allow optimization of requests for both the number of revisions and the last revision of a branch with smartservers and potentially future branch formats. (Wouter van Heyst, Robert Collins)
• Allow 'import bzrlib.plugins.NAME' to work when the plugin NAME has not yet been loaded by load_plugins(). This allows plugins to depend on each other for code reuse without requiring users to perform file-renaming gymnastics. (Robert Collins)
• New Repository method 'gather_stats' for statistic data collection. This is expected to grow to cover a number of related uses mainly related to bzr info. (Robert Collins)
• Log formatters are now managed with a registry. log.register_formatter continues to work, but callers accessing the FORMATTERS dictionary directly will not.
• Allow a start message to be passed to the edit_commit_message function. This will be placed in the message offered to the user for editing above the separator. It allows a template commit message to be used more easily. (James Westby)
• GPGStrategy.sign() will now raise BzrBadParameterUnicode if you pass a Unicode string rather than an 8-bit string. Callers need to be updated to encode first. (John Arbash Meinel)
• Branch.push, pull, merge now return Result objects with information about what happened, rather than a scattering of various methods. These are also passed to the post hooks. (Martin Pool)
• File formats and architecture is in place for managing a forest of trees in bzr, and splitting up existing trees into smaller subtrees, and finally joining trees to make a larger tree. This is the first iteration of this support, and the user-facing aspects still require substantial work. If you wish to experiment with it, use bzr upgrade --dirstate-with-subtree in your working trees and repositories. You can use the hidden commands split and join and to create and manipulate nested trees, but please consider using the nested-trees branch, which contains substantial UI improvements, instead. http://code.aaronbentley.com/bzr/bzrrepo/nested-trees/ (Aaron Bentley, Martin Pool, Robert Collins).

BUGFIXES:

• bzr annotate now uses dotted revnos from the viewpoint of the branch, rather than the last changed revision of the file. (John Arbash Meinel, #82158)
• Lock operations no longer hang if they encounter a permission problem. (Aaron Bentley)
• bzr push can resume a push that was canceled before it finished. Also, it can push even if the target directory exists if you supply the --use-existing-dir flag. (John Arbash Meinel, #30576, #45504)
• Fix http proxy authentication when user and an optional password appears in the *_proxy vars. (Vincent Ladeuil, #83954).
• bzr log branch/file works for local treeless branches (Aaron Bentley, #84247)
• Fix problem with UNC paths on Windows 98. (Alexander Belchenko, #84728)
• Searching location of CA bundle for PyCurl in env variable (CURL_CA_BUNDLE), and on win32 along the PATH. (Alexander Belchenko, #82086)
• bzr init works with unicode argument LOCATION. (Alexander Belchenko, #85599)
• Raise DependencyNotPresent if pycurl do not support https. (Vincent Ladeuil, #85305)
• Invalid proxy env variables should not cause a traceback. (Vincent Ladeuil, #87765)
• Ignore patterns normalised to use '/' path separator. (Kent Gibson, #86451)
• bzr rocks. It sure does! Fix case. (Vincent Ladeuil, #78026)
• Fix bzrtools shelve command for removed lines beginning with "--" (Johan Dahlberg, #75577)

TESTING:

• New --first option to bzr selftest to run specified tests before the rest of the suite. (Martin Pool)

IMPROVEMENTS:

• bzr help global-options describes the global options. (Aaron Bentley)

BUG FIXES:

• Skip documentation generation tests if the tools to do so are not available. Fixes running selftest for installled copies of bzr. (John Arbash Meinel, #80330)
• Fix the code that discovers whether bzr is being run from it's working tree to handle the case when it isn't but the directory it is in is below a repository. (James Westby, #77306)

IMPROVEMENTS:

• New connection: bzr+http:// which supports tunnelling the smart protocol over an HTTP connection. If writing is enabled on the bzr server, then you can write over the http connection. (Andrew Bennetts, John Arbash Meinel)

• Aliases now support quotation marks, so they can contain whitespace (Marius Kruger)

• PyCurlTransport now use a single curl object. By specifying explicitly the 'Range' header, we avoid the need to use two different curl objects (and two connections to the same server). (Vincent Ladeuil)

• bzr commit does not prompt for a message until it is very likely to succeed. (Aaron Bentley)

• bzr conflicts now takes --text to list pathnames of text conflicts (Aaron Bentley)

• Fix iter_lines_added_or_present_in_versions to use a set instead of a list while checking if a revision id was requested. Takes 10s off of the fileids_affected_by_revision_ids time, which is 10s of the bzr branch time. Also improve fileids_... time by filtering lines with a regex rather than multiple str.find() calls. (saves another 300ms) (John Arbash Meinel)

• Policy can be set for each configuration key. This allows keys to be inherited properly across configuration entries. For example, this should enable you to do:

  [/home/user/project]
  push_location = sftp://host/srv/project/
  push_location:policy = appendpath
  

  And then a branch like /home/user/project/mybranch should get an automatic push location of sftp://host/srv/project/mybranch. (James Henstridge)

• Added bzr status --short to make status report svn style flags for each file. For example:

  $ bzr status --short
  A  foo
  A  bar
  D  baz
  ?  wooley
  

• 'bzr selftest --clean-output' allows easily clean temporary tests directories without running tests. (Alexander Belchenko)

• bzr help hidden-commands lists all hidden commands. (Aaron Bentley)

• bzr merge now has an option --pull to fall back to pull if local is fully merged into remote. (Jan Hudec)

• bzr help formats describes available directory formats. (Aaron Bentley)

INTERNALS:

• A few tweaks directly to fileids_affected_by_revision_ids to help speed up processing, as well allowing to extract unannotated lines. Between the two fileids_affected_by_revision_ids is improved by approx 10%. (John Arbash Meinel)
• Change Revision serialization to only write out millisecond resolution. Rather than expecting floating point serialization to preserve more resolution than we need. (Henri Weichers, Martin Pool)
• Test suite ends cleanly on Windows. (Vincent Ladeuil)
• When encoding_type attribute of class Command is equal to 'exact', force sys.stdout to be a binary stream on Windows, and therefore keep exact line-endings (without LF -> CRLF conversion). (Alexander Belchenko)
• Single-letter short options are no longer globally declared. (Martin Pool)
• Before using detected user/terminal encoding bzr should check that Python has corresponding codec. (Alexander Belchenko)
• Formats for end-user selection are provided via a FormatRegistry (Aaron Bentley)

BUG FIXES:

• bzr missing --verbose was showing adds/removals in the wrong direction. (John Arbash Meinel)
• bzr annotate now defaults to showing dotted revnos for merged revisions. It cuts them off at a depth of 12 characters, but you can supply --long to see the full number. You can also use --show-ids to display the original revision ids, rather than revision numbers and committer names. (John Arbash Meinel, #75637)
• bzr now supports Win32 UNC path (e.g. \HOST\path. (Alexander Belchenko, #57869)
• Win32-specific: output of cat, bundle and diff commands don't mangle line-endings (Alexander Belchenko, #55276)
• Replace broken fnmatch based ignore pattern matching with custom pattern matcher. (Kent Gibson, Jan Hudec #57637)
• pycurl and urllib can detect short reads at different places. Update the test suite to test more cases. Also detect http error code 416 which was raised for that specific bug. Also enhance the urllib robustness by detecting invalid ranges (and pycurl's one by detecting short reads during the initial GET). (Vincent Ladeuil, #73948)
• The urllib connection sharing interacts badly with urllib2 proxy setting (the connections didn't go thru the proxy anymore). Defining a proper ProxyHandler solves the problem. (Vincent Ladeuil, #74759)
• Use urlutils to generate relative URLs, not osutils (Aaron Bentley, #76229)
• bzr status in a readonly directory should work without giving lots of errors. (John Arbash Meinel, #76299)
• Mention the revisionspec topic for the revision option help. (Wouter van Heyst, #31663)
• Allow plugins import from zip archives. (Alexander Belchenko, #68124)

IMPROVEMENTS:

• New command bzr remove-tree allows the removal of the working tree from a branch. (Daniel Silverstone)
• urllib uses shared keep-alive connections, so http operations are substantially faster. (Vincent Ladeuil, #53654)
• bzr export allows an optional branch parameter, to export a bzr tree from some other url. For example: bzr export bzr.tar.gz http://bazaar-vcs.org/bzr/bzr.dev (Daniel Silverstone)
• Added bzr help topics to the bzr help system. This gives a location for general information, outside of a specific command. This includes updates for bzr help revisionspec the first topic included. (Goffredo Baroncelli, John Arbash Meinel, #42714)
• WSGI-compatible HTTP smart server. See doc/http_smart_server.txt. (Andrew Bennetts)
• Knit files will now cache full texts only when the size of the deltas is as large as the size of the fulltext. (Or after 200 deltas, whichever comes first). This has the most benefit on large files with small changes, such as the inventory for a large project. (eg For a project with 2500 files, and 7500 revisions, it changes the size of inventory.knit from 11MB to 5.4MB) (John Arbash Meinel)

INTERNALS:

• New -D option given before the command line turns on debugging output for particular areas. -Derror shows tracebacks on all errors. (Martin Pool)
• Clean up bzr selftest --benchmark bundle to correct an import, and remove benchmarks that take longer than 10min to run. (John Arbash Meinel)
• Use time.time() instead of time.clock() to decide on progress throttling. Because time.clock() is actually CPU time, so over a high-latency connection, too many updates get throttled. (John Arbash Meinel)
• MemoryTransport.list_dir() would strip the first character for files or directories in root directory. (John Arbash Meinel)
• New method get_branch_reference on 'BzrDir' allows the detection of branch references - which the smart server component needs.
• New ChrootTransportDecorator, accessible via the chroot+ url prefix. It disallows any access to locations above a set URL. (Andrew Bennetts)

BUG FIXES:

• Now _KnitIndex properly decode revision ids when loading index data. And optimize the knit index parsing code. (Dmitry Vasiliev, John Arbash Meinel)
• bzrlib/bzrdir.py was directly referencing bzrlib.workingtree, without importing it. This prevented bzr upgrade from working unless a plugin already imported bzrlib.workingtree (John Arbash Meinel, #70716)
• Suppress the traceback on invalid URLs (Vincent Ladeuil, #70803).
• Give nicer error message when an http server returns a 403 error code. (Vincent Ladeuil, #57644).
• When a multi-range http GET request fails, try a single range one. If it fails too, forget about ranges. Remember that until the death of the transport and propagates that to the clones. (Vincent Ladeuil, #62276, #62029).
• Handles user/passwords supplied in url from command line (for the urllib implementation). Don't request already known passwords (Vincent Ladeuil, #42383, #44647, #48527)
• _KnitIndex.add_versions() dictionary compresses revision ids as they are added. This fixes bug where fetching remote revisions records them as full references rather than integers. (John Arbash Meinel, #64789)
• bzr ignore strips trailing slashes in patterns. Also bzr ignore rejects absolute paths. (Kent Gibson, #4559)
• bzr ignore takes multiple arguments. (Cheuksan Edward Wang, #29488)
• mv correctly handles paths that traverse symlinks. (Aaron Bentley, #66964)
• Give nicer looking error messages when failing to connect over ssh. (John Arbash Meinel, #49172)
• Pushing to a remote branch does not currently update the remote working tree. After a remote push, bzr status and bzr diff on the remote machine now show that the working tree is out of date. (Cheuksan Edward Wang #48136)
• Use patiencediff instead of difflib for determining deltas to insert into knits. This avoids the O(N^3) behavior of difflib. Patience diff should be O(N^2). (Cheuksan Edward Wang, #65714)
• Running bzr log on nonexistent file gives an error instead of the entire log history. (Cheuksan Edward Wang #50793)
• bzr cat can look up contents of removed or renamed files. If the pathname is ambiguous, i.e. the files in the old and new trees have different id's, the default is the file in the new tree. The user can use "--name-from-revision" to select the file in the old tree. (Cheuksan Edward Wang, #30190)

TESTING:

• TestingHTTPRequestHandler really handles the Range header (previously it was ignoring it and returning the whole file,).

INTERNALS:

• Clean up bzr selftest --benchmark bundle to correct an import, and remove benchmarks that take longer than 10min to run. (John Arbash Meinel)

IMPROVEMENTS:

• bzr log now shows dotted-decimal revision numbers for all revisions, rather than just showing a decimal revision number for revisions on the mainline. These revision numbers are not yet accepted as input into bzr commands such as log, diff etc. (Robert Collins)
• revisions can now be specified using dotted-decimal revision numbers. For instance, bzr diff -r 1.2.1..1.2.3. (Robert Collins)
• bzr help commands output is now shorter (Aaron Bentley)
• bzr now uses lazy importing to reduce the startup time. This has a moderate effect on lots of actions, especially ones that have little to do. For example bzr rocks time is down to 116ms from 283ms. (John Arbash Meinel)
• New Registry class to provide name-to-object registry-like support, for example for schemes where plugins can register new classes to do certain tasks (e.g. log formatters). Also provides lazy registration to allow modules to be loaded on request. (John Arbash Meinel, Adeodato Simó)

API INCOMPATABILITY:

• LogFormatter subclasses show now expect the 'revno' parameter to show() to be a string rather than an int. (Robert Collins)

INTERNALS:

• TestCase.run_bzr, run_bzr_captured, and run_bzr_subprocess can take a working_dir='foo' parameter, which will change directory for the command. (John Arbash Meinel)
• bzrlib.lazy_regex.lazy_compile can be used to create a proxy around a regex, which defers compilation until first use. (John Arbash Meinel)
• TestCase.run_bzr_subprocess defaults to supplying the --no-plugins parameter to ensure test reproducability, and avoid problems with system-wide installed plugins. (John Arbash Meinel)
• Unique tree root ids are now supported. Newly created trees still use the common root id for compatibility with bzr versions before 0.12. (Aaron Bentley)
• WorkingTree.set_root_id(None) is now deprecated. Please pass in inventory.ROOT_ID if you want the default root id value. (Robert Collins, John Arbash Meinel)
• New method WorkingTree.flush() which will write the current memory inventory out to disk. At the same time, read_working_inventory will no longer trash the current tree inventory if it has been modified within the current lock, and the tree will now flush() automatically on unlock(). WorkingTree.set_root_id() has been updated to take advantage of this functionality. (Robert Collins, John Arbash Meinel)
• bzrlib.tsort.merge_sorted now accepts generate_revnos. This parameter will cause it to add another column to its output, which contains the dotted-decimal revno for each revision, as a tuple. (Robert Collins)
• LogFormatter.show_merge is deprecated in favour of LogFormatter.show_merge_revno. (Robert Collins)

BUG FIXES:

• Avoid circular imports by creating a deprecated function for bzrlib.tree.RevisionTree. Callers should have been using bzrlib.revisontree.RevisionTree anyway. (John Arbash Meinel, #63360, #66349)
• Don't use socket.MSG_WAITALL as it doesn't exist on all platforms. (Martin Pool, #66356)
• Don't require Content-Type in range responses. Assume they are a single range if Content-Type does not exist. (John Arbash Meinel, #62473)
• bzr branch/pull no longer complain about progress bar cleanup when interrupted during fetch. (Aaron Bentley, #54000)
• WorkingTree.set_parent_trees() uses the trees to directly write the basis inventory, rather than going through the repository. This allows us to have 1 inventory read, and 2 inventory writes when committing a new tree. (John Arbash Meinel)
• When reverting, files that are not locally modified that do not exist in the target are deleted, not just unversioned (Aaron Bentley)
• When trying to acquire a lock, don't fail immediately. Instead, try a few times (up to 1 hour) before timing out. Also, report why the lock is unavailable (John Arbash Meinel, #43521, #49556)
• Leave HttpTransportBase daughter classes decides how they implement cloning. (Vincent Ladeuil, #61606)
• diff3 does not indicate conflicts on clean merge. (Aaron Bentley)
• If a commit fails, the commit message is stored in a file at the root of the tree for later commit. (Cheuksan Edward Wang, Stefan Metzmacher, #32054)

TESTING:

• New test base class TestCaseWithMemoryTransport offers memory-only testing facilities: its not suitable for tests that need to mutate disk state, but most tests should not need that and should be converted to TestCaseWithMemoryTransport. (Robert Collins)
• TestCase.make_branch_and_memory_tree now takes a format option to set the BzrDir, Repository and Branch formats of the created objects. (Robert Collins, John Arbash Meinel)

• Smart server transport test failures on windows fixed. (Lukáš Lalinský).

BUG FIXES:

• Test suite hangs on windows fixed. (Andrew Bennets, Alexander Belchenko).
• Commit performance regression fixed. (Aaron Bentley, Robert Collins, John Arbash Meinel).

IMPROVEMENTS:

• Knit files now wait to create their contents until the first data is added. The old code used to create an empty .knit and a .kndx with just the header. However, this caused a lot of extra round trips over sf