#pragma section-numbers 2
= Parentrevspec Extension =

/!\ This extension is deprecated. See [[Topic:revsets|revsets]].

''Author: Alexis S. L. Carvalho''

<<TableOfContents(3)>>
== 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 ancestor 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.

== Configuration ==
Configure your ''`.hgrc`'' to enable the extension by adding the following lines:

{{{
[extensions]
parentrevspec =
}}}

== Notes ==

=== 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