revsets: add descriptions for sample queries in the help
authorBrodie Rao <brodie@bitheap.org>
Sat, 09 Oct 2010 11:54:42 -0500
changeset 12659 5aa5cbaf6efc
parent 12658 97d7ee445e98
child 12660 6ed5ae6264c2
revsets: add descriptions for sample queries in the help
mercurial/help/revsets.txt
--- 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())'