docs: note how our heads() and roots() revsets differ from hg's

This commit is contained in:
Martin von Zweigbergk 2023-06-14 03:55:36 -07:00 committed by Martin von Zweigbergk
parent d13db728ba
commit b01d6cdf5d

View file

@ -105,7 +105,13 @@ revsets (expressions) as arguments.
* `git_head()`: The Git `HEAD` target as of the last import.
* `visible_heads()`: All visible heads (same as `heads(all())`).
* `heads(x)`: Commits in `x` that are not ancestors of other commits in `x`.
Note that this is different from
[Mercurial's](https://repo.mercurial-scm.org/hg/help/revsets) `heads(x)`
function, which is equivalent to `x ~ x-`.
* `roots(x)`: Commits in `x` that are not descendants of other commits in `x`.
Note that this is different from
[Mercurial's](https://repo.mercurial-scm.org/hg/help/revsets) `roots(x)`
function, which is equivalent to `x ~ x+`.
* `latest(x[, count])`: Latest `count` commits in `x`, based on committer
timestamp. The default `count` is 1.
* `merges()`: Merge commits.