~bzr-pqm/bzr/bzr.dev

####################

Bazaar Release Notes

####################

.. toctree::

   :maxdepth: 1

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)

..

   vim: tw=74 ft=rst ff=unix