Table of Contents (3.3.22)

# Bazaar Release Notes

## bzr 1.12

Codename:

  1234567890

1.12:

  2009-02-13

1.12rc1:

  2009-02-10

This release of Bazaar contains many improvements to the speed, documentation and functionality of `bzr log` and the display of logged revisions by `bzr status`. bzr now also gives a better indication of progress, both in the way operations are drawn onto a text terminal, and by showing the rate of network IO.

### Changes from RC1 to Final

- `bzr init --development-wt5[-rich-root]` would fail because of circular import errors. (John Arbash Meinel, #328135)

- Expanded the help for log and added a new help topic called `log-formats`. (Ian Clatworthy)

### Compatibility Breaks

- By default, `bzr status` after a merge now shows just the pending merge tip revisions. This improves the signal-to-noise ratio after merging from trunk and completes much faster. To see all merged revisions, use the new `-v` flag. (Ian Clatworthy)

- `bzr log --line` now shows any tags after the date and before the commit message. If you have scripts which parse the output from this command, you may need to adjust them accordingly. (Ian Clatworthy)

- `bzr log --short` now shows any additional revision properties after the date and before the commit message. Scripts that parse output of the log command in this situation may need to adjust. (Neil Martinsen-Burrell)

- The experimental formats `1.12-preview` and `1.12-preview-rich-root` have been renamed `development-wt5` and `development-wt5-rich-root` respectively, given they are not ready for release in 1.12. (Ian Clatworthy)

- `read_bundle_from_url` has been deprecated. (Vincent Ladeuil)

### New Features

- Add support for filtering `bzr missing` on revisions. Remote revisions can be filtered using `bzr missing -r -20..-10` and local revisions can be filtered using `bzr missing --my-revision -20..-10`. (Marius Kruger)

- `bzr log -p` displays the patch diff for each revision. When logging a file, the diff only includes changes to that file. (Ian Clatworthy, #202331, #227335)

- `bzr log` supports a new option called `-n N` or `--level N`. A value of 0 (zero) means “show all nested merge revisions” while a value of 1 (one) means “show just the top level”. Values above 1 can be used to see a limited amount of nesting. That can be useful for seeing the level or two below PQM submits for example. To force the `--short` and `--line` formats to display all nested merge revisions just like `--long` does by default, use a command like `bzr log --short -n0`. To display just the mainline using `--long` format, `bzr log --long -n1`. (Ian Clatworthy)

### Improvements

- `bzr add` more clearly communicates success vs failure. (Daniel Watkins)

- `bzr init` will now print a little less verbose output. (Marius Kruger)

- `bzr log` is now much faster in many use cases, particularly at incrementally displaying results and filtering by a revision range. (Ian Clatworthy)

- `bzr log --short` and `bzr log --line` now show tags, if any, for each revision. The tags are shown comma-separated inside `{}`. For short format, the tags appear at the end of line before the optional `[merge]` indicator. For line format, the tags appear after the date. (Ian Clatworthy)

- Progress bars now show the rate of activity for some SFTP operations, and they are drawn different. (Martin Pool, #172741)

- Progress bars now show the rate of activity for urllib and pycurl based HTTP client implementations. The operations are tracked at the socket level for better precision. (Vincent Ladeuil)

- Rule-based preferences can now accept multiple patterns for a set of rules. (Marius Kruger)

- The `ancestor:` revision spec will now default to referring to the parent of the branch if no other location is given. (Daniel Watkins, #198417)

- The debugger started as a result of setting `$BZR_PDB` works around a bug in `pdb`, http://bugs.python.org/issue4150. The bug can cause truncated tracebacks in Python versions before 2.6. (Andrew Bennetts)

- VirtualVersionedFiles now implements `iter_lines_added_or_present_in_keys`. This allows the creation of new branches based on stacked bzr-svn branches. (#311997)

### Bug Fixes

- `bzr annotate --show-ids` doesn’t give a backtrace on empty files anymore. (Anne Mohsen, Vincent Ladeuil, #314525)

- `bzr log FILE` now correctly shows mainline revisions merging a change to FILE when the `--short` and `--line` log formats are used. (Ian Clatworthy, #317417)

- `bzr log -rX..Y FILE` now shows the history of FILE provided it existed in Y or X, even if the file has since been deleted or renamed. If no range is given, the current/basis tree and initial tree are searched in that order. More generally, log now interprets filenames in their historical context. (Ian Clatworthy, #175520)

- `bzr status` now reports nonexistent files and continues, then errors (with code 3) at the end. (Karl Fogel, #306394)

- Don’t require the present compression base in knits to be the same when adding records in knits. (Jelmer Vernooij, #307394)

- Fix a problem with CIFS client/server lag on Windows colliding with an invariant-per-process algorithm for generating AtomicFile names (Adrian Wilkins, #304023)

- Many socket operations now handle EINTR by retrying the operation. Previously EINTR was treated as an unrecoverable failure. There is a new `until_no_eintr` helper function in `bzrlib.osutils`. (Andrew Bennetts)

- Support symlinks with non-ascii characters in the symlink filename. (Jelmer Vernooij, #319323)

- There was a bug in how we handled resolving when a file is deleted in one branch, and modified in the other. If there was a criss-cross merge, we would cause the deletion to conflict a second time. (Vincent Ladeuil, John Arbash Meinel)

- There was another bug in how we chose the correct intermediate LCA in criss-cross merges leading to several kind of changes be incorrectly handled. (John Arbash Meinel, Vincent Ladeuil)

- Unshelve now handles deleted paths without crashing. (Robert Collins)

### Documentation

- Improved plugin developer documentation. (Martin Pool)

### API Changes

- `ProgressBarStack` is deprecated; instead use `ui_factory.nested_progress_bar` to create new progress bars. (Martin Pool)

- ForeignVcsMapping() now requires a ForeignVcs object as first argument. (Jelmer Vernooij)

- ForeignVcsMapping.show_foreign_revid() has been moved to ForeignVcs. (Jelmer Vernooij)

- `read_bundle_from_url` is deprecated in favor of `read_mergeable_from_url`. (Vincent Ladeuil)

- Revision specifiers are now registered in `bzrlib.revisionspec.revspec_registry`, and the old list of revisionspec classes (`bzrlib.revisionspec.SPEC_TYPES`) has been deprecated. (Jelmer Vernooij, #321183)

- The progress and UI classes have changed; the main APIs remain the same but code that provides a new UI or progress bar class may need to be updated. (Martin Pool)

### Internals

- Default User Interface (UI) is CLIUIFactory when bzr runs in a dumb terminal. It is sometimes desirable do override this default by forcing bzr to use TextUIFactory. This can be achieved by setting the BZR_USE_TEXT_UI environment variable (emacs shells, as opposed to compile buffers, are such an example). (Vincent Ladeuil)

- New API `Branch.iter_merge_sorted_revisions()` that iterates over `(revision_id, depth, revno, end_of_merge)` tuples. (Ian Clatworthy)

- New `Branch.dotted_revno_to_revision_id()` and `Branch.revision_id_to_dotted_revno()` APIs that pick the most efficient way of doing the mapping. (Ian Clatworthy)

- Refactor cmd_serve so that it’s a little easier to build commands that extend it, and perhaps even a bit easier to read. (Jonathan Lange)

- `TreeDelta.show()` now accepts a `filter` parameter allowing log formatters to retrict the output. (Vincent Ladeuil)