Diff for "AliasExtension"

Differences between revisions 1 and 16 (spanning 15 versions)

Alias Extension

This extension has been moved into core Mercurial as of 1.3. Original author: Brendan Cully

1. Overview

$/!\$ In Mercurial 1.3 and newer, this is no longer an extension; the functionality (same as before) is now available from core Mercurial.

Define your own shortcuts for Mercurial's command-line user interface.

2. Configuration

Add the following lines to a hgrc to add a llog command:

[alias]
# short log
llog = log --limit 10

(In 1.2.1 and earlier, you also need to activate the extension from the [extensions] section.)

3. Ideas for improvements

Support for global options like --config in extension definitions
Shell aliases
Argument substitution
```
mq = hg -R $(hg root)/.hg/patches $*
```
Pipes
```
hgrep = hg manifest | grep $*
```
Recursive alias definitions:
```
foo = bar
bar = log
```

CategoryBundledExtension

-  ⇤ ← Revision 1 as of 2007-06-28 22:12:00 → 
  Size: 576
  Editor: BrendanCully
  Comment: Alias extension
+   ← Revision 16 as of 2010-08-28 15:02:48 → ⇥
  Size: 956
  Editor: abuehl
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-== Extension Name ==
+== Alias Extension ==
 Line 3:
-'''This extension is not distributed with Mercurial.'''

''Author: Brendan Cully''

Download site: [http://hg.kublai.com/mercurial/extensions/alias]
+'''This extension has been moved into core Mercurial as of 1.3.'''
''Original author: Brendan Cully''
-Line 11:
+Line 8:
-Just enable the extension, then define your own command aliases in your hgrc.
For example, the configuration below gives you a new {{{llog}} command.
+/!\ In Mercurial 1.3 and newer, this is no longer an extension; the functionality (same as before) is now available from core Mercurial.

Define your own shortcuts for Mercurial's command-line user interface.
-Line 15:
+Line 13:
-Configure your .hgrc to enable the extension by adding following lines:
+Add the following lines to a hgrc to add a llog command:
-Line 18:
+Line 17:
-[extensions]
alias = /path/to/alias

[aliases]
+[alias]
-Line 26:
+Line 22:
+(In 1.2.1 and earlier, you also need to activate the extension from the {{{[extensions]}}} section.)

=== Ideas for improvements ===
 * Support for global options like --config in extension definitions
 * Shell aliases
 * Argument substitution
 {{{
mq = hg -R $(hg root)/.hg/patches $*
}}}
 * Pipes
 {{{
hgrep = hg manifest | grep $*
}}}
 * Recursive alias definitions:
 {{{
foo = bar
bar = log
}}}
-Line 27:
+Line 41:
-CategoryExtension
+CategoryBundledExtension