diff -r 0bb0f807dfc3 -r c019df62de45 mercurial/commands.py
--- a/mercurial/commands.py	Wed Aug 17 14:17:35 2011 +0200
+++ b/mercurial/commands.py	Thu Aug 18 17:24:04 2011 -0500
@@ -2523,7 +2523,9 @@
     no child changeset on the same branch.
 
     If one or more REVs are given, only branch heads on the branches
-    associated with the specified changesets are shown.
+    associated with the specified changesets are shown. This means
+    that you can use :hg:`heads foo` to see the heads on a branch
+    named ``foo``.
 
     If -c/--closed is specified, also show branch heads marked closed
     (see :hg:`commit --close-branch`).