~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README.Shelf

  • Committer: Aaron Bentley
  • Date: 2006-03-24 17:24:21 UTC
  • Revision ID: abentley@panoramicfeedback.com-20060324172421-c1acc18c1a4075a6
Added multi-pull, working on branches and checkouts

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
 
4
4
This is the shelf plugin for bzr.
5
5
 
6
 
Temporarily set aside some changes from the current tree.
7
 
 
8
6
Shelve allows you to temporarily put changes you've made "on the shelf",
9
7
ie. out of the way, until a later time when you can bring them back from
10
8
the shelf with the 'unshelve' command.
11
9
 
12
 
Shelve is intended to help separate several sets of text changes that have
13
 
been inappropriately mingled.  If you just want to get rid of all changes
14
 
(text and otherwise) and you don't need to restore them later, use revert.
15
 
 
16
 
By default shelve asks you what you want to shelve, press '?' at the
17
 
prompt to get help. To shelve everything run shelve --all.
 
10
You can put multiple items on the shelf, each time you run unshelve the
 
11
most recently shelved changes will be reinstated.
18
12
 
19
13
If filenames are specified, only the changes to those files will be
20
14
shelved, other files will be left untouched.
21
15
 
22
16
If a revision is specified, changes since that revision will be shelved.
23
17
 
24
 
You can put multiple items on the shelf. Normally each time you run
25
 
unshelve the most recently shelved changes will be reinstated. However,
26
 
you can also unshelve changes in a different order by explicitly
27
 
specifiying which changes to unshelve. This works best when the changes
28
 
don't depend on each other.
29
 
 
30
 
    --all                     Shelve all changes without prompting
31
 
    --message ARG, -m
32
 
    --revision ARG, -r
 
18
If you specifiy "--pick" you'll be prompted for each hunk of the diff as
 
19
to whether you want to shelve it or not. Press "?" at the prompt for help.
33
20
 
34
21
More Info
35
22
=========
36
23
 
37
24
http://bazaar.canonical.com/BzrShelveExample
38