== Head ==

`hg heads [-r REV] [REV]...`

A '''head''' is a [[ChangeSet|changeset]] with no child changesets.  The [[Tip|tip]] is the most recently changed head. Other heads are recent [[Pull|pulls]] into a [[Repository|repository]] that have not yet been [[Merge|merged]].

{{{#!dot
digraph {
   rankdir = LR
   node [shape=record]
   rev0 [label="{{<p1> p1 | <p2> p2} | rev 0:838e}"];
   rev1 [label="{{<p1> p1 | <p2> p2} | rev 1:34ef}"];
   rev2 [label="{{<p1> p1 | <p2> p2} | rev 2:4563}", color=red];
   rev3 [label="{{<p1> p1 | <p2> p2} | rev 3:fe56 (tip)}", color=red];
   workingdir [label="{{<p1> p1 | <p2> p2} | working directory}"];
   rev0 -> rev1:p1 [dir=back, label="parent"]
   rev1 -> rev2:p1 [dir=back]
   rev1 -> rev3:p1 [dir=back]
   rev3 -> workingdir:p1 [dir=back]
   label = "sample repo with two heads (rev2 and rev3)"
}
}}}

If you have just made a commit, that commit will be
the tip. Alternately, if you have just pulled from another
repository, the tip of that repository becomes the current tip.

Mercurial supports [[MultipleHeads|multiple heads]] concurrently within a single repository.

Help text: http://www.selenic.com/mercurial/hg.1.html#heads

See also: [[Branch]], [[WorkingDirectory]]

=== Definitions ===
''(from http://selenic.com/pipermail/mercurial-devel/2009-June/013030.html)''

 head:: a changeset that has no children

 branch:: the set of all changesets with the same branch name

 branch head:: a changeset in a branch that has no children in that branch (not the same as head!)

 active branch head:: a branch head that is also a head

 inactive branch head:: a branch head that has a child not in the same branch

 closed branch head:: a branch head with a closed marker

 closed branch:: a branch with only closed heads

----
CategoryCommand CategoryGlossary

[[FrenchHead|Français]]