# HG changeset patch # User Greg Ward # Date 1253225573 14400 # Node ID 8d7d68dd91fd6c3552dbe4648a000ffd1d259a67 # Parent 6b3f9b3686ef1b76451b2c09b6da6d52344c7f41 commands: tweak help for 'heads'. - prefer "changeset" over "revision" for internal consistency - clarify explanation of branch heads - add a line break - tighten some wording diff -r 6b3f9b3686ef -r 8d7d68dd91fd mercurial/commands.py --- a/mercurial/commands.py Mon Sep 28 00:23:44 2009 +0200 +++ b/mercurial/commands.py Thu Sep 17 18:12:53 2009 -0400 @@ -1356,23 +1356,25 @@ With no arguments, show all repository head changesets. - Repository "heads" are changesets that don't have child - changesets. They are where development generally takes place and - are the usual targets for update and merge operations. + Repository "heads" are changesets with no child changesets. They are + where development generally takes place and are the usual targets + for update and merge operations. If one or more REV is given, the "branch heads" will be shown for - the named branch associated with that revision. The name of the - branch is called the revision's branch tag. - - Branch heads are revisions on a given named branch that do not have - any descendants on the same branch. A branch head could be a true head - or it could be the last changeset on a branch before a new branch - was created. If none of the branch heads are true heads, the branch - is considered inactive. If -c/--closed is specified, also show branch - heads marked closed (see hg commit --close-branch). - - If STARTREV is specified only those heads (or branch heads) that - are descendants of STARTREV will be displayed. + the named branch associated with the specified changeset(s). + + Branch heads are changesets on a named branch with no descendants on + the same branch. A branch head could be a "true" (repository) head, + or it could be the last changeset on that branch before it was + merged into another branch, or it could be the last changeset on the + branch before a new branch was created. If none of the branch heads + are true heads, the branch is considered inactive. + + If -c/--closed is specified, also show branch heads marked closed + (see hg commit --close-branch). + + If STARTREV is specified, only those heads that are descendants of + STARTREV will be displayed. """ if opts.get('rev'): start = repo.lookup(opts['rev'])