~abentley/bzrtools/bzrtools.dev

BZR TOOLS

This is is a set of plugins for bzr.

BAZ-IMPORT

baz-import will import an Arch or Baz Archive into a bzr repository.

Data converted:

- source tree

- file ids

- revision ids

- logs

- merge data

After more commits are made to the baz/arch branch, you can re-run baz-import

to import just those changes.

BAZ-IMPORT-BRANCH

baz-import-branch will import an Arch or Baz Branch into a bzr standalone tree.

See baz-import for conversion details.

BRANCHES

List all the branches present at, or underneath, a location.

BRANCH-HISTORY

Show a history of the branch, separated by committer and branch nick.

CBRANCH

Create a branch in a repository and a checkout elsewhere, in one command.

CDIFF

cdiff mimics bzr diff, but displays the diff in colour. cdiff knows how

to read a ~/.colordiffrc file, in the same format as for colordiff(1).

# example ~/.colordiffrc

plain=darkwhite

newtext=darkblue

oldtext=darkred

diffstuff=darkgreen

CLEAN-TREE

Delete unknown, ignored, or detritus files, leaving versioned files untouched.

FETCH-GHOSTS

Scan this branch for missing ancestors (aka "ghosts), and attempt to retrieve

them from a specified branch.

GRAPH-ANCESTRY

Use dot (from Graphviz) to produce graphics of a tree's ancestry.

IMPORT

Import a tarball into a bzr branch, or update to a fresh tarball.

PATCH

Use patch to apply a patch to this tree.

MULTI-PULL

Pull all branches and checkouts at or underneath the current location.

RSPUSH

Uses rsync to copy a branch to a remote location.  Remembers the last location

used.  Will not push if

- there are unknown files

- there are uncommitted changes in the working tree.

These safeguards are intended to prevent dirty trees from being uploaded.

SHELL

An interactive shell with bzr commands available as single commands, and

nice shell completion.

SHELVE/UNSHELVE/SHELF

Shelve allows you to temporarily put changes you've made "on the shelf",

ie. out of the way, until a later time when you can bring them back from

the shelf with the 'unshelve' command.

You can put multiple items on the shelf, each time you run unshelve the

most recently shelved changes will be reinstated.

If filenames are specified, only the changes to those files will be

shelved, other files will be left untouched.

If a revision is specified, changes since that revision will be shelved.

If you specifiy "--pick" you'll be prompted for each hunk of the diff as

to whether you want to shelve it or not. Press "?" at the prompt for help.

SHOW-PATHS

List the locations used by a branch or checkout.

More Info

=========

http://bazaar.canonical.com/BzrShelveExample

SWITCH

Change the branch associated with a lightweight checkout, and update the tree

while retaining local changes.

ZAP

Safely remove undesired checkouts.