Mercurial > function-utils
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.
Specifying a path to a repository root or Mercurial bundle will cause lookup to operate on that repository/bundle.
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 http://selenic.com/hg/
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) |
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 |
--config CONFIG [+] | set/override config option (use 'section.name=value') | |
--debug | enable debugging output | |
--debugger | start debugger | |
--encoding ENCODE | set the charset encoding (default: ascii) | |
--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 |