Mercurial > repos > iuc > rgcca
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) |