diff -r 47d43e2323c5 -r 8c210b169c69 mercurial/commands.py
--- a/mercurial/commands.py	Tue Mar 25 16:10:07 2014 -0700
+++ b/mercurial/commands.py	Wed Mar 26 12:52:57 2014 -0500
@@ -3875,6 +3875,23 @@
 
     See pull for valid source format details.
 
+    .. container:: verbose
+
+      Examples:
+
+      - show incoming changes with patches and full description::
+
+          hg incoming -vp
+
+      - show incoming changes excluding merges, store a bundle::
+
+          hg in -vpM --bundle incoming.hg
+          hg pull incoming.hg
+
+      - briefly list changes inside a bundle::
+
+          hg in changes.hg -T "{desc|firstline}\\n"
+
     Returns 0 if there are incoming changes, 1 otherwise.
     """
     if opts.get('graph'):