Differences between revisions 11 and 12
Revision 11 as of 2009-05-19 19:31:06
Size: 1355
Editor: localhost
Comment: converted to 1.6 markup
Revision 12 as of 2010-08-28 15:14:36
Size: 1360
Editor: abuehl
Comment:
Deletions are marked like this. Additions are marked like this.
Line 57: Line 57:
Line 59: Line 58:
CategoryExtension CategoryBundledExtension

Parentrevspec Extension

This extension is currently being distributed along with Mercurial.

Author: Alexis S. L. Carvalho

1. Overview

This extension allows you to use git-style suffixes to refer to the ancestors of a specific revision.

For example, if you can refer to a revision as foo, then:

1. foo^N = Nth parent of foo:

  • foo^0 = foo

  • foo^1 = first parent of foo

  • foo^2 = second parent of foo

  • foo^ = foo^1

2. foo~N = Nth first grandparent of foo

  • foo~0 = foo

  • foo~1 = foo^1 = foo^ = first parent of foo

  • foo~2 = foo^1^1 = foo^^ = first parent of first parent of foo

So hg log -r tip^^ or hg log -r tip~2 will display the grandparent of tip.

2. Configuration

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

[extensions]
parentrevspec =

3. Notes

3.1. Using cmd.exe on Windows

Character ^ is interpreted as an escape character by cmd.exe on Windows. So, if you want to get a single ^ through to hg you have to enter something like

> hg log -r.^^

which counts as a single ^ or

> hg log -r."^"

If you happen to ignore that, cmd.exe will give you a funny "More?"

> hg log -r.^
More?


CategoryBundledExtension

ParentrevspecExtension (last edited 2013-10-08 01:16:30 by Matthew Gabeler-Lee)