mercurial/commands.py
changeset 9508 e2fd9b62349b
parent 9477 a4f6e4427b65
parent 9503 a23ee0208f77
child 9537 460e410c39be
equal deleted inserted replaced
9494:bdd8a41ea6f6 9508:e2fd9b62349b
  1354 def heads(ui, repo, *branchrevs, **opts):
  1354 def heads(ui, repo, *branchrevs, **opts):
  1355     """show current repository heads or show branch heads
  1355     """show current repository heads or show branch heads
  1356 
  1356 
  1357     With no arguments, show all repository head changesets.
  1357     With no arguments, show all repository head changesets.
  1358 
  1358 
  1359     Repository "heads" are changesets that don't have child
  1359     Repository "heads" are changesets with no child changesets. They are
  1360     changesets. They are where development generally takes place and
  1360     where development generally takes place and are the usual targets
  1361     are the usual targets for update and merge operations.
  1361     for update and merge operations.
  1362 
  1362 
  1363     If one or more REV is given, the "branch heads" will be shown for
  1363     If one or more REV is given, the "branch heads" will be shown for
  1364     the named branch associated with that revision. The name of the
  1364     the named branch associated with the specified changeset(s).
  1365     branch is called the revision's branch tag.
  1365 
  1366 
  1366     Branch heads are changesets on a named branch with no descendants on
  1367     Branch heads are revisions on a given named branch that do not have
  1367     the same branch. A branch head could be a "true" (repository) head,
  1368     any descendants on the same branch. A branch head could be a true head
  1368     or it could be the last changeset on that branch before it was
  1369     or it could be the last changeset on a branch before a new branch
  1369     merged into another branch, or it could be the last changeset on the
  1370     was created. If none of the branch heads are true heads, the branch
  1370     branch before a new branch was created. If none of the branch heads
  1371     is considered inactive. If -c/--closed is specified, also show branch
  1371     are true heads, the branch is considered inactive.
  1372     heads marked closed (see hg commit --close-branch).
  1372 
  1373 
  1373     If -c/--closed is specified, also show branch heads marked closed
  1374     If STARTREV is specified only those heads (or branch heads) that
  1374     (see hg commit --close-branch).
  1375     are descendants of STARTREV will be displayed.
  1375 
       
  1376     If STARTREV is specified, only those heads that are descendants of
       
  1377     STARTREV will be displayed.
  1376     """
  1378     """
  1377     if opts.get('rev'):
  1379     if opts.get('rev'):
  1378         start = repo.lookup(opts['rev'])
  1380         start = repo.lookup(opts['rev'])
  1379     else:
  1381     else:
  1380         start = None
  1382         start = None