# HG changeset patch
# User Matt Mackall <mpm@selenic.com>
# Date 1316209965 18000
# Node ID 24f5489452af2a21f0b3dbcee0576d26c2be65ee
# Parent  0be86ec3cafed3493820381db06cab0293f8eea8
id: add some help examples

diff -r 0be86ec3cafe -r 24f5489452af mercurial/commands.py
--- a/mercurial/commands.py	Fri Sep 16 16:40:27 2011 -0500
+++ b/mercurial/commands.py	Fri Sep 16 16:52:45 2011 -0500
@@ -2971,6 +2971,22 @@
     Specifying a path to a repository root or Mercurial bundle will
     cause lookup to operate on that repository/bundle.
 
+    .. container:: verbose
+
+      Examples:
+
+      - generate a build identifier for the working directory::
+
+          hg id --id > build-id.dat
+
+      - find the revision corresponding to a tag::
+
+          hg id -n -r 1.3
+
+      - check the most recent revision of a remote repository::
+
+          hg id -r tip http://selenic.com/hg/
+
     Returns 0 if successful.
     """