Mercurial > repos > devteam > package_tophat2_2_0_9
Help: identify
hg identify [-nibtB] [-r REV] [SOURCE]
aliases: id
identify the working directory or specified revision
Print a summary identifying the repository state at REV using one or two parent hash identifiers, followed by a "+" if the working directory has uncommitted changes, the branch name (if not default), a list of tags, and a list of bookmarks.
When REV is not given, print a summary of the current state of the repository including the working directory. Specify -r. to get information of the working directory parent without scanning uncommitted changes.
Specifying a path to a repository root or Mercurial bundle will cause lookup to operate on that repository/bundle.
Template:
The following keywords are supported in addition to the common template keywords and functions. See also 'hg help templates'.
- dirty
- String. Character "+" denoting if the working directory has uncommitted changes.
- id
- String. One or two nodes, optionally followed by "+".
- parents
- List of strings. Parent nodes of the changeset.
Examples:
- generate a build identifier for the working directory:
hg id --id > build-id.dat
- find the revision corresponding to a tag:
hg id -n -r 1.3
- check the most recent revision of a remote repository:
hg id -r tip https://www.mercurial-scm.org/repo/hg/
See 'hg log' for generating more information about specific revisions, including full hash identifiers.
Returns 0 if successful.
options:
| -r | --rev REV | identify the specified revision |
| -n | --num | show local revision number |
| -i | --id | show global revision id |
| -b | --branch | show branch |
| -t | --tags | show tags |
| -B | --bookmarks | show bookmarks |
| -e | --ssh CMD | specify ssh command to use |
| --remotecmd CMD | specify hg command to run on the remote side | |
| --insecure | do not verify server certificate (ignoring web.cacerts config) | |
| -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) |