43 $ hg shelve -h |
43 $ hg shelve -h |
44 hg shelve [OPTION]... [FILE]... |
44 hg shelve [OPTION]... [FILE]... |
45 |
45 |
46 save and set aside changes from the working directory |
46 save and set aside changes from the working directory |
47 |
47 |
48 Shelving takes files that "hg status" reports as not clean, saves the |
48 Shelving takes files that "hg status" reports as not clean, saves the |
49 modifications to a bundle (a shelved change), and reverts the files so |
49 modifications to a bundle (a shelved change), and reverts the files so that |
50 that their state in the working directory becomes clean. |
50 their state in the working directory becomes clean. |
51 |
51 |
52 To restore these changes to the working directory, using "hg unshelve"; |
52 To restore these changes to the working directory, using "hg unshelve"; this |
53 this will work even if you switch to a different commit. |
53 will work even if you switch to a different commit. |
54 |
54 |
55 When no files are specified, "hg shelve" saves all not-clean files. If |
55 When no files are specified, "hg shelve" saves all not-clean files. If |
56 specific files or directories are named, only changes to those files are |
56 specific files or directories are named, only changes to those files are |
57 shelved. |
57 shelved. |
58 |
58 |
59 In bare shelve (when no files are specified, without interactive, include |
59 In bare shelve (when no files are specified, without interactive, include and |
60 and exclude option), shelving remembers information if the working |
60 exclude option), shelving remembers information if the working directory was |
61 directory was on newly created branch, in other words working directory |
61 on newly created branch, in other words working directory was on different |
62 was on different branch than its first parent. In this situation |
62 branch than its first parent. In this situation unshelving restores branch |
63 unshelving restores branch information to the working directory. |
63 information to the working directory. |
64 |
64 |
65 Each shelved change has a name that makes it easier to find later. The |
65 Each shelved change has a name that makes it easier to find later. The name of |
66 name of a shelved change defaults to being based on the active bookmark, |
66 a shelved change defaults to being based on the active bookmark, or if there |
67 or if there is no active bookmark, the current named branch. To specify a |
67 is no active bookmark, the current named branch. To specify a different name, |
68 different name, use "--name". |
68 use "--name". |
69 |
69 |
70 To see a list of existing shelved changes, use the "--list" option. For |
70 To see a list of existing shelved changes, use the "--list" option. For each |
71 each shelved change, this will print its name, age, and description; use " |
71 shelved change, this will print its name, age, and description; use "--patch" |
72 --patch" or "--stat" for more details. |
72 or "--stat" for more details. |
73 |
73 |
74 To delete specific shelved changes, use "--delete". To delete all shelved |
74 To delete specific shelved changes, use "--delete". To delete all shelved |
75 changes, use "--cleanup". |
75 changes, use "--cleanup". |
76 |
76 |
77 options ([+] can be repeated): |
77 options ([+] can be repeated): |
78 |
78 |
79 -A --addremove mark new/missing files as added/removed before |
79 -A --addremove mark new/missing files as added/removed before |
80 shelving |
80 shelving |