~abentley/bzrtools/bzrtools.dev

Shelf for Bzr

=============

This is the shelf plugin for bzr.

Temporarily set aside some changes from the current tree.

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.

Shelve is intended to help separate several sets of text changes that have

been inappropriately mingled.  If you just want to get rid of all changes

(text and otherwise) and you don't need to restore them later, use revert.

By default shelve asks you what you want to shelve, press '?' at the

prompt to get help. To shelve everything run shelve --all.

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.

You can put multiple items on the shelf. Normally each time you run

unshelve the most recently shelved changes will be reinstated. However,

you can also unshelve changes in a different order by explicitly

specifiying which changes to unshelve. This works best when the changes

don't depend on each other.

    --all                     Shelve all changes without prompting

    --message ARG, -m

    --revision ARG, -r

More Info

=========

http://bazaar.canonical.com/BzrShelveExample