# HG changeset patch
# User Martin Geisler <mg@aragost.com>
# Date 1313668618 -7200
# Node ID 39eb2e86fb1181b7064e86e457850a3ada227a96
# Parent  5e7f03cfeeb9b1db7d5b6192b19ad10626a39bfb
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.

diff -r 5e7f03cfeeb9 -r 39eb2e86fb11 mercurial/commands.py
--- 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`).