mercurial/commands.py
changeset 15103 5ca8c111e9aa
parent 15081 d30ec2d16c5a
child 15104 a20f5088013a
--- a/mercurial/commands.py	Fri Sep 16 14:37:53 2011 -0500
+++ b/mercurial/commands.py	Fri Sep 16 14:37:55 2011 -0500
@@ -3385,6 +3385,46 @@
        its first parent. Also, only files different from BOTH parents
        will appear in files:.
 
+    .. container:: verbose
+
+      Some examples:
+
+      - changesets with full descriptions and file lists::
+
+          hg log -v
+
+      - changesets ancestral to the working directory::
+
+          hg log -f
+
+      - last 10 commits on the current branch::
+
+          hg log -l 10 -b .
+
+      - changesets showing all modifications of a file, including removals::
+
+          hg log --removed file.c
+
+      - all changesets that touch a directory, with diffs, excluding merges::
+
+          hg log -Mp lib/
+
+      - all revision numbers that match a keyword::
+
+          hg log -k bug --template "{rev}\\n"
+
+      - check if a given changeset is included is a tagged release::
+
+          hg log -r "a21ccf and ancestor(1.9)"
+
+      - find all changesets by some user in a date range::
+
+          hg log -k alice -d "may 2008 to jul 2008"
+
+      - summary of all changesets after the last tag::
+
+          hg log -r "last(tagged())::" --template "{desc|firstline}\\n"
+
     Returns 0 on success.
     """