~bzr-pqm/bzr/bzr.dev

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

Bazaar Release Notes

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

.. toctree::

   :maxdepth: 1

bzr 1.4 

#######

:Released: 2008-04-28

This release of Bazaar includes handy improvements to the speed of log and

status, new options for several commands, improved documentation, and better

hooks, including initial code for server-side hooks.  A number of bugs have

been fixed, particularly in interoperability between different formats or

different releases of Bazaar over there network.  There's been substantial

internal work in both the repository and network code to enable new features

and faster performance.

Bug Fixes

*********

* 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, Andrew Bennetts, #214894)

bzr 1.4rc2

##########

:Released: 2008-04-21

Bug Fixes

*********

* ``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)

* Fixed a bug in handling ghost revisions when logging changes in a

  particular file.  (John Arbash Meinel, #209948)

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

  (Andrew Bennetts, #205156)

* Fixed 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)

bzr 1.4rc1

##########

:Released: 2008-04-11

Changes

*******

* bzr main script cannot be imported (Benjamin Peterson)

* On GNU/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)

* The ``version`` command takes a ``--short`` option to print just the

  version number, for easier use in scripts.  (Martin Pool)

* 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)

* ``make dist`` target to build a release tarball, and also

  ``check-dist-tarball`` and ``dist-upload-escudero``.  (Martin Pool)

* 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)

..

   vim: tw=74 ft=rst ff=unix