:orphan:

hg identify
===========

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.

.. container:: verbose

  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.