/brz/remove-bazaar

--------------------

Bazaar Release Notes

--------------------

.. contents::

IN DEVELOPMENT

--------------

  FEATURES:

    * New ``pre_change_branch_tip`` hook that is called before the

      branch tip is moved, while the branch is write-locked.  See the User

      Reference for signature details.  (Andrew Bennetts)

    * Rule-based preferences can now be defined for selected files in

      selected branches, allowing commands and plugins to provide

      custom behaviour for files matching defined patterns.

      See ``Rule-based preferences`` (part of ``Configuring Bazaar``)

      in the User Guide and ``bzr help rules`` for more information.

      (Ian Clatworthy)

  IMPROVEMENTS:

    * ``bzr export --format=tgz --root=NAME -`` to export a gzipped tarball 

      to stdout; also ``tar`` and ``tbz2``.

      (Martin Pool)

    * Remembered locations can be specified by aliases, e.g. :parent, :public,

      :submit.  (Aaron Bentley)

    * The smart protocol now has improved support for setting branches'

      revision info directly.  This makes operations like push

      faster.  The new request method name is

      ``Branch.set_last_revision_ex``.  (Andrew Bennetts)

  BUGFIXES:

    * ``check`` handles the split-up .bzr layout correctly, so no longer

      requires a branch to be present.

      (Daniel Watkins, #64783)

    * Clearer message about how to set the PYTHONPATH if bzrlib can't be

      loaded. 

      (Martin Pool, #205230)

    * Errors about missing libraries are now shown without a traceback,

      and with a suggestion to install the library.  The full traceback is 

      still in ``.bzr.log`` and can be shown with ``-Derror``.

      (Martin Pool, #240161)

    * Handle urls such as ftp://user@host.com@www.host.com where the user

      name contains an @.

      (Neil Martinsen-Burrell, #228058)

    * ``needs_read_lock`` and ``needs_write_lock`` now suppress an error during

      ``unlock`` if there was an error in the original function. This helps

      most when there is a failure with a smart server action, since often the

      connection closes and we cannot unlock.

      (Andrew Bennetts, John Arbash Meinel, #125784)

    * Obsolete hidden command ``bzr fetch`` removed.

      (Martin Pool, #172870)

    * Raise the correct exception when doing ``-rbefore:0`` or ``-c0``.

      (John Arbash Meinel, #239933)

    * You can now compare file revisions in Windows diff programs from 

      Cygwin Bazaar.

      (Matt McClure, #209281)

    * revision_history now tolerates mainline ghosts for Branch format 6.

      (Aaron Bentley, #235055)

    * Set locale from environment for third party libs.

      (Martin von Gagern, #128496)

  DOCUMENTATION:

    * Updated developer documentation.

      (Martin Pool)

  TESTING:

   * ``-Dmemory`` will cause /proc/PID/status to be catted before bzr

     exits, allowing low-key analysis of peak memory use. (Robert Collins)

   * ``TestCaseWithTransport.make_branch_and_tree`` tries harder to return

     a tree with a ``branch`` attribute of the right format.  This was

     preventing some ``RemoteBranch`` tests from actually running with

     ``RemoteBranch`` instances.  (Andrew Bennetts)

  API CHANGES:

    * Removed ``Repository.text_store``, ``control_store``, etc.  Instead,

      there are new attributes ``texts, inventories, revisions,

      signatures``, each of which is a ``VersionedFiles``.  See the

      Repository docstring for more details.

      (Robert Collins)

    * ``Branch.pull`` now accepts an ``_override_hook_target`` optional

      parameter.  If you have a subclass of ``Branch`` that overrides

      ``pull`` then you should add this parameter.  (Andrew Bennetts)

    * ``bzrlib.check.check()`` has been deprecated in favour of the more

      aptly-named ``bzrlib.check.check_branch()``.

      (Daniel Watkins)

    * ``Tree.print_file`` and ``Repository.print_file`` are deprecated.

      These methods are bad APIs because they write directly to sys.stdout.

      bzrlib does not use them internally, and there are no direct tests

      for them. (Alexander Belchenko)

  INTERNALS:

    * ``cat`` command no longer uses ``Tree.print_file()`` internally.

      (Alexander Belchenko)

    * New class method ``BzrDir.open_containing_tree_branch_or_repository``

      which eases the discovery of the tree, the branch and the repository

      containing a given location.

      (Daniel Watkins)

    * New ``versionedfile.KeyMapper`` interface to abstract out the access to

      underlying .knit/.kndx etc files in repositories with partitioned

      storage. (Robert Collins)

    * Obsolete developer-use command ``weave-join`` has been removed.

      (Robert Collins)

    * ``RemoteToOtherFetcher`` and ``get_data_stream_for_search`` removed,

      to support new ``VersionedFiles`` layering.

      (Robert Collins)

bzr 1.6beta2 2008-06-10

-----------------------

This release contains further progress towards our 1.6 goals of shallow

repositories, and contains a fix for some user-affecting bugs in the

repository layer.  Building working trees during checkout and branch is

now faster.

  BUG FIXES:

    * Avoid KnitCorrupt error extracting inventories from some repositories.

      (The data is not corrupt; an internal check is detecting a problem

      reading from the repository.)

      (Martin Pool, Andrew Bennetts, Robert Collins, #234748)

    * ``bzr status`` was breaking if you merged the same revision twice.

      (John Arbash Meinel, #235407)

    * Fix infinite loop consuming 100% CPU when a connection is lost while

      reading a response body via the smart protocol v1 or v2.

      (Andrew Bennetts)

    * Inserting a bundle which changes the contents of a file with no trailing

      end of line, causing a knit snapshot in a 'knits' repository will no longer

      cause KnitCorrupt. (Robert Collins)

    * ``RemoteBranch.pull`` needs to return the ``self._real_branch``'s

      pull result. It was instead just returning None, which breaks ``bzr

      pull``. (John Arbash Meinel, #238149)

    * Sanitize branch nick before using it as an attachment filename in

      ``bzr send``. (Lukáš Lalinský, #210218)

    * Squash ``inv_entry.symlink_target`` to a plain string when

      generating DirState details. This prevents from getting a

      ``UnicodeError`` when you have symlinks and non-ascii filenames.

      (John Arbash Meinel, #135320)

  IMPROVEMENTS:

    * Added the 'alias' command to set/unset and display aliases. (Tim Penhey)

    * ``added``, ``modified``, and ``unknowns`` behaviour made consistent (all three

      now quote paths where required). Added ``--null`` option to ``added`` and 

      ``modified`` (for null-separated unknowns, use ``ls --unknown --null``)

      (Adrian Wilkins)

    * Faster branching (1.09x) and lightweight checkouts (1.06x) on large trees.

      (Ian Clatworthy, Aaron Bentley)

  DOCUMENTATION:

    * Added *Bazaar Zen* section to the User Guide. (Ian Clatworthy)

  TESTING:

    * Fix the test HTTPServer to be isolated from chdir calls made while it is

      running, allowing it to be used in blackbox tests. (Robert Collins)

  API CHANGES:

    * ``WorkingTree.set_parent_(ids/trees)`` will now filter out revisions

      which are in the ancestry of other revisions. So if you merge the same

      tree twice, or merge an ancestor of an existing merge, it will only

      record the newest. (If you merge a descendent, it will replace its

      ancestor). (John Arbash Meinel, #235407)

  INTERNALS:

    * Knit record serialisation is now stricter on what it will accept, to

      guard against potential internal bugs, or broken input. (Robert Collins)

bzr 1.6beta1 2008-06-02

-----------------------

Commands that work on the revision history such as push, pull, missing,

uncommit and log are now substantially faster.  This release adds a

translation of some of the user documentation into Spanish.  (Contributions of

other translations would be very welcome.)  Bazaar 1.6beta1 adds a new network

protocol which is used by default and which allows for more efficient transfers

and future extensions.

  NOTES WHEN UPGRADING:

    * There is a new version of the network protocol used for bzr://, bzr+ssh://

      and bzr+http:// connections.  This will allow more efficient requests and

      responses, and more graceful fallback when a server is too old to

      recognise a request from a more recent client.  Bazaar 1.6 will

      interoperate with 0.16 and later versions, but servers should be upgraded

      when possible.  Bazaar 1.6 no longer interoperates with 0.15 and earlier via

      these protocols.  Use alternatives like SFTP or upgrade those servers.

      (Andrew Bennetts, #83935)

  CHANGES:

    * Deprecation warnings will not be suppressed when running ``bzr selftest``

      so that developers can see if their code is using deprecated functions.

      (John Arbash Meinel)

  FEATURES:

    * Adding ``-Derror`` will now display a traceback when a plugin fails to

      load. (James Westby)

  IMPROVEMENTS:

    * ``bzr branch/push/pull -r XXX`` now have a helper function for finding

      the revno of the new revision (``Graph.find_distance_to_null``). This

      should make something like ``bzr branch -r -100`` in a shared, no-trees

      repository much snappier. (John Arbash Meinel)

    * ``bzr log --short -r X..Y`` no longer needs to access the full revision

      history. This makes it noticeably faster when logging the last few

      revisions. (John Arbash Meinel)

    * ``bzr ls`` now accepts ``-V`` as an alias for ``--versioned``. 

      (Jerad Cramp, #165086)

    * ``bzr missing`` uses the new ``Graph.find_unique_ancestors`` and

      ``Graph.find_differences`` to determine missing revisions without having

      to search the whole ancestry. (John Arbash Meinel, #174625)

    * ``bzr uncommit`` now uses partial history access, rather than always

      extracting the full revision history for a branch. This makes it

      resolve the appropriate revisions much faster (in testing it drops

      uncommit from 1.5s => 0.4s). It also means ``bzr log --short`` is one

      step closer to not using full revision history.

      (John Arbash Meinel, #172649)

  BUGFIXES:

    * ``bzr merge --lca`` should handle when two revisions have no common

      ancestor other than NULL_REVISION. (John Arbash Meinel, #235715)

    * ``bzr status`` was breaking if you merged the same revision twice.

      (John Arbash Meinel, #235407)

    * ``bzr push`` with both ``--overwrite`` and ``-r NNN`` options no longer

      fails.  (Andrew Bennetts, #234229)

    * Correctly track the base URL of a smart medium when using bzr+http://

      URLs, which was causing spurious "No repository present" errors with

      branches in shared repositories accessed over bzr+http.

      (Andrew Bennetts, #230550)

    * Define ``_remote_is_at_least_1_2`` on ``SmartClientMedium`` so that all

      implementations have the attribute.  Fixes 'PyCurlTransport' object has no

      attribute '_remote_is_at_least_1_2' attribute errors.

      (Andrew Bennetts, #220806)

    * Failure to delete an obsolete pack file should just give a warning

      message, not a fatal error.  It may for example fail if the file is still

      in use by another process.

      (Martin Pool)

    * Fix MemoryError during large fetches over HTTP by limiting the amount of

      data we try to read per ``recv`` call.  The problem was observed with

      Windows and a proxy, but might affect other environments as well.

      (Eric Holmberg, #215426)

    * Handle old merge directives correctly in Merger.from_mergeable.  Stricter

      get_parent_map requirements exposed a latent bug here.  (Aaron Bentley)

    * Issue a warning and ignore passwords declared in authentication.conf when

      used for an ssh scheme (sftp or bzr+ssh).

      (Vincent Ladeuil, #203186)

    * Make both http implementations raise appropriate exceptions on 403

      Forbidden when POSTing smart requests.

      (Vincent Ladeuil, #230223)

    * Properly *title* header names in http requests instead of capitalizing

      them.

      (Vincent Ladeuil, #229076)

    * The "Unable to obtain lock" error message now also suggests using

      ``bzr break-lock`` to fix it.  (Martin Albisetti, #139202)

    * Treat an encoding of '' as ascii; this can happen when bzr is run

      under vim on Mac OS X.

      (Neil Martinsen-Burrell)

    * ``VersionedFile.make_mpdiffs()`` was raising an exception that wasn't in

      scope. (Daniel Fischer #235687)

  DOCUMENTATION:

    * Added directory structure and started translation of docs in spanish.

      (Martin Albisetti, Lucio Albenga)

    * Incorporate feedback from Jelmer Vernooij and Neil Martinsen-Burrell

      on the plugin and integration chapters of the User Guide.

      (Ian Clatworthy)

    * More Bazaar developer documentation about packaging and release process,

      and about use of Python reprs.

      (Martin Pool, Martin Albisetti)

    * Updated Tortise strategy document. (Mark Hammond)

  TESTING:

    * ``bzrlib.tests.adapt_tests`` was broken and unused - it has been fixed.

      (Robert Collins)

    * Fix the test HTTPServer to be isolated from chdir calls made while it is

      running, allowing it to be used in blackbox tests. (Robert Collins)

    * New helper function for splitting test suites

      ``split_suite_by_condition``. (Robert Collins)

  INTERNALS:

    * ``Branch.missing_revisions`` has been deprecated. Similar functionality

      can be obtained using ``bzrlib.missing.find_unmerged``. The api was

      fairly broken, and the function was unused, so we are getting rid of it.

      (John Arbash Meinel)

  API CHANGES:

    * ``Branch.abspath`` is deprecated; use the Tree or Transport 

      instead.  (Martin Pool)

    * ``Branch.update_revisions`` now takes an optional ``Graph``

      object. This can be used by ``update_revisions`` when it is

      checking ancestry, and allows callers to prefer request to go to a

      local branch.  (John Arbash Meinel)

    * Branch, Repository, Tree and BzrDir should expose a Transport as an

      attribute if they have one, rather than having it indirectly accessible

      as ``.control_files._transport``.  This doesn't add a requirement

      to support a Transport in cases where it was not needed before;

      it just simplifies the way it is reached.  (Martin Pool)

    * ``bzr missing --mine-only`` will return status code 0 if you have no

      new revisions, but the remote does. Similarly for ``--theirs-only``.

      The new code only checks one side, so it doesn't know if the other

      side has changes. This seems more accurate with the request anyway.

      It also changes the output to print '[This|Other] branch is up to

      date.' rather than displaying nothing.  (John Arbash Meinel)

    * ``LockableFiles.put_utf8``, ``put_bytes`` and ``controlfilename``

      are now deprecated in favor of using Transport operations.

      (Martin Pool)

    * Many methods on ``VersionedFile``, ``Repository`` and in

      ``bzrlib.revision``  deprecated before bzrlib 1.5 have been removed.

      (Robert Collins)

    * ``RevisionSpec.wants_revision_history`` can be set to False for a given

      ``RevisionSpec``. This will disable the existing behavior of passing in

      the full revision history to ``self._match_on``. Useful for specs that

      don't actually need access to the full history. (John Arbash Meinel)

    * The constructors of ``SmartClientMedium`` and its subclasses now require a

      ``base`` parameter.  ``SmartClientMedium`` implementations now also need

      to provide a ``remote_path_from_transport`` method.  (Andrew Bennetts)

    * The default permissions for creating new files and directories 

      should now be obtained from ``BzrDir._get_file_mode()`` and 

      ``_get_dir_mode()``, rather than from LockableFiles.  The ``_set_file_mode``

      and ``_set_dir_mode`` variables on LockableFiles which were advertised

      as a way for plugins to control this are no longer consulted.

      (Martin Pool)

    * ``VersionedFile.join`` is deprecated. This method required local

      instances of both versioned file objects and was thus hostile to being

      used for streaming from a smart server. The new get_record_stream and

      insert_record_stream are meant to efficiently replace this method.

      (Robert Collins)

    * ``WorkingTree.set_parent_(ids/trees)`` will now filter out revisions

      which are in the ancestry of other revisions. So if you merge the same

      tree twice, or merge an ancestor of an existing merge, it will only

      record the newest. (If you merge a descendent, it will replace its

      ancestor). (John Arbash Meinel, #235407)

    * ``WorkingTreeFormat2.stub_initialize_remote`` is now private.

      (Martin Pool) 

bzr 1.5 2008-05-16

------------------

This release of Bazaar includes several updates to the documentation, and fixes

to prepare for making rich root support the default format. Many bugs have been

squashed, including fixes to log, bzr+ssh inter-operation with older servers.

  CHANGES:

    * Suppress deprecation warnings when bzrlib is a 'final' release. This way

      users of packaged software won't be bothered with DeprecationWarnings,

      but developers and testers will still see them. (John Arbash Meinel)

  DOCUMENTATION:

    * Incorporate feedback from Jelmer Vernooij and Neil Martinsen-Burrell

      on the plugin and integration chapters of the User Guide.

      (Ian Clatworthy)

bzr 1.5rc1 2008-05-09

---------------------

  NOTES WHEN UPGRADING:

  CHANGES:

    * Broader support of GNU Emacs mail clients. Set

      ``mail_client=emacsclient`` in your bazaar.conf and ``send`` will pop the

      bundle in a mail buffer according to the value of ``mail-user-agent``

      variable. (Xavier Maillard)

  FEATURES:

  IMPROVEMENTS:

    * Diff now handles revision specs like "branch:" and "submit:" more

      efficiently.  (Aaron Bentley, #202928)

    * More friendly error given when attempt to start the smart server

      on an address already in use. (Andrea Corbellini, #200575)

    * Pull completes much faster when there is nothing to pull.

      (Aaron Bentley)

  BUGFIXES:

    * Authentication.conf can define sections without password.

      (Vincent Ladeuil, #199440)

    * Avoid muttering every time a child update does not cause a progress bar

      update. (John Arbash Meinel, #213771)

    * ``Branch.reconcile()`` is now implemented. This allows ``bzr reconcile``

      to fix when a Branch has a non-canonical mainline history. ``bzr check``

      also detects this condition. (John Arbash Meinel, #177855)

    * ``bzr log -r ..X bzr://`` was failing, because it was getting a request

      for ``revision_id=None`` which was not a string.

      (John Arbash Meinel, #211661)

    * ``bzr commit`` now works with Microsoft's FTP service.

      (Andreas Deininger)

    * Catch definitions outside sections in authentication.conf.

      (Vincent Ladeuil, #217650)

    * Conversion from non-rich-root to rich-root(-pack) updates inventory

      sha1s, even when bundles are used.  (Aaron Bentley, #181391)

    * Conversion from non-rich-root to rich-root(-pack) works correctly even

      though search keys are not topologically sorted.  (Aaron Bentley)

    * Conversion from non-rich-root to rich-root(-pack) works even when a

      parent revision has a different root id.  (Aaron Bentley, #177874)

    * Disable strace testing until strace is fixed (see bug #103133) and emit a

      warning when selftest ends to remind us of leaking tests.

      (Vincent Ladeuil, #226769)

    * Fetching all revisions from a repository does not cause pack collisions.

      (Robert Collins, Aaron Bentley, #212908)

    * Fix error about "attempt to add line-delta in non-delta knit".

      (Andrew Bennetts, #217701)

    * Pushing a branch in "dirstate" format (Branch5) over bzr+ssh would break

      if the remote server was < version 1.2. This was due to a bug in the

      RemoteRepository.get_parent_map() fallback code.

      (John Arbash Meinel, #214894)

    * Remove leftover code in ``bzr_branch`` that inappropriately creates 

      a ``branch-name`` file in the branch control directory.

      (Martin Pool)

    * Set SO_REUSEADDR on server sockets of ``bzr serve`` to avoid problems

      rebinding the socket when starting the server a second time.

      (John Arbash Meinel, Martin Pool, #164288)

    * Severe performance degradation in fetching from knit repositories to

      knits and packs due to parsing the entire revisions.kndx on every graph

      walk iteration fixed by using the Repository.get_graph API.  There was

      another regression in knit => knit fetching which re-read the index for

      every revision each side had in common.

      (Robert Collins, John Arbash Meinel)

    * When logging the changes to a particular file, there was a bug if there

      were ghosts in the revision ancestry. (John Arbash Meinel, #209948)

    * xs4all's ftp server returns a temporary error when trying to list an

      empty directory, rather than returning an empty list. Adding a

      workaround so that we don't get spurious failures.

      (John Arbash Meinel, #215522)

  DOCUMENTATION:

    * Expanded the User Guide to include new chapters on popular plugins and

      integrating Bazaar into your environment. The *Best practices* chapter

      was renamed to *Miscellaneous topics* as suggested by community

      feedback as well. (Ian Clatworthy)

    * Document outlining strategies for TortoiseBzr. (Mark Hammond)

    * Improved the documentation on hooks. (Ian Clatworthy)

    * Update authentication docs regarding ssh agents.

      (Vincent Ladeuil, #183705)

  TESTING:

    * Add ``thread_name_suffix`` parameter to SmartTCPServer_for_testing, to

      make it easy to identify which test spawned a thread with an unhandled

      exception. (Andrew Bennetts)

    * New ``--debugflag``/``-E`` option to ``bzr selftest`` for setting

      options for debugging tests, these are complementary to the the -D

      options.  The ``-Dselftest_debug`` global option has been replaced by the

      ``-E=allow_debug`` option for selftest. (Andrew Bennetts)

    * Parameterised test ids are preserved correctly to aid diagnosis of test

      failures. (Robert Collins, Andrew Bennetts)

    * selftest now accepts --starting-with <id> to load only the tests whose id

      starts with the one specified. This greatly speeds up running the test

      suite on a limited set of tests and can be used to run the tests for a

      single module, a single class or even a single test.  (Vincent Ladeuil)

    * The test suite modules have been modified to define load_tests() instead

      of test_suite(). That speeds up selective loading (via --load-list)

      significantly and provides many examples on how to migrate (grep for

      load_tests).  (Vincent Ladeuil)

  INTERNALS:

    * ``Hooks.install_hook`` is now deprecated in favour of

      ``Hooks.install_named_hook`` which adds a required ``name`` parameter, to

      avoid having to call ``Hooks.name_hook``. (Daniel Watkins)

    * Implement xml8 serializer.  (Aaron Bentley)

    * New form ``@deprecated_method(deprecated_in(1, 5, 0))`` for making 

      deprecation wrappers.  (Martin Pool)

    * ``Repository.revision_parents`` is now deprecated in favour of 

      ``Repository.get_parent_map([revid])[revid]``. (Jelmer Vernooij)

    * The Python ``assert`` statement is no longer used in Bazaar source, and 

      a test checks this.  (Martin Pool)

  API CHANGES:

    * ``bzrlib.status.show_pending_merges`` requires the repository to be

      locked by the caller. Callers should have been doing it anyway, but it

      will now raise an exception if they do not. (John Arbash Meinel)

    * Repository.get_data_stream, Repository.get_data_stream_for_search(),

      Repository.get_deltas_for_revsions(), Repository.revision_trees(),

      Repository.item_keys_introduced_by() no longer take read locks.

      (Aaron Bentley)

    * ``LockableFiles.get_utf8`` and ``.get`` are deprecated, as a start

      towards removing LockableFiles and ``.control_files`` entirely.