Differences between revisions 42 and 44 (spanning 2 versions)

Shelve Extension

This extension is distributed with Mercurial 2.8 and later. If you are using an earlier version of Mercurial, see ThirdPartyShelveExtension.

Author: Bryan O'Sullivan

Current maintainer: Facebook

Contents

Overview
Configuration
Usage
See also

1. Overview

The shelve extension lets you set your pending changes aside temporarily and restore them at a later time. It is useful in situations where you need to switch tasks, but are not ready to commit your current work.

2. Configuration

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
shelve=

3. Usage

Temporarily stash away changes:

hg shelve

List all existing shelves:

hg shelve --list

Get the changes back into the working directory:

hg unshelve

Shelves can be given custom names (the default name is your active bookmark or branch):

hg shelve --name <name>
hg unshelve <name>

See hg shelve --help for advance usage.

4. See also

CategoryBundledExtension

-  ⇤ ← Revision 42 as of 2013-11-07 19:28:58 → 
  Size: 863
  Editor: Rain
  Comment:
+   ← Revision 44 as of 2014-07-23 08:56:39 → ⇥
  Size: 1184
  Editor: SietseBrouwer
  Comment: Expand hatnote: refer users of earlier versions to ThirdPartyShelveExtension
-Deletions are marked like this.
+Additions are marked like this.
 Line 4:
-'''This extension is distributed with Mercurial 2.8 and later.'''
+'''This extension is distributed with Mercurial 2.8 and later. If you are using an earlier version of Mercurial, see ThirdPartyShelveExtension.'''
 Line 14:
-The shelve extension lets you set the changes in your working directory aside temporarily and restore them.
+The shelve extension lets you set your pending changes aside temporarily and restore them at a later time.  It is useful in situations where you need to switch tasks, but are not ready to commit your current work.
 Line 27:
-(this is only a description of the basic usage)
+Temporarily stash away changes:
-Line 33:
+Line 32:
-Temporarily stash away changes.
+List all existing shelves:
-Line 39:
+Line 37:
-List all existing shelves.
+Get the changes back into the working directory:
-Line 45:
+Line 42:
-Get the changes back into the working directory.
+Shelves can be given custom names (the default name is your active bookmark or branch):
{{{
hg shelve --name <name>
hg unshelve <name>
}}}

See `hg shelve --help` for advance usage.

Diff for "ShelveExtension"

Shelve Extension

1. Overview

2. Configuration

3. Usage

4. See also