shelve
======

:Purpose: Temporarily set aside some changes from the current tree.
:Usage:   bzr shelve [FILE...]

:Options:
  --all                 Shelve all changes.
  -v, --verbose         Display more information.
  --list                List shelved changes.
  -h, --help            Show help message.
  -q, --quiet           Only display errors and warnings.
  -d ARG, --directory=ARG
                        Branch to operate on, instead of working directory
  --usage               Show usage message and options.
  --destroy             Destroy removed changes instead of shelving them.
  -m ARG, --message=ARG
                        Message string.
  -r ARG, --revision=ARG
                        See "help revisionspec" for details.

  writer:
    --plain             Plaintext diff output.

:Description:
  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.  The changes are stored alongside
  your working tree, and so they aren't propagated along with your branch nor
  will they survive its deletion.
  
  If shelve --list is specified, previously-shelved changes are listed.
  
  Shelve is intended to help separate several sets of changes that have
  been inappropriately mingled.  If you just want to get rid of all changes
  and you don't need to restore them later, use revert.  If you want to
  shelve all text changes at once, use 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, and by default, 'unshelve' will
  restore the most recently shelved changes.

:See also: :doc:`unshelve <unshelve-help>`