# hg incoming

## show new changesets found in source

Contents

- Synopsis
- Description
- Options
- Aliases

# Synopsis

    hg incoming [-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SOURCE]

# Description

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.

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.

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.

# Options

`-f, --force` | run even if remote repository is unrelated
`-n, --newest-first`
| show newest record first
`--bundle <FILE>`
| file to store the bundles into
`-r, --rev <REV[+]>`
| a remote changeset intended to be added
`-B, --bookmarks`
| compare bookmarks
`-b, --branch <BRANCH[+]>`
| a specific branch you would like to pull
`-p, --patch` | show patch
`-g, --git` | use git extended diff format
`-l, --limit <NUM>`
| limit number of changes displayed
`-M, --no-merges`
| do not show merges
`--stat` | output diffstat-style summary of changes
`-G, --graph` | show the revision DAG
`--style <STYLE>`
| display using template map file (DEPRECATED)
`-T, --template <TEMPLATE>`
| display with template
`-e, --ssh <CMD>`
| specify ssh command to use
`--remotecmd <CMD>`
| specify hg command to run on the remote side
`--insecure` | do not verify server certificate (ignoring web.cacerts config)
`-S, --subrepos` | recurse into subrepositories

[+] marked option can be specified multiple times

# Aliases

    in