moinsetup

Help

hg shelve [OPTION]... [FILE]...

save and set aside changes from the working directory

    Shelving takes files that "hg status" reports as not clean, saves
    the modifications to a bundle (a shelved change), and reverts the
    files so that their state in the working directory becomes clean.

    To restore these changes to the working directory, using "hg
    unshelve"; this will work even if you switch to a different
    commit.

    When no files are specified, "hg shelve" saves all not-clean
    files. If specific files or directories are named, only changes to
    those files are shelved.

    In bare shelve (when no files are specified, without interactive,
    include and exclude option), shelving remembers information if the
    working directory was on newly created branch, in other words working
    directory was on different branch than its first parent. In this
    situation unshelving restores branch information to the working directory.

    Each shelved change has a name that makes it easier to find later.
    The name of a shelved change defaults to being based on the active
    bookmark, or if there is no active bookmark, the current named
    branch.  To specify a different name, use ``--name``.

    To see a list of existing shelved changes, use the ``--list``
    option. For each shelved change, this will print its name, age,
    and description; use ``--patch`` or ``--stat`` for more details.

    To delete specific shelved changes, use ``--delete``. To delete
    all shelved changes, use ``--cleanup``.
    

options ([+] can be repeated):

 == ===================== ===========================================================================================================
 -A --addremove           mark new/missing files as added/removed before shelving                                                    
 -u --unknown             store unknown files in the shelve                                                                          
    --cleanup             delete all shelved changes                                                                                 
    --date DATE           shelve with the specified commit date                                                                      
 -d --delete              delete the named shelved change(s)                                                                         
 -e --edit                invoke editor on commit messages                                                                           
 -k --keep                shelve, but keep changes in the working directory                                                          
 -l --list                list current shelves                                                                                       
 -m --message TEXT        use text as shelve message                                                                                 
 -n --name NAME           use the given name for the shelved commit                                                                  
 -p --patch               output patches for changes (provide the names of the shelved changes as positional arguments)              
 -i --interactive         interactive mode                                                                                           
    --stat                output diffstat-style summary of changes (provide the names of the shelved changes as positional arguments)
 -I --include PATTERN [+] include names matching the given patterns                                                                  
 -X --exclude PATTERN [+] exclude names matching the given patterns                                                                  
 == ===================== ===========================================================================================================

global options ([+] can be repeated):

 == =================== ==================================================================
 -R --repository REPO   repository root directory or name of overlay bundle file          
    --cwd DIR           change working directory                                          
 -y --noninteractive    do not prompt, automatically pick the first choice for all prompts
 -q --quiet             suppress output                                                   
 -v --verbose           enable additional output                                          
    --color TYPE        when to colorize (boolean, always, auto, never, or debug)         
    --config CONFIG [+] set/override config option (use 'section.name=value')             
    --debug             enable debugging output                                           
    --debugger          start debugger                                                    
    --encoding ENCODE   set the charset encoding (default: ascii)                         
    --encodingmode MODE set the charset encoding mode (default: strict)                   
    --traceback         always print a traceback on exception                             
    --time              time how long the command takes                                   
    --profile           print command execution profile                                   
    --version           output version information and exit                               
 -h --help              display help and exit                                             
    --hidden            consider hidden changesets                                        
    --pager TYPE        when to paginate (boolean, always, auto, or never) (default: auto)
 == =================== ==================================================================