# HG changeset patch
# User Matt Mackall <mpm@selenic.com>
# Date 1316201875 18000
# Node ID 5ca8c111e9aa6f5717501bf99df374c4199d5836
# Parent  a7e375d087f636a2d6e4e2c60593cf932313e9f4
log: add some usage examples to verbose help

diff -r a7e375d087f6 -r 5ca8c111e9aa mercurial/commands.py
--- 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.
     """