changeset 12659:5aa5cbaf6efc

revsets: add descriptions for sample queries in the help
author Brodie Rao <brodie@bitheap.org>
date Sat, 09 Oct 2010 11:54:42 -0500
parents 97d7ee445e98
children 6ed5ae6264c2
files mercurial/help/revsets.txt
diffstat 1 files changed, 22 insertions(+), 6 deletions(-) [+]
line wrap: on
line diff
--- a/mercurial/help/revsets.txt	Sat Oct 09 11:53:48 2010 -0500
+++ b/mercurial/help/revsets.txt	Sat Oct 09 11:54:42 2010 -0500
@@ -168,10 +168,26 @@
   -P x  ->  !::x
   -l x  ->  limit(expr, x)
 
-Some sample queries::
+Some sample queries:
+
+- Changesets on the default branch::
+
+    hg log -r 'branch(default)'
+
+- Changesets on the default branch since tag 1.5 (excluding merges)::
+
+    hg log -r 'branch(default) and 1.5:: and not merge()'
 
-  hg log -r 'branch(default)'
-  hg log -r 'branch(default) and 1.5:: and not merge()'
-  hg log -r '1.3::1.5 and keyword(bug) and file("hgext/*")'
-  hg log -r 'sort(date("May 2008"), user)'
-  hg log -r '(keyword(bug) or keyword(issue)) and not ancestors(tagged())'
+- Changesets between tags 1.3 and 1.5 mentioning "bug" that affect
+  hgext/*::
+
+    hg log -r '1.3::1.5 and keyword(bug) and file("hgext/*")'
+
+- Changesets in committed May 2008, sorted by user::
+
+    hg log -r 'sort(date("May 2008"), user)'
+
+- Changesets mentioning "bug" or "issue" that are not in a tagged
+  release::
+
+    hg log -r '(keyword(bug) or keyword(issue)) and not ancestors(tagged())'