commands: clarify that 'hg heads foo' shows heads on branch foo
This is a FAQ: people try 'hg heads -r foo' and only see the tip-most
branch heads on foo.
--- a/mercurial/commands.py Wed Aug 17 16:41:14 2011 +0800
+++ b/mercurial/commands.py Thu Aug 18 13:56:58 2011 +0200
@@ -2518,7 +2518,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`).