--- a/mercurial/commands.py	Sat Sep 17 13:08:24 2011 -0500
+++ b/mercurial/commands.py	Sat Sep 17 13:20:10 2011 -0500
@@ -4815,6 +4815,22 @@
       I = ignored
         = origin of the previous file listed as A (added)
 
+    .. container:: verbose
+
+      Examples:
+
+      - show changes in the working directory relative to a changeset:
+
+          hg status --rev 9353
+
+      - show all changes including copies in an existing changeset::
+
+          hg status --copies --change 9353
+
+      - get a NUL separated list of added files, suitable for xargs::
+
+          hg status -an0
+
     Returns 0 on success.
     """