Mercurial > HIS > BLT-XML
Help: heads
hg heads [-ct] [-r STARTREV] [REV]...
show branch heads
With no arguments, show all open branch heads in the repository. Branch heads are changesets that have no descendants on the same branch. They are where development generally takes place and are the usual targets for update and merge operations.
If one or more REVs are given, only open branch heads on the branches associated with the specified changesets are shown. This means that you can use 'hg heads .' to see the heads on the currently checked-out branch.
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 -t/--topo is specified, named branch mechanics will be ignored and only topological heads (changesets with no children) will be shown.
Returns 0 if matching heads are found, 1 if not.
options:
| -r | --rev STARTREV | show only heads which are descendants of STARTREV |
| -t | --topo | show topological heads only |
| -a | --active | show active branchheads only (DEPRECATED) |
| -c | --closed | show normal and closed branch heads |
| --style STYLE | display using template map file (DEPRECATED) | |
| -T | --template TEMPLATE | display with template |
global options ([+] can be repeated):
| -R | --repository REPO | repository root directory or name of overlay bundle file |
| --cwd DIR | change working directory | |
| -y | --noninteractive | do not prompt, automatically pick the first choice for all prompts |
| -q | --quiet | suppress output |
| -v | --verbose | enable additional output |
| --color TYPE | when to colorize (boolean, always, auto, never, or debug) | |
| --config CONFIG [+] | set/override config option (use 'section.name=value') | |
| --debug | enable debugging output | |
| --debugger | start debugger | |
| --encoding ENCODE | set the charset encoding (default: UTF-8) | |
| --encodingmode MODE | set the charset encoding mode (default: strict) | |
| --traceback | always print a traceback on exception | |
| --time | time how long the command takes | |
| --profile | print command execution profile | |
| --version | output version information and exit | |
| -h | --help | display help and exit |
| --hidden | consider hidden changesets | |
| --pager TYPE | when to paginate (boolean, always, auto, or never) (default: auto) |
