comparison en/ch09-hook.xml @ 691:4ce9d0754af3

Remove the words "section", "chapter", etc from in front of xref tags.

690:b788b405e141

    two names refer to the same idea.</para>

  <sect1>
    <title>An overview of hooks in Mercurial</title>

    <para id="x_1e8">Here is a brief list of the hooks that Mercurial supports.
      We will revisit each of these hooks in more detail later, in
      section <xref linkend="sec:hook:ref"/>.</para>

    <itemizedlist>
      <listitem><para id="x_1e9"><literal role="hook">changegroup</literal>: This
	  is run after a group of changesets has been brought into the
	  repository from elsewhere.</para>

	<literal>commit.bar</literal> before
	<literal>commit.foo</literal>, and <literal>commit</literal>
	before both.
      </para>

      <para id="x_218">It is a good idea to use a somewhat descriptive extension
	when you define a new hook.  This will help you to remember
	what the hook was for.  If the hook fails, you'll get an error
	message that contains the hook name and extension, so using a
	descriptive extension could give you an immediate hint as to
	why the hook failed (see section <xref
	  linkend="sec:hook:perm"/> for an example).
      </para>

    </sect2>
    <sect2 id="sec:hook:perm">

	    role="hg-ext">bugzilla</literal> hook relate to running
	  Bugzilla's <filename>processmail</filename> script and
	  mapping committer names to user names.
	</para>

	<para id="x_263">Recall from section <xref
	    linkend="sec:hook:bugzilla:config"/> above that the user
	  that runs the Mercurial process on the server is also the
	  one that will run the <filename>processmail</filename>
	  script.  The <filename>processmail</filename> script
	  sometimes causes Bugzilla to write to files in its

	  <listitem><para id="x_274"><envar
		role="rc-item-notify">sources</envar>: A list of
	      sources of changesets to consider.  This lets you limit
	      <literal role="hg-ext">notify</literal> to only sending
	      out email about changes that remote users pushed into
	      this repository via a server, for example.  See section
	      <xref
		linkend="sec:hook:sources"/> for the sources you can
	      specify here.
	    </para>
	  </listitem></itemizedlist>

	<para id="x_275">If you set the <envar role="rc-item-web">baseurl</envar>
	  item in the <literal role="rc-web">web</literal> section,

	    <command role="hg-cmd">hg pull</command>, <command
	      role="hg-cmd">hg push</command> or <command
	      role="hg-cmd">hg unbundle</command>.
	  </para>
	</listitem>
	<listitem><para id="x_294"><literal>source</literal>: A string.  The
	    source of these changes.  See section <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_295"><literal>url</literal>: A URL.  The location
	    of the remote repository, if known.  See section <xref
	      linkend="sec:hook:url"/> for more
	    information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_296">See also: <literal role="hook">incoming</literal> (section
	<xref linkend="sec:hook:incoming"/>), <literal
	  role="hook">prechangegroup</literal> (section <xref
	  linkend="sec:hook:prechangegroup"/>), <literal
	  role="hook">pretxnchangegroup</literal> (section <xref
	  linkend="sec:hook:pretxnchangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:commit">

	    The changeset ID of the second parent of the newly
	    committed changeset.
	  </para>
	</listitem></itemizedlist>

      <para id="x_29c">See also: <literal role="hook">precommit</literal>
	(section <xref linkend="sec:hook:precommit"/>), <literal
	  role="hook">pretxncommit</literal> (section <xref
	  linkend="sec:hook:pretxncommit"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:incoming">

	  role="hg-cmd">hg push</command>.  If a group of changesets
	was added in a single operation, this hook is called once for
	each added changeset.
      </para>

      <para id="x_29e">You can use this hook for the same purposes as the
	<literal role="hook">changegroup</literal> hook (section <xref
	  linkend="sec:hook:changegroup"/>); it's simply
	more convenient sometimes to run a hook once per group of
	changesets, while other times it's handier once per changeset.
      </para>

      <para id="x_29f">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2a0"><literal>node</literal>: A changeset ID.  The
	    ID of the newly added changeset.
	  </para>
	</listitem>
	<listitem><para id="x_2a1"><literal>source</literal>: A string.  The
	    source of these changes.  See section <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_2a2"><literal>url</literal>: A URL.  The location
	    of the remote repository, if known.  See section <xref
	      linkend="sec:hook:url"/> for more
	    information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2a3">See also: <literal role="hook">changegroup</literal>
	(section <xref linkend="sec:hook:changegroup"/>) <literal
	  role="hook">prechangegroup</literal> (section <xref
	  linkend="sec:hook:prechangegroup"/>), <literal
	  role="hook">pretxnchangegroup</literal> (section <xref
	  linkend="sec:hook:pretxnchangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:outgoing">

	    changeset ID of the first changeset of the group that was
	    sent.
	  </para>
	</listitem>
	<listitem><para id="x_2a8"><literal>source</literal>: A string.  The
	    source of the of the operation (see section <xref
	      linkend="sec:hook:sources"/>).  If a remote
	    client pulled changes from this repository,
	    <literal>source</literal> will be
	    <literal>serve</literal>.  If the client that obtained
	    changes from this repository was local,

	    <literal>bundle</literal>, <literal>pull</literal>, or
	    <literal>push</literal>, depending on the operation the
	    client performed.
	  </para>
	</listitem>
	<listitem><para id="x_2a9"><literal>url</literal>: A URL.  The location
	    of the remote repository, if known.  See section <xref
	      linkend="sec:hook:url"/> for more
	    information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2aa">See also: <literal role="hook">preoutgoing</literal>
	(section <xref linkend="sec:hook:preoutgoing"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:prechangegroup">
      <title><literal

      <para id="x_2ae">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2af"><literal>source</literal>: A string.  The
	    source of these changes.  See section <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_2b0"><literal>url</literal>: A URL.  The location
	    of the remote repository, if known.  See section <xref
	      linkend="sec:hook:url"/> for more
	    information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2b1">See also: <literal role="hook">changegroup</literal>
	(section <xref linkend="sec:hook:changegroup"/>), <literal
	  role="hook">incoming</literal> (section <xref
	  linkend="sec:hook:incoming"/>), , <literal
	  role="hook">pretxnchangegroup</literal> (section <xref
	  linkend="sec:hook:pretxnchangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:precommit">

	</listitem></itemizedlist>
      <para id="x_2b7">If the commit proceeds, the parents of the working
	directory will become the parents of the new changeset.
      </para>

      <para id="x_2b8">See also: <literal role="hook">commit</literal> (section
	<xref linkend="sec:hook:commit"/>), <literal
	  role="hook">pretxncommit</literal> (section <xref
	  linkend="sec:hook:pretxncommit"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:preoutgoing">

      </para>

      <para id="x_2bb">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2bc"><literal>source</literal>: A string.  The
	    source of the operation that is attempting to obtain
	    changes from this repository (see section <xref
	      linkend="sec:hook:sources"/>).  See the documentation
	    for the <literal>source</literal> parameter to the
	    <literal role="hook">outgoing</literal> hook, in section
	    <xref linkend="sec:hook:outgoing"/>, for possible values
	    of
	    this parameter.
	  </para>
	</listitem>
	<listitem><para id="x_2bd"><literal>url</literal>: A URL.  The location
	    of the remote repository, if known.  See section <xref
	      linkend="sec:hook:url"/> for more
	    information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2be">See also: <literal role="hook">outgoing</literal> (section
	<xref linkend="sec:hook:outgoing"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:pretag">
      <title><literal role="hook">pretag</literal>&emdash;before

	<listitem><para id="x_2c3"><literal>tag</literal>: A string.  The name of
	    the tag to be created.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2c4">If the tag to be created is revision-controlled, the
	<literal role="hook">precommit</literal> and <literal
	  role="hook">pretxncommit</literal> hooks (sections <xref
	  linkend="sec:hook:commit"/> and <xref
	  linkend="sec:hook:pretxncommit"/>) will also be run.
      </para>

      <para id="x_2c5">See also: <literal role="hook">tag</literal> (section
	<xref linkend="sec:hook:tag"/>)
      </para>
    </sect2>
    <sect2 id="sec:hook:pretxnchangegroup">
      <title><literal
	  role="hook">pretxnchangegroup</literal>&emdash;before

	      role="hg-cmd">hg pull</command>, <command
	      role="hg-cmd">hg push</command> or <command
	      role="hg-cmd">hg unbundle</command>.
	  </para>
	</listitem>
	<listitem><para id="x_2cc"><literal>source</literal>: A string.  The
	    source of these changes.  See section <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_2cd"><literal>url</literal>: A URL.  The location
	    of the remote repository, if known.  See section <xref
	      linkend="sec:hook:url"/> for more
	    information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2ce">See also: <literal role="hook">changegroup</literal>
	(section <xref linkend="sec:hook:changegroup"/>), <literal
	  role="hook">incoming</literal> (section <xref
	  linkend="sec:hook:incoming"/>), <literal
	  role="hook">prechangegroup</literal> (section <xref
	  linkend="sec:hook:prechangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:pretxncommit">

	    The changeset ID of the second parent of the newly
	    committed changeset.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2d6">See also: <literal role="hook">precommit</literal>
	(section <xref linkend="sec:hook:precommit"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:preupdate">
      <title><literal role="hook">preupdate</literal>&emdash;before
	updating or merging working directory</title>

      <para id="x_2d7">This controlling hook is run before an update or merge of
	the working directory begins.  It is run only if Mercurial's
	normal pre-update checks determine that the update or merge
	can proceed.  If the hook succeeds, the update or merge may
	proceed; if it fails, the update or merge does not start.
      </para>

      <para id="x_2d8">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2d9"><literal>parent1</literal>: A changeset ID.
	    The ID of the parent that the working directory is to be
	    updated to.  If the working directory is being merged, it
	    will not change this parent.
	  </para>
	</listitem>
	<listitem><para id="x_2da"><literal>parent2</literal>: A changeset ID.
	    Only set if the working directory is being merged.  The ID
	    of the revision that the working directory is being merged
	    with.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2db">See also: <literal role="hook">update</literal> (section
	<xref linkend="sec:hook:update"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:tag">
      <title><literal role="hook">tag</literal>&emdash;after tagging a
	changeset</title>

      <para id="x_2e1">If the created tag is revision-controlled, the <literal
	  role="hook">commit</literal> hook (section <xref
	  linkend="sec:hook:commit"/>) is run before this hook.
      </para>

      <para id="x_2e2">See also: <literal role="hook">pretag</literal> (section
	<xref linkend="sec:hook:pretag"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:update">
      <title><literal role="hook">update</literal>&emdash;after

	    the revision that the working directory was merged with.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2e7">See also: <literal role="hook">preupdate</literal>
	(section <xref linkend="sec:hook:preupdate"/>)
      </para>

    </sect2>
  </sect1>
</chapter>

691:4ce9d0754af3

    two names refer to the same idea.</para>

  <sect1>
    <title>An overview of hooks in Mercurial</title>

    <para id="x_1e8">Here is a brief list of the hooks that Mercurial
      supports. We will revisit each of these hooks in more detail
      later, in <xref linkend="sec:hook:ref"/>.</para>

    <itemizedlist>
      <listitem><para id="x_1e9"><literal role="hook">changegroup</literal>: This
	  is run after a group of changesets has been brought into the
	  repository from elsewhere.</para>

	<literal>commit.bar</literal> before
	<literal>commit.foo</literal>, and <literal>commit</literal>
	before both.
      </para>

      <para id="x_218">It is a good idea to use a somewhat descriptive
	extension when you define a new hook.  This will help you to
	remember what the hook was for.  If the hook fails, you'll get
	an error message that contains the hook name and extension, so
	using a descriptive extension could give you an immediate hint
	as to why the hook failed (see <xref
	  linkend="sec:hook:perm"/> for an example).
      </para>

    </sect2>
    <sect2 id="sec:hook:perm">

	    role="hg-ext">bugzilla</literal> hook relate to running
	  Bugzilla's <filename>processmail</filename> script and
	  mapping committer names to user names.
	</para>

	<para id="x_263">Recall from <xref
	    linkend="sec:hook:bugzilla:config"/> above that the user
	  that runs the Mercurial process on the server is also the
	  one that will run the <filename>processmail</filename>
	  script.  The <filename>processmail</filename> script
	  sometimes causes Bugzilla to write to files in its

	  <listitem><para id="x_274"><envar
		role="rc-item-notify">sources</envar>: A list of
	      sources of changesets to consider.  This lets you limit
	      <literal role="hg-ext">notify</literal> to only sending
	      out email about changes that remote users pushed into
	      this repository via a server, for example.  See 
	      <xref linkend="sec:hook:sources"/> for the sources you
	      can specify here.
	    </para>
	  </listitem></itemizedlist>

	<para id="x_275">If you set the <envar role="rc-item-web">baseurl</envar>
	  item in the <literal role="rc-web">web</literal> section,

	    <command role="hg-cmd">hg pull</command>, <command
	      role="hg-cmd">hg push</command> or <command
	      role="hg-cmd">hg unbundle</command>.
	  </para>
	</listitem>
	<listitem><para id="x_294"><literal>source</literal>: A
	    string.  The source of these changes.  See <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_295"><literal>url</literal>: A URL.  The
	    location of the remote repository, if known.  See <xref
	      linkend="sec:hook:url"/> for more information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_296">See also: <literal
	  role="hook">incoming</literal> (<xref
	  linkend="sec:hook:incoming"/>), <literal
	  role="hook">prechangegroup</literal> (<xref
	  linkend="sec:hook:prechangegroup"/>), <literal
	  role="hook">pretxnchangegroup</literal> (<xref
	  linkend="sec:hook:pretxnchangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:commit">

	    The changeset ID of the second parent of the newly
	    committed changeset.
	  </para>
	</listitem></itemizedlist>

      <para id="x_29c">See also: <literal
	  role="hook">precommit</literal> (<xref
	  linkend="sec:hook:precommit"/>), <literal
	  role="hook">pretxncommit</literal> (<xref
	  linkend="sec:hook:pretxncommit"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:incoming">

	  role="hg-cmd">hg push</command>.  If a group of changesets
	was added in a single operation, this hook is called once for
	each added changeset.
      </para>

      <para id="x_29e">You can use this hook for the same purposes as
	the <literal role="hook">changegroup</literal> hook (<xref
	  linkend="sec:hook:changegroup"/>); it's simply more
	convenient sometimes to run a hook once per group of
	changesets, while other times it's handier once per changeset.
      </para>

      <para id="x_29f">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2a0"><literal>node</literal>: A changeset ID.  The
	    ID of the newly added changeset.
	  </para>
	</listitem>
	<listitem><para id="x_2a1"><literal>source</literal>: A
	    string.  The source of these changes.  See <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_2a2"><literal>url</literal>: A URL.  The
	    location of the remote repository, if known.  See <xref
	      linkend="sec:hook:url"/> for more information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2a3">See also: <literal
	  role="hook">changegroup</literal> (<xref
	  linkend="sec:hook:changegroup"/>) <literal
	  role="hook">prechangegroup</literal> (<xref
	  linkend="sec:hook:prechangegroup"/>), <literal
	  role="hook">pretxnchangegroup</literal> (<xref
	  linkend="sec:hook:pretxnchangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:outgoing">

	    changeset ID of the first changeset of the group that was
	    sent.
	  </para>
	</listitem>
	<listitem><para id="x_2a8"><literal>source</literal>: A string.  The
	    source of the of the operation (see <xref
	      linkend="sec:hook:sources"/>).  If a remote
	    client pulled changes from this repository,
	    <literal>source</literal> will be
	    <literal>serve</literal>.  If the client that obtained
	    changes from this repository was local,

	    <literal>bundle</literal>, <literal>pull</literal>, or
	    <literal>push</literal>, depending on the operation the
	    client performed.
	  </para>
	</listitem>
	<listitem><para id="x_2a9"><literal>url</literal>: A URL.  The
	    location of the remote repository, if known.  See <xref
	      linkend="sec:hook:url"/> for more information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2aa">See also: <literal
	  role="hook">preoutgoing</literal> (<xref
	  linkend="sec:hook:preoutgoing"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:prechangegroup">
      <title><literal

      <para id="x_2ae">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2af"><literal>source</literal>: A string.  The
	    source of these changes.  See <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_2b0"><literal>url</literal>: A URL.  The
	    location of the remote repository, if known.  See <xref
	      linkend="sec:hook:url"/> for more information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2b1">See also: <literal
	  role="hook">changegroup</literal> (<xref
	  linkend="sec:hook:changegroup"/>), <literal
	  role="hook">incoming</literal> (<xref
	  linkend="sec:hook:incoming"/>), <literal
	  role="hook">pretxnchangegroup</literal> (<xref
	  linkend="sec:hook:pretxnchangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:precommit">

	</listitem></itemizedlist>
      <para id="x_2b7">If the commit proceeds, the parents of the working
	directory will become the parents of the new changeset.
      </para>

      <para id="x_2b8">See also: <literal role="hook">commit</literal>
	(<xref linkend="sec:hook:commit"/>), <literal
	  role="hook">pretxncommit</literal> (<xref
	  linkend="sec:hook:pretxncommit"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:preoutgoing">

      </para>

      <para id="x_2bb">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2bc"><literal>source</literal>: A
	    string.  The source of the operation that is attempting to
	    obtain changes from this repository (see <xref
	      linkend="sec:hook:sources"/>).  See the documentation
	    for the <literal>source</literal> parameter to the
	    <literal role="hook">outgoing</literal> hook, in
	    <xref linkend="sec:hook:outgoing"/>, for possible values
	    of this parameter.
	  </para>
	</listitem>
	<listitem><para id="x_2bd"><literal>url</literal>: A URL.  The
	    location of the remote repository, if known.  See <xref
	      linkend="sec:hook:url"/> for more information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2be">See also: <literal
	  role="hook">outgoing</literal> (<xref
	  linkend="sec:hook:outgoing"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:pretag">
      <title><literal role="hook">pretag</literal>&emdash;before

	<listitem><para id="x_2c3"><literal>tag</literal>: A string.  The name of
	    the tag to be created.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2c4">If the tag to be created is
	revision-controlled, the <literal
	  role="hook">precommit</literal> and <literal
	  role="hook">pretxncommit</literal> hooks (<xref
	  linkend="sec:hook:commit"/> and <xref
	  linkend="sec:hook:pretxncommit"/>) will also be run.
      </para>

      <para id="x_2c5">See also: <literal role="hook">tag</literal>
	(<xref linkend="sec:hook:tag"/>)
      </para>
    </sect2>
    <sect2 id="sec:hook:pretxnchangegroup">
      <title><literal
	  role="hook">pretxnchangegroup</literal>&emdash;before

	      role="hg-cmd">hg pull</command>, <command
	      role="hg-cmd">hg push</command> or <command
	      role="hg-cmd">hg unbundle</command>.
	  </para>
	</listitem>
	<listitem><para id="x_2cc"><literal>source</literal>: A
	    string.  The source of these changes.  See <xref
	      linkend="sec:hook:sources"/> for details.
	  </para>
	</listitem>
	<listitem><para id="x_2cd"><literal>url</literal>: A URL.  The
	    location of the remote repository, if known.  See <xref
	      linkend="sec:hook:url"/> for more information.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2ce">See also: <literal
	  role="hook">changegroup</literal> (<xref
	  linkend="sec:hook:changegroup"/>), <literal
	  role="hook">incoming</literal> (<xref
	  linkend="sec:hook:incoming"/>), <literal
	  role="hook">prechangegroup</literal> (<xref
	  linkend="sec:hook:prechangegroup"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:pretxncommit">

	    The changeset ID of the second parent of the newly
	    committed changeset.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2d6">See also: <literal
	  role="hook">precommit</literal> (<xref
	  linkend="sec:hook:precommit"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:preupdate">
      <title><literal role="hook">preupdate</literal>&emdash;before
	updating or merging working directory</title>

      <para id="x_2d7">This controlling hook is run before an update
	or merge of the working directory begins.  It is run only if
	Mercurial's normal pre-update checks determine that the update
	or merge can proceed.  If the hook succeeds, the update or
	merge may proceed; if it fails, the update or merge does not
	start.
      </para>

      <para id="x_2d8">Parameters to this hook:
      </para>
      <itemizedlist>
	<listitem><para id="x_2d9"><literal>parent1</literal>: A
	    changeset ID. The ID of the parent that the working
	    directory is to be updated to.  If the working directory
	    is being merged, it will not change this parent.
	  </para>
	</listitem>
	<listitem><para id="x_2da"><literal>parent2</literal>: A
	    changeset ID. Only set if the working directory is being
	    merged.  The ID of the revision that the working directory
	    is being merged with.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2db">See also: <literal role="hook">update</literal>
	(<xref linkend="sec:hook:update"/>)</para>

    </sect2>
    <sect2 id="sec:hook:tag">
      <title><literal role="hook">tag</literal>&emdash;after tagging a
	changeset</title>

      <para id="x_2e1">If the created tag is revision-controlled, the <literal
	  role="hook">commit</literal> hook (section <xref
	  linkend="sec:hook:commit"/>) is run before this hook.
      </para>

      <para id="x_2e2">See also: <literal role="hook">pretag</literal>
	(<xref linkend="sec:hook:pretag"/>)
      </para>

    </sect2>
    <sect2 id="sec:hook:update">
      <title><literal role="hook">update</literal>&emdash;after

	    the revision that the working directory was merged with.
	  </para>
	</listitem></itemizedlist>

      <para id="x_2e7">See also: <literal role="hook">preupdate</literal>
	(<xref linkend="sec:hook:preupdate"/>)
      </para>

    </sect2>
  </sect1>
</chapter>