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

aliases: in

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.


      - 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 ([+] can be repeated):

 == =================== ==============================================================
 -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                                  
 == =================== ==============================================================

global options ([+] can be repeated):

 == =================== ==================================================================
 -R --repository REPO   repository root directory or name of overlay bundle file          
    --cwd DIR           change working directory                                          
 -y --noninteractive    do not prompt, automatically pick the first choice for all prompts
 -q --quiet             suppress output                                                   
 -v --verbose           enable additional output                                          
    --color TYPE        when to colorize (boolean, always, auto, never, or debug)         
    --config CONFIG [+] set/override config option (use 'section.name=value')             
    --debug             enable debugging output                                           
    --debugger          start debugger                                                    
    --encoding ENCODE   set the charset encoding (default: ascii)                         
    --encodingmode MODE set the charset encoding mode (default: strict)                   
    --traceback         always print a traceback on exception                             
    --time              time how long the command takes                                   
    --profile           print command execution profile                                   
    --version           output version information and exit                               
 -h --help              display help and exit                                             
    --hidden            consider hidden changesets                                        
    --pager TYPE        when to paginate (boolean, always, auto, or never) (default: auto)
 == =================== ==================================================================