/brz/remove-bazaar

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

Bazaar Release Notes

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

.. contents::

IN DEVELOPMENT

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

  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:

  BUGFIXES:

    * Severe performance degradation in fetching from knit repositories to

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

      iteration fixed by using the Repository.get_graph API. (Robert Collins)

  DOCUMENTATION:

    * Document outlining strategies for TortoiseBzr. (Mark Hammond)

  TESTING:

  INTERNALS:

    * Added plumbing for working tree content filtering.

      (Alexander Belchenko, Ian Clatworthy)

  API BREAKS:

bzr 1.4rc1 2008-04-11

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

   * bzr main script cannot be imported (Benjamin Peterson)

   * On Linux bzr additionally looks for plugins in arch-independent site

     directory. (Toshio Kuratomi)

   * The ``set_rh`` branch hook is now deprecated. Please migrate

     any plugins using this hook to use an alternative, e.g.

     ``post_change_branch_tip``. (Ian Clatworthy)

   * When a plugin cannot be loaded as the file path is not a valid

     python module name bzr will now strip a ``bzr_`` prefix from the

     front of the suggested name, as many plugins (e.g. bzr-svn)

     want to be installed without this prefix. It is a common mistake

     to have a folder named "bzr-svn" for that plugin, especially

     as this is what bzr branch lp:bzr-svn will give you. (James Westby,

     Andrew Cowie)

   * UniqueIntegerBugTracker now appends bug-ids instead of joining

     them to the base URL. Plugins that register bug trackers may

     need a trailing / added to the base URL if one is not already there.

     (James Wesby, Andrew Cowie)

  FEATURES:

    * Added start_commit hook for mutable trees. (Jelmer Vernooij, #186422)

    * ``status`` now accepts ``--no-pending`` to show the status without

      listing pending merges, which speeds up the command a lot on large

      histories.  (James Westby, #202830)

    * New ``post_change_branch_tip`` hook that is called after the

      branch tip is moved but while the branch is still write-locked.

      See the User Reference for signature details.

      (Ian Clatworthy, James Henstridge)

    * Reconfigure can convert a branch to be standalone or to use a shared

      repository.  (Aaron Bentley)

  IMPROVEMENTS:

    * The smart protocol now has support for setting branches' revision info

      directly.  This should make operations like push slightly faster, and is a

      step towards server-side hooks.  The new request method name is

      ``Branch.set_last_revision_info``.  (Andrew Bennetts)

    * ``bzr commit --fixes`` now recognises "gnome" as a tag by default.

      (James Westby, Andrew Cowie)

    * ``bzr switch`` will attempt to find branches to switch to relative to the

      current branch. E.g. ``bzr switch branchname`` will look for

      ``current_branch/../branchname``. (Robert Collins, Jelmer Vernooij,

      Wouter van Heyst)

    * Diff is now more specific about execute-bit changes it describes

      (Chad Miller)

    * Fetching data over HTTP is a bit faster when urllib is used.  This is done

      by forcing it to recv 64k at a time when reading lines in HTTP headers,

      rather than just 1 byte at a time.  (Andrew Bennetts)

    * Log --short and --line are much faster when -r is not specified.

      (Aaron Bentley)

    * Merge is faster.  We no longer check a file's existence unnecessarily

      when merging the execute bit.  (Aaron Bentley)

    * ``bzr status`` on an explicit list of files no longer shows pending

      merges, making it much faster on large trees. (John Arbash Meinel)

    * The launchpad directory service now warns the user if they have not set

      their launchpad login and are trying to resolve a URL using it, just

      in case they want to do a write operation with it.  (James Westby)

    * The smart protocol client is slightly faster, because it now only queries

      the server for the protocol version once per connection.  Also, the HTTP

      transport will now automatically probe for and use a smart server if

      one is present.  You can use the new ``nosmart+`` transport decorator

      to get the old behaviour.  (Andrew Bennetts)

     * Various operations with revision specs and commands that calculate

       revnos and revision ids are faster.  (John A. Meinel, Aaron Bentley)

  BUGFIXES:

    * Add ``root_client_path`` parameter to SmartWSGIApp and

      SmartServerRequest.  This makes it possible to publish filesystem

      locations that don't exactly match URL paths. SmartServerRequest

      subclasses should use the new ``translate_client_path`` and

      ``transport_from_client_path`` methods when dealing with paths received

      from a client to take this into account.  (Andrew Bennetts, #124089)

    * ``bzr mv a b`` can be now used also to rename previously renamed

      directories, not only files. (Lukáš Lalinský, #107967)

    * ``bzr uncommit --local`` can now remove revisions from the local

      branch to be symmetric with ``bzr commit --local``.

      (John Arbash Meinel, #93412)

    * Don't ask for a password if there is no real terminal.

      (Alexander Belchenko, #69851)

    * Fix a bug causing a ValueError crash in ``parse_line_delta_iter`` when

      fetching revisions from a knit to pack repository or vice versa using

      bzr:// (including over http or ssh).

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

    * Fixed ``_get_line`` in ``bzrlib.smart.medium``, which was buggy.  Also

      fixed ``_get_bytes`` in the same module to use the push back buffer.

      These bugs had no known impact in normal use, but were problematic for

      developers working on the code, and were likely to cause real bugs sooner

      or later.  (Andrew Bennetts)

    * Implement handling of basename parameter for DefaultMail.  (James Westby)

    * Incompatibility with Paramiko versions newer than 1.7.2 was fixed.

      (Andrew Bennetts, #213425)

    * Launchpad locations (lp: URLs) can be pulled.  (Aaron Bentley, #181945)

    * Merges that add files to deleted root directories complete.  They

      do create conflicts.  (Aaron Bentley, #210092)

    * vsftp's return ``550 RNFR command failed.`` supported.

      (Marcus Trautwig, #129786)

  DOCUMENTATION:

    * Improved documentation on send/merge relationship. (Peter Schuller)

    * Minor fixes to the User Guide. (Matthew Fuller)

    * Reduced the evangelism in the User Guide. (Ian Clatworthy)

    * Added Integrating with Bazaar document for developers (Martin Albisetti)

  API BREAKS:

    * Attempting to pull data from a ghost aware repository (e.g. knits) into a

      non-ghost aware repository such as weaves will now fail if there are

      ghosts.  (Robert Collins)

    * ``KnitVersionedFile`` no longer accepts an ``access_mode`` parameter, and

      now requires the ``index`` and ``access_method`` parameters to be

      supplied. A compatible shim has been kept in the new function

      ``knit.make_file_knit``. (Robert Collins)

    * Log formatters must now provide log_revision instead of show and

      show_merge_revno methods. The latter had been deprecated since the 0.17

      release. (James Westby)

    * ``LoopbackSFTP`` is now called ``SocketAsChannelAdapter``.

      (Andrew Bennetts)

    * ``osutils.backup_file`` is removed. (Alexander Belchenko)

    * ``Repository.get_revision_graph`` is deprecated, with no replacement

      method. The method was size(history) and not desirable. (Robert Collins)

    * ``revision.revision_graph`` is deprecated, with no replacement function.

      The function was size(history) and not desirable. (Robert Collins)

    * ``Transport.get_shared_medium`` is deprecated.  Use

      ``Transport.get_smart_medium`` instead.  (Andrew Bennetts)

    * ``VersionedFile`` factories now accept a get_scope parameter rather

      than using a call to ``transaction_finished``, allowing the removal of

      the fixed list of versioned files per repository. (Robert Collins)

    * ``VersionedFile.annotate_iter`` is deprecated. While in principle this

      allowed lower memory use, all users of annotations wanted full file 

      annotations, and there is no storage format suitable for incremental

      line-by-line annotation. (Robert Collins)

    * ``VersionedFile.clone_text`` is deprecated. This performance optimisation

      is no longer used - reading the content of a file that is undergoing a

      file level merge to identical state on two branches is rare enough, and

      not expensive enough to special case. (Robert Collins)

    * ``VersionedFile.clear_cache`` and ``enable_cache`` are deprecated.

      These methods added significant complexity to the ``VersionedFile``

      implementation, but were only used for optimising fetches from knits - 

      which can be done from outside the knit layer, or via a caching

      decorator. As knits are not the default format, the complexity is no

      longer worth paying. (Robert Collins)

    * ``VersionedFile.create_empty`` is removed. This method presupposed a

      sensible mapping to a transport for individual files, but pack backed

      versioned files have no such mapping. (Robert Collins)

    * ``VersionedFile.get_graph`` is deprecated, with no replacement method.

      The method was size(history) and not desirable. (Robert Collins)

    * ``VersionedFile.get_graph_with_ghosts`` is deprecated, with no

      replacement method.  The method was size(history) and not desirable.

      (Robert Collins)

    * ``VersionedFile.get_parents`` is deprecated, please use

      ``VersionedFile.get_parent_map``. (Robert Collins)

    * ``VersionedFile.get_sha1`` is deprecated, please use

      ``VersionedFile.get_sha1s``. (Robert Collins)

    * ``VersionedFile.has_ghost`` is now deprecated, as it is both expensive

      and unused outside of a single test. (Robert Collins)

    * ``VersionedFile.iter_parents`` is now deprecated in favour of

      ``get_parent_map`` which can be used to instantiate a Graph on a

      VersionedFile. (Robert Collins)

    * ``VersionedFileStore`` no longer uses the transaction parameter given

      to most methods; amongst other things this means that the

      get_weave_or_empty method no longer guarantees errors on a missing weave

      in a readonly transaction, and no longer caches versioned file instances

      which reduces memory pressure (but requires more careful management by

      callers to preserve performance). (Robert Collins)

  TESTING:

    * New -Dselftest_debug flag disables clearing of the debug flags during

      tests.  This is useful if you want to use e.g. -Dhpss to help debug a

      failing test.  Be aware that using this feature is likely to cause

      spurious test failures if used with the full suite. (Andrew Bennetts)

    * selftest --load-list now uses a new more agressive test loader that will

      avoid loading unneeded modules and building their tests. Plugins can use

      this new loader by defining a load_tests function instead of a test_suite

      function. (a forthcoming patch will provide many examples on how to

      implement this).

      (Vincent Ladeuil)

    * selftest --load-list now does some sanity checks regarding duplicate test

      IDs and tests present in the list but not found in the actual test suite.

      (Vincent Ladeuil)

    * Slightly more concise format for the selftest progress bar, so there's

      more space to show the test name.  (Martin Pool) ::

        [2500/10884, 1fail, 3miss in 1m29s] test_revisionnamespaces.TestRev

    * The test suite takes much less memory to run, and is a bit faster.  This

      is done by clearing most attributes of TestCases after running them, if

      they succeeded.  (Andrew Bennetts)

  INTERNALS:

    * Added ``_build_client_protocol`` to ``_SmartClient``.  (Andrew Bennetts)

    * Added basic infrastructure for automatic plugin suggestion.

      (Martin Albisetti)

    * If a ``LockableFiles`` object is not explicitly unlocked (for example

      because of a missing ``try/finally`` block, it will give a warning but

      not automatically unlock itself.  (Previously they did.)  This

      sometimes caused knock-on errors if for example the network connection

      had already failed, and should not be relied upon by code. 

      (Martin Pool, #109520)

    * The ``read_response_tuple`` method of ``SmartClientRequestProtocol*``

      classes will now raise ``UnknownSmartMethod`` when appropriate, so that

      callers don't need to try distinguish unknown request errors from other

      errors.  (Andrew Bennetts)

    * ``set_make_working_trees`` is now implemented provided on all repository

      implementations (Aaron Bentley)

    * ``VersionedFile`` now has a new method ``get_parent_map`` which, like

      ``Graph.get_parent_map`` returns a dict of key:parents. (Robert Collins)

bzr 1.3 2008-03-20

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

Bazaar has become part of the GNU project <http://www.gnu.org>

Many operations that act on history, including ``log`` and ``annotate`` are now

substantially faster.  Several bugs have been fixed and several new options and

features have been added.

  TESTING:

    * Avoid spurious failure of ``TestVersion.test_version`` matching

      directory names.

      (#202778, Martin Pool)

bzr 1.3rc1 2008-03-16

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

  NOTES WHEN UPGRADING:

    * The backup directory created by ``upgrade`` is now called

      ``backup.bzr``, not ``.bzr.backup``. (Martin Albisetti)

  CHANGES:

    * A new repository format 'development' has been added. This format will

      represent the latest 'in-progress' format that the bzr developers are

      interested in getting early-adopter testing and feedback on.

      ``doc/developers/development-repo.txt`` has detailed information.

      (Robert Collins)

    * BZR_LOG environment variable controls location of .bzr.log trace file. 

      User can suppress writing messages to .bzr.log by using '/dev/null'

      filename (on Linux) or 'NUL' (on Windows). If BZR_LOG variable 

      is not defined but BZR_HOME is defined then default location

      for .bzr.log trace file is ``$BZR_HOME/.bzr.log``.

      (Alexander Belchenko)

    * ``launchpad`` builtin plugin now shipped as separate part in standalone

      bzr.exe, installed to ``C:\Program Files\Bazaar\plugins`` directory, 

      and standalone installer allows user to skip installation of this plugin.

      (Alexander Belchenko)

    * Restore auto-detection of plink.exe on Windows. (Dmitry Vasiliev)

    * Version number is now shown as "1.2" or "1.2pr2", without zeroed or

      missing final fields.  (Martin Pool)

  FEATURES:

    * ``branch`` and ``checkout`` can hard-link working tree files, which is

      faster and saves space.  (Aaron Bentley)

    * ``bzr send`` will now also look at the ``child_submit_to`` setting in

      the submit branch to determine the email address to send to. 

      (Jelmer Vernooij)

  IMPROVEMENTS:

    * BzrBranch._lefthand_history is faster on pack repos.  (Aaron Bentley)

    * Branch6.generate_revision_history is faster.  (Aaron Bentley)

    * Directory services can now be registered, allowing special URLs to be

      dereferenced into real URLs.  This is a generalization and cleanup of

      the lp: transport lookup.  (Aaron Bentley)

    * Merge directives that are automatically attached to emails have nicer

      filenames, based on branch-nick + revno. (Aaron Bentley)

    * ``push`` has a ``--revision`` option, to specify what revision to push up

      to.  (Daniel Watkins)

    * Significantly reducing execution time and network traffic for trivial 

      case of running ``bzr missing`` command for two identical branches.

      (Alexander Belchenko)

    * Speed up operations that look at the revision graph (such as 'bzr log').

      ``KnitPackRepositor.get_revision_graph`` uses ``Graph.iter_ancestry`` to

      extract the revision history. This allows filtering ghosts while

      stepping instead of needing to peek ahead. (John Arbash Meinel)

    * The ``hooks`` command lists installed hooks, to assist in debugging.

      (Daniel Watkins)

    * Updates to how ``annotate`` work. Should see a measurable improvement in

      performance and memory consumption for file with a lot of merges.

      Also, correctly handle when a line is introduced by both parents (it

      should be attributed to the first merge which notices this, and not

      to all subsequent merges.) (John Arbash Meinel)

  BUGFIXES:

    * Autopacking no longer holds the full set of inventory lines in

      memory while copying. For large repositories, this can amount to

      hundreds of MB of ram consumption.

      (Ian Clatworthy, John Arbash Meinel)

    * Cherrypicking when using ``--format=merge3`` now explictly excludes

      BASE lines. (John Arbash Meinel, #151731)

    * Disable plink's interactive prompt for password.

      (#107593, Dmitry Vasiliev)

    * Encode command line arguments from unicode to user_encoding before

      invoking external mail client in `bzr send` command.

      (#139318, Alexander Belchenko)

    * Fixed problem connecting to ``bzr+https://`` servers.

      (#198793, John Ferlito)

    * Improved error reporting in the Launchpad plugin. (Daniel Watkins,

      #196618)

    * Include quick-start-summary.svg file to python-based installer(s)

      for Windows. (#192924, Alexander Belchenko)

    * lca merge now respects specified files. (Aaron Bentley)

    * Make version-info --custom imply --all. (#195560, James Westby)

    * ``merge --preview`` now works for merges that add or modify

      symlinks (James Henstridge)

    * Redirecting the output from ``bzr merge`` (when the remembered

      location is used) now works. (John Arbash Meinel)

    * setup.py script explicitly checks for Python version.

      (Jari Aalto, Alexander Belchenko, #200569)

    * UnknownFormatErrors no longer refer to branches regardless of kind of

      unknown format. (Daniel Watkins, #173980)

    * Upgrade bundled ConfigObj to version 4.5.2, which properly quotes #

      signs, among other small improvements. (Matt Nordhoff, #86838)

    * Use correct indices when emitting LCA conflicts.  This fixes IndexError

      errors.  (Aaron Bentley, #196780)

  DOCUMENTATION:

    * Explained how to use ``version-info --custom`` in the User Guide.

      (Neil Martinsen-Burrell)

  API BREAKS:

    * Support for loading plugins from zip files and

      ``bzrlib.plugin.load_from_zip()`` function are deprecated.

      (Alexander Belchenko)

  TESTING:

    * The branch interface tests were invalid for branches using rich-root

      repositories because the empty string is not a valid file-id.

      (Robert Collins)

  INTERNALS:

    * ``Graph.iter_ancestry`` returns the ancestry of revision ids. Similar to

      ``Repository.get_revision_graph()`` except it includes ghosts and you can

      stop part-way through. (John Arbash Meinel)

    * New module ``tools/package_mf.py`` provide custom module finder for

      python packages (improves standard python library's modulefinder.py)

      used by ``setup.py`` script while building standalone bzr.exe.

      (Alexander Belchenko)

    * New remote method ``RemoteBzrDir.find_repositoryV2`` adding support for

      detecting external lookup support on remote repositories. This method is

      now attempted first when lookup up repositories, leading to an extra 

      round trip on older bzr smart servers. (Robert Collins)

    * Repository formats have a new supported-feature attribute

      ``supports_external_lookups`` used to indicate repositories which support

      falling back to other repositories when they have partial data.

      (Robert Collins)

    * ``Repository.get_revision_graph_with_ghosts`` and

      ``bzrlib.revision.(common_ancestor,MultipleRevisionSources,common_graph)``

      have been deprecated.  (John Arbash Meinel)

    * ``Tree.iter_changes`` is now a public API, replacing the work-in-progress

      ``Tree._iter_changes``. The api is now considered stable and ready for

      external users.  (Aaron Bentley)

    * The bzrdir format registry now accepts an ``alias`` keyword to

      register_metadir, used to indicate that a format name is an alias for

      some other format and thus should not be reported when describing the

      format. (Robert Collins)

bzr 1.2 2008-02-15

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

  BUG FIXES:

    * Fix failing test in Launchpad plugin. (Martin Pool)

bzr 1.2rc1 2008-02-13

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

  NOTES WHEN UPGRADING:

    * Fetching via the smart protocol may need to reconnect once during a fetch

      if the remote server is running Bazaar 1.1 or earlier, because the client

      attempts to use more efficient requests that confuse older servers.  You

      may be required to re-enter a password or passphrase when this happens.

      This won't happen if the server is upgraded to Bazaar 1.2.

      (Andrew Bennetts)

  CHANGES:

    * Fetching via bzr+ssh will no longer fill ghosts by default (this is

      consistent with pack-0.92 fetching over SFTP). (Robert Collins)

    * Formatting of ``bzr plugins`` output is changed to be more human-

      friendly. Full path of plugins locations will be shown only with

      ``--verbose`` command-line option. (Alexander Belchenko)

    * ``merge`` now prefers to use the submit branch, but will fall back to

      parent branch.  For many users, this has no effect.  But some users who

      pull and merge on the same branch will notice a change.  This change

      makes it easier to work on a branch on two different machines, pulling

      between the machines, while merging from the upstream.

      ``merge --remember`` can now be used to set the submit_branch.

      (Aaron Bentley)

  FEATURES:

    * ``merge --preview`` produces a diff of the changes merge would make,

      but does not actually perform the merge.  (Aaron Bentley)

    * New smart method ``Repository.get_parent_map`` for getting revision

      parent data. This returns additional parent information topologically

      adjacent to the requested data to reduce round trip latency impacts.

      (Robert Collins)

    * New smart method, ``Repository.stream_revisions_chunked``, for fetching

      revision data that streams revision data via a chunked encoding.  This

      avoids buffering large amounts of revision data on the server and on the

      client, and sends less data to the server to request the revisions.

      (Andrew Bennetts, Robert Collins, #178353)

    * The launchpad plugin now handles lp urls of the form

      ``lp://staging/``, ``lp://demo/``, ``lp://dev/`` to use the appropriate

      launchpad instance to do the resolution of the branch identities.

      This is primarily of use to Launchpad developers, but can also

      be used by other users who want to try out Launchpad as

      a branch location without messing up their public Launchpad

      account.  Branches that are pushed to the staging environment

      have an expected lifetime of one day. (Tim Penhey)

  IMPROVEMENTS:

    * Creating a new branch no longer tries to read the entire revision-history

      unnecessarily over smart server operations. (Robert Collins)

    * Fetching between different repository formats with compatible models now

      takes advantage of the smart method to stream revisions.  (Andrew Bennetts)