comparison mercurial/help/config.txt @ 27739:d6d3cf5fda6f

hooks: add HG_NODE_LAST to txnclose and changegroup hook environments

Sometimes a txnclose or changegroup hook wants to iterate through all
the changesets in transaction: in that situation usually the revset
`$HG_NODE:` is used to select the revisions. Unfortunately this revset
sometimes may contain too many changesets because we don't have the
write lock while the hook runs newer changes may be added to
repository in the meantime.

That's why there is a need for extra variable carrying the information about
the last change in the transaction.

27738:a0e783d26e81

Most hooks are run with environment variables set that give useful
additional information. For each hook below, the environment
variables it is passed are listed with names of the form ``$HG_foo``.

``changegroup``
  Run after a changegroup has been added via push, pull or unbundle.
  ID of the first new changeset is in ``$HG_NODE``. URL from which
  changes came is in ``$HG_URL``.

``commit``
  Run after a changeset has been created in the local repository. ID
  of the newly created changeset is in ``$HG_NODE``. Parent changeset
  IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.

  transaction will be in ``$HG_TXNNAME`` and a unique identifier for the
  transaction will be in ``HG_TXNID``. A non-zero status will prevent the
  transaction from being opened.

``pretxnclose``
  Run right before the transaction is actually finalized. Any
  repository change will be visible to the hook program. This lets you
  validate the transaction content or change it. Exit status 0 allows
  the commit to proceed. Non-zero status will cause the transaction to
  be rolled back. The reason for the transaction opening will be in
  ``$HG_TXNNAME`` and a unique identifier for the transaction will be in
  ``HG_TXNID``. The rest of the available data will vary according the
  transaction type. New changesets will add ``$HG_NODE`` (id of the
  first added changeset), ``$HG_URL`` and ``$HG_SOURCE`` variables,
  bookmarks and phases changes will set ``HG_BOOKMARK_MOVED`` and
  ``HG_PHASES_MOVED`` to ``1``, etc.

``txnclose``
  Run after any repository transaction has been committed. At this
  point, the transaction can no longer be rolled back. The hook will run
  after the lock is released. See :hg:`help config.pretxnclose` docs for

``txnabort``
  Run when a transaction is aborted. See :hg:`help config.pretxnclose`
  docs for details about available variables.

``pretxnchangegroup``
  Run after a changegroup has been added via push, pull or unbundle,
  but before the transaction has been committed. Changegroup is
  visible to hook program. This lets you validate incoming changes
  before accepting them. Passed the ID of the first new changeset in
  ``$HG_NODE``. Exit status 0 allows the transaction to commit. Non-zero
  status will cause the transaction to be rolled back and the push,
  pull or unbundle will fail. URL that was source of changes is in
  ``$HG_URL``.

``pretxncommit``
  Run after a changeset has been created but the transaction not yet
  committed. Changeset is visible to hook program. This lets you
  validate commit message and changes. Exit status 0 allows the

27739:d6d3cf5fda6f

Most hooks are run with environment variables set that give useful
additional information. For each hook below, the environment
variables it is passed are listed with names of the form ``$HG_foo``.

``changegroup``
  Run after a changegroup has been added via push, pull or unbundle.  ID of the
  first new changeset is in ``$HG_NODE`` and last in ``$HG_NODE_LAST``. URL
  from which changes came is in ``$HG_URL``.

``commit``
  Run after a changeset has been created in the local repository. ID
  of the newly created changeset is in ``$HG_NODE``. Parent changeset
  IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.

  transaction will be in ``$HG_TXNNAME`` and a unique identifier for the
  transaction will be in ``HG_TXNID``. A non-zero status will prevent the
  transaction from being opened.

``pretxnclose``
  Run right before the transaction is actually finalized. Any repository change
  will be visible to the hook program. This lets you validate the transaction
  content or change it. Exit status 0 allows the commit to proceed. Non-zero
  status will cause the transaction to be rolled back. The reason for the
  transaction opening will be in ``$HG_TXNNAME`` and a unique identifier for
  the transaction will be in ``HG_TXNID``. The rest of the available data will
  vary according the transaction type. New changesets will add ``$HG_NODE`` (id
  of the first added changeset), ``$HG_NODE_LAST`` (id of the last added
  changeset), ``$HG_URL`` and ``$HG_SOURCE`` variables, bookmarks and phases
  changes will set ``HG_BOOKMARK_MOVED`` and ``HG_PHASES_MOVED`` to ``1``, etc.

``txnclose``
  Run after any repository transaction has been committed. At this
  point, the transaction can no longer be rolled back. The hook will run
  after the lock is released. See :hg:`help config.pretxnclose` docs for

``txnabort``
  Run when a transaction is aborted. See :hg:`help config.pretxnclose`
  docs for details about available variables.

``pretxnchangegroup``
  Run after a changegroup has been added via push, pull or unbundle, but before
  the transaction has been committed. Changegroup is visible to hook program.
  This lets you validate incoming changes before accepting them. Passed the ID
  of the first new changeset in ``$HG_NODE`` and last in ``$HG_NODE_LAST``.
  Exit status 0 allows the transaction to commit. Non-zero status will cause
  the transaction to be rolled back and the push, pull or unbundle will fail.
  URL that was source of changes is in ``$HG_URL``.

``pretxncommit``
  Run after a changeset has been created but the transaction not yet
  committed. Changeset is visible to hook program. This lets you
  validate commit message and changes. Exit status 0 allows the