/brz/remove-bazaar

IN DEVELOPMENT

  NOTES WHEN UPGRADING:

    * ``bzr remove`` and ``bzr rm`` will now remove the working file, if

      it could be recovered again.

      This has been done for consistency with svn and the unix rm command.

      The old ``remove`` behaviour has been retained in the new option

      ``bzr remove --keep``, which will just stop versioning the file,

      but not delete it.

      ``bzr remove --force`` have been added which will always delete the

      files.

      ``bzr remove`` is also more verbose.

      (Marius Kruger, #82602)

  IMPROVEMENTS:

    * Merge directives can now be supplied as input to `merge` and `pull`,

      like bundles can.  (Aaron Bentley)

    * Sending the SIGQUIT signal to bzr, which can be done on Unix by

      pressing Control-Backslash, drops bzr into a debugger.  Type `c`

      to continue.  This can be disabled by setting the environment variable

      BZR_SIGQUIT_PDB=0.  (Martin Pool)

    * selftest now supports --list-only to list tests instead of running

      them. (Ian Clatworthy)

    * selftest now supports --exclude PATTERN (or -x PATTERN) to exclude

      tests with names that match that regular expression.

      (Ian Clatworthy, #102679)

    * selftest now supports --randomize SEED to run tests in a random order.

      SEED is typically the value 'now' meaning 'use the current time'.

      (Ian Clatworthy, #102686)

    * New option ``--fixes`` to commit, which stores bug fixing annotations as

      revision properties. Built-in support for Launchpad, Debian, Trac and

      Bugzilla bug trackers. (Jonathan Lange, James Henstridge, Robert Collins)

    * New API, ``bzrlib.bugtracker.tracker_registry``, for adding support for

      other bug trackers to ``fixes``. (Jonathan Lange, James Henstridge,

      Robert Collins)

    * ``selftest`` has new short options ``-f`` and ``-1``.  (Martin

      Pool)

    * ``bzrlib.tsort.MergeSorter`` optimizations. Change the inner loop

      into using local variables instead of going through ``self._var``.

      Improves the time to ``merge_sort`` a 10k revision graph by

      approximately 40% (~700->400ms).  (John Arbash Meinel)

    * ``make docs`` now creates a man page at ``man1/bzr.1`` fixing bug 107388.

      (Robert Collins)

    * ``bzr help`` now provides cross references to other help topics using

      the _see_also facility on command classes. Likewise the bzr_man

      documentation, and the bzr.1 man page also include this information.

      (Robert Collins)

    * Tags are now included in logs, that use the long log formatter. 

      (Erik Bågfors, Alexander Belchenko)

    * ``bzr help`` provides a clearer message when a help topic cannot be

      found (fixes bug 107656). (Robert Collins)

    * ``bzr help`` now accepts optional prefixes for command help. The help

      for all commands can now be found at ``bzr help commands/COMMANDNAME``

      as well as ``bzr help COMMANDNAME`` (which only works for commands 

      where the name is not the same as a more general help topic). 

      (Robert Collins)

    * ``bzr help PLUGINNAME`` will now return the module docstring from the

      plugin PLUGINNAME fixing bug 50408. (Robert Collins)

    * New help topic ``urlspec`` which lists the availables transports.

      (Goffredo Baroncelli)

    * doc/server.txt updated to document the default bzr:// port (fixes

      #107125) and also update the blurb about the hpss' current status.

      (Robert Collins).

    * ``bzr serve`` now listens on interface 0.0.0.0 by default, making it

      serve out to the local LAN (and anyone in the world that can reach the

      machine running ``bzr serve``. (Robert Collins, #98918)

    * A new smart server protocol version has been added.  It prefixes requests

      and responses with an explicit version identifier so that future protocol

      revisions can be dealt with gracefully.  (Andrew Bennetts, Robert Collins)

  INTERNALS:

    * bzrlib API compatability with 0.8 has been dropped, cleaning up some

      code paths. (Robert Collins)

    * Change the format of chroot urls so that they can be safely manipulated

      by generic url utilities without causing the resulting urls to have

      escaped the chroot. A side effect of this is that creating a chroot

      requires an explicit action using a ChrootServer.

      (Robert Collins, Andrew Bennetts)

    * Deprecate Branch.get_root_id() because branches don't have root ids,

      rather than fixing bug #96847.  (Aaron Bentley)

    * WorkingTree.apply_inventory_delta provides a better alternative to

      WorkingTree._write_inventory.  (Aaron Bentley)

    * Convenience method TestCase.expectFailure ensures that known failures

      do not silently pass.  (Aaron Bentley)

    * Transport.local_abspath now raises NotLocalUrl rather than 

      TransportNotPossible. (Martin Pool, Ian Clatworthy)

    * New SmartServer hooks facility. There are two initial hooks documented

      in bzrlib.transport.smart.SmartServerHooks. The two initial hooks allow

      plugins to execute code upon server startup and shutdown.

      (Robert Collins).

    * SmartServer in standalone mode will now close its listening socket

      when it stops, rather than waiting for garbage collection. This primarily

      fixes test suite hangs when a test tries to connect to a shutdown server.

      It may also help improve behaviour when dealing with a server running

      on a specific port (rather than dynamically assigned ports).

      (Robert Collins)

    * Move most SmartServer code into a new package, bzrlib/smart.

      bzrlib/transport/remote.py contains just the Transport classes that used

      to be in bzrlib/transport/smart.py.  (Andrew Bennetts)

    * Renamed SmartTransport (and subclasses like SmartTCPTransport) to

      RemoteTransport (and subclasses to RemoteTCPTransport, etc).  This is more

      consistent with its new home in bzrlib/transport/remote.py, and because

      it's not really a "smart" transport, just one that does file operations

      via remote procedure calls.  (Andrew Bennetts)

    * The ``lock_write`` method of ``LockableFiles``, ``Repository`` and

      ``Branch`` now accept a ``token`` keyword argument, so that separate

      instances of those objects can share a lock if it has the right token.

      (Andrew Bennetts, Robert Collins)

    * New method 'get_branch_reference' on 'BzrDir' allows the detection of

      branch references - which the smart server component needs.

    * The Repository API ``make_working_trees`` is now permitted to return

      False when ``set_make_working_trees`` is not implemented - previously

      an unimplemented ``set_make_working_trees`` implied the result True

      from ``make_working_trees``. This has been changed to accomodate the

      smart server, where it does not make sense (at this point) to ever

      make working trees by default. (Robert Collins)

    * Command objects can now declare related help topics by having _see_also

      set to a list of related topic. (Robert Collins)

    * ``bzrlib.help`` now delegates to the Command class for Command specific

      help. (Robert Collins)

    * New class 'TransportListRegistry', derived from the Registry class, which 

      simplifies tracking the available Transports. (Goffredo Baroncelli)

    * New function ``Branch.get_revision_id_to_revno_map`` which will

      return a dictionary mapping revision ids to dotted revnos. Since

      dotted revnos are defined in the context of the branch tip, it makes

      sense to generate them from a ``Branch`` object.

      (John Arbash Meinel)

    * Fix the 'Unprintable error' message display to use the repr of the 

      exception that prevented printing the error because the str value

      for it is often not useful in debugging (e.g. KeyError('foo') has a

      str() of 'foo' but a repr of 'KeyError('foo')' which is much more

      useful. (Robert Collins)

  BUGFIXES:

    * Don't fail bundle selftest if email has 'two' embedded.  

      (#98510, Ian Clatworthy)

    * Remove ``--verbose`` from ``bzr bundle``. It didn't work anyway.

      (Robert Widhopf-Fenk, #98591)

    * Remove ``--basis`` from the checkout/branch commands - it didn't work

      properly and is no longer beneficial. Fixes #53675 and #43486.

      (Robert Collins)

    * Don't produce encoding error when adding duplicate files.

      (Aaron Bentley)

    * Fix ``bzr log <file>`` so it only logs the revisions that changed

      the file, and does it faster.

      (Kent Gibson, John Arbash Meinel, #51980, #69477)

    * Fix ``InterDirstateTre._iter_changes`` to handle when we come across

      an empty versioned directory, which now has files in it.

      (John Arbash Meinel, #104257)

    * Teach ``common_ancestor`` to shortcut when the tip of one branch is

      inside the ancestry of the other. Saves a lot of graph processing

      (with an ancestry of 16k revisions, ``bzr merge ../already-merged``

      changes from 2m10s to 13s).  (John Arbash Meinel, #103757)

    * Fix ``show_diff_trees`` to handle the case when a file is modified,

      and the containing directory is renamed. (The file path is different

      in this versus base, but it isn't marked as a rename).

      (John Arbash Meinel, #103870)

    * FTP now works even when the FTP server does not support atomic rename.

      (Aaron Bentley, #89436)

    * Typo in the help for ``register-branch`` fixed. (Robert Collins, #96770)

    * "dirstate" and "dirstate-tags" formats now produce branches compatible

      with old versions of bzr. (Aaron Bentley, #107168))

    * Handle moving a directory when children have been added, removed,

      and renamed. (John Arbash Meinel, #105479)

  TESTING:

    * Added ``bzrlib.strace.strace`` which will strace a single callable and

      return a StraceResult object which contains just the syscalls involved

      in running it. (Robert Collins)

    * New test method ``reduceLockdirTimeout`` to drop the default (ui-centric)

      default time down to one suitable for tests. (Andrew Bennetts)

    * Add new vfs_transport_factory attribute on tests which provides the 

      common vfs backing for both the readonly and readwrite transports.

      This allows the RemoteObject tests to back onto local disk or memory,

      and use the existing transport_server attribute all tests know about

      to be the smart server transport. This in turn allows tests to 

      differentiate between 'transport to access the branch', and 

      'transport which is a VFS' - which matters in Remote* tests.

      (Robert Collins, Andrew Bennetts)

    * The ``make_branch_and_tree`` method for tests will now create a 

      lightweight checkout for the tree if the vfs_transport_factory is not

      a LocalURLServer. (Robert Collins, Andrew Bennetts)

    * Branch implementation tests have been audited to ensure that all urls 

      passed to Branch APIs use proper urls, except when local-disk paths

      are intended. This is so that tests correctly access the test transport

      which is often not equivalent to local disk in Remote* tests. As part

      of this many tests were adjusted to remove dependencies on local disk

      access.

      (Robert Collins, Andrew Bennetts)

    * Mark bzrlib.tests and bzrlib.tests.TestUtil as providing assertFOO helper

      functions by adding a __unittest global attribute. (Robert Collins,

      Andrew Bennetts, Martin Pool, Jonathan Lange)

bzr 0.15 2007-04-01

  BUGFIXES:

    * Handle incompatible repositories as a user issue when fetching.

      (Aaron Bentley)

    * Don't give a recommendation to upgrade when branching or 

      checking out a branch that contains an old-format working tree.

      (Martin Pool)

bzr 0.15rc3  2007-03-26

  CHANGES:

    * A warning is now displayed when opening working trees in older 

      formats, to encourage people to upgrade to WorkingTreeFormat4.

      (Martin Pool)

  IMPROVEMENTS:

    * HTTP redirections are now taken into account when a branch (or a

      bundle) is accessed for the first time. A message is issued at each

      redirection to inform the user. In the past, http redirections were

      silently followed for each request which significantly degraded the

      performances. The http redirections are not followed anymore by

      default, instead a RedirectRequested exception is raised. For bzrlib

      users needing to follow http redirections anyway,

      bzrlib.transport.do_catching_redirections provide an easy transition

      path.  (vila)

  INTERNALS:

    * Added ``ReadLock.temporary_write_lock()`` to allow upgrading an OS read

      lock to an OS write lock. Linux can do this without unlocking, Win32

      needs to unlock in between. (John Arbash Meinel)

    * New parameter ``recommend_upgrade`` to BzrDir.open_workingtree 

      to silence (when false) warnings about opening old formats.

      (Martin Pool)

    * Fix minor performance regression with bzr-0.15 on pre-dirstate

      trees. (We were reading the working inventory too many times).

      (John Arbash Meinel)

    * Remove ``Branch.get_transaction()`` in favour of a simple cache of

      ``revision_history``.  Branch subclasses should override

      ``_gen_revision_history`` rather than ``revision_history`` to make use of

      this cache, and call ``_clear_revision_history_cache`` and

      ``_cache_revision_history`` at appropriate times. (Andrew Bennetts)

  BUGFIXES:

    * Take smtp_server from user config into account.

      (vila, #92195)

    * Restore Unicode filename handling for versioned and unversioned files.

      (John Arbash Meinel, #92608)

    * Don't fail during ``bzr commit`` if a file is marked removed, and

      the containing directory is auto-removed.  (John Arbash Meinel, #93681)

    * ``bzr status FILENAME`` failed on Windows because of an uncommon

      errno. (``ERROR_DIRECTORY == 267 != ENOTDIR``).

      (Wouter van Heyst, John Arbash Meinel, #90819)

    * ``bzr checkout source`` should create a local branch in the same

      format as source. (John Arbash Meinel, #93854)

    * ``bzr commit`` with a kind change was failing to update the

      last-changed-revision for directories.  The

      InventoryDirectory._unchanged only looked at the parent_id and name,

      ignoring the fact that the kind could have changed, too.

      (John Arbash Meinel, #90111)

    * ``bzr mv dir/subdir other`` was incorrectly updating files inside

      the directory. So that there was a chance it would break commit,

      etc. (John Arbash Meinel, #94037)

    * Correctly handles mutiple permanent http redirections.

     (vila, #88780)

bzr 0.15rc2  2007-03-14

  NOTES WHEN UPGRADING:

    * Release 0.15rc2 of bzr changes the ``bzr init-repo`` command to

      default to ``--trees`` instead of ``--no-trees``.

      Existing shared repositories are not affected.

  IMPROVEMENTS:

    * New ``merge-directive`` command to generate machine- and human-readable

      merge requests.  (Aaron Bentley)

    * New ``submit:`` revision specifier makes it easy to diff against the

      common ancestor with the submit location (Aaron Bentley)

    * Added support for Putty's SSH implementation. (Dmitry Vasiliev)

    * Added ``bzr status --versioned`` to report only versioned files, 

      not unknowns. (Kent Gibson)

    * Merge now autodetects the correct line-ending style for its conflict

      markers.  (Aaron Bentley)

  INTERNALS:

    * Refactored SSH vendor registration into SSHVendorManager class.

      (Dmitry Vasiliev)

  BUGFIXES:

    * New ``--numbered-dirs`` option to ``bzr selftest`` to use

      numbered dirs for TestCaseInTempDir. This is default behavior

      on Windows. Anyone can force named dirs on Windows

      with ``--no-numbered-dirs``. (Alexander Belchenko)

    * Fix ``RevisionSpec_revid`` to handle the Unicode strings passed in

      from the command line. (Marien Zwart, #90501)

    * Fix ``TreeTransform._iter_changes`` when both the source and

      destination are missing. (Aaron Bentley, #88842)

    * Fix commit of merges with symlinks in dirstate trees.

      (Marien Zwart)

    * Switch the ``bzr init-repo`` default from --no-trees to --trees. 

      (Wouter van Heyst, #53483)

bzr 0.15rc1  2007-03-07

  SURPRISES:

    * The default disk format has changed. Please run 'bzr upgrade' in your

      working trees to upgrade. This new default is compatible for network

      operations, but not for local operations. That is, if you have two

      versions of bzr installed locally, after upgrading you can only use the

      bzr 0.15 version. This new default does not enable tags or nested-trees

      as they are incompatible with bzr versions before 0.15 over the network.

    * For users of bzrlib: Two major changes have been made to the working tree

      api in bzrlib. The first is that many methods and attributes, including

      the inventory attribute, are no longer valid for use until one of

      lock_read/lock_write/lock_tree_write has been called, and become invalid

      again after unlock is called. This has been done to improve performance

      and correctness as part of the dirstate development. (Robert Collins,

      John A Meinel, Martin Pool, and others).

    * For users of bzrlib: The attribute 'tree.inventory' should be considered

      readonly. Previously it was possible to directly alter this attribute, or

      its contents, and have the tree notice this. This has been made

      unsupported - it may work in some tree formats, but in the newer dirstate

      format such actions will have no effect and will be ignored, or even

      cause assertions. All operations possible can still be carried out by a

      combination of the tree API, and the bzrlib.transform API. (Robert

      Collins, John A Meinel, Martin Pool, and others).

  IMPROVEMENTS:

    * Support for OS Windows 98. Also .bzr.log on any windows system

      saved in My Documents folder. (Alexander Belchenko)

    * ``bzr mv`` enhanced to support already moved files.

      In the past the mv command would have failed if the source file doesn't

      exist. In this situation ``bzr mv`` would now detect that the file has

      already moved and update the repository accordingly, if the target file

      does exist.

      A new option ``--after`` has been added so that if two files already

      exist, you could notify Bazaar that you have moved a (versioned) file

      and replaced it with another. Thus in this case ``bzr move --after``

      will only update the Bazaar identifier.

      (Steffen Eichenberg, Marius Kruger)

    * ``ls`` now works on treeless branches and remote branches.

      (Aaron Bentley)

    * ``bzr help global-options`` describes the global options.

      (Aaron Bentley)

    * ``bzr pull --overwrite`` will now correctly overwrite checkouts.

      (Robert Collins)

    * Files are now allowed to change kind (e.g. from file to symlink).

      Supported by ``commit``, ``revert`` and ``status``

      (Aaron Bentley)

    * ``inventory`` and ``unknowns`` hidden in favour of ``ls``

      (Aaron Bentley)

    * ``bzr help checkouts`` descibes what checkouts are and some possible

      uses of them. (James Westby, Aaron Bentley)

    * A new ``-d`` option to push, pull and merge overrides the default 

      directory.  (Martin Pool)

    * Branch format 6: smaller, and potentially faster than format 5.  Supports

      "append_history_only" mode, where the log view and revnos do not change,

      except by being added to.  Stores policy settings in

      ".bzr/branch/branch.conf".

    * append_only branches:  Format 6 branches may be configured so that log

      view and revnos are always consistent.  Either create the branch using

      "bzr init --append-revisions-only" or edit the config file as descriped

      in docs/configuration.txt.

    * rebind: Format 6 branches retain the last-used bind location, so if you

      "bzr unbind", you can "bzr bind" to bind to the previously-selected

      bind location.

    * Builtin tags support, created and deleted by the ``tag`` command and

      stored in the branch.  Tags can be accessed with the revisionspec

      ``-rtag:``, and listed with ``bzr tags``.  Tags are not versioned 

      at present. Tags require a network incompatible upgrade. To perform this

      upgrade, run ``bzr upgrade --dirstate-tags`` in your branch and

      repositories. (Martin Pool)

    * The bzr:// transport now has a well-known port number, 4155, which it will

      use by default.  (Andrew Bennetts, Martin Pool)

    * Bazaar now looks for user-installed plugins before looking for site-wide

      plugins. (Jonathan Lange)

    * ``bzr resolve`` now detects and marks resolved text conflicts.

      (Aaron Bentley)

  INTERNALS:

    * Internally revision ids and file ids are now passed around as utf-8

      bytestrings, rather than treating them as Unicode strings. This has

      performance benefits for Knits, since we no longer need to decode the

      revision id for each line of content, nor for each entry in the index.

      This will also help with the future dirstate format.

      (John Arbash Meinel)

    * Reserved ids (any revision-id ending in a colon) are rejected by

      versionedfiles, repositories, branches, and working trees

      (Aaron Bentley)

    * Minor performance improvement by not creating a ProgressBar for

      every KnitIndex we create. (about 90ms for a bzr.dev tree)

      (John Arbash Meinel)

    * New easier to use Branch hooks facility. There are five initial hooks,

      all documented in bzrlib.branch.BranchHooks.__init__ - 'set_rh',

      'post_push', 'post_pull', 'post_commit', 'post_uncommit'. These hooks

      fire after the matching operation on a branch has taken place, and were

      originally added for the branchrss plugin. (Robert Collins)