:orphan:

hg incoming
===========

show new changesets found in source
-----------------------------------

Show new changesets found in the specified path/URL or the default
pull location. These are the changesets that would have been pulled
by :hg:`pull` at the time you issued this command.

See pull for valid source format details.

.. container:: verbose

  With -B/--bookmarks, the result of bookmark comparison between
  local and remote repositories is displayed. With -v/--verbose,
  status is also displayed for each bookmark like below::

    BM1               01234567890a added
    BM2               1234567890ab advanced
    BM3               234567890abc diverged
    BM4               34567890abcd changed

  The action taken locally when pulling depends on the
  status of each bookmark:

  :``added``: pull will create it
  :``advanced``: pull will update it
  :``diverged``: pull will create a divergent bookmark
  :``changed``: result depends on remote changesets

  From the point of view of pulling behavior, bookmark
  existing only in the remote repository are treated as ``added``,
  even if it is in fact locally deleted.

.. container:: verbose

  For remote repository, using --bundle avoids downloading the
  changesets twice if the incoming is followed by a pull.

  Examples:

  - show incoming changes with patches and full description::

      hg incoming -vp

  - show incoming changes excluding merges, store a bundle::

      hg in -vpM --bundle incoming.hg
      hg pull incoming.hg

  - briefly list changes inside a bundle::

      hg in changes.hg -T "{desc|firstline}\n"

Returns 0 if there are incoming changes, 1 otherwise.