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)

Mercurial > HIS > BLT-XML

Help: identify