branches

    hg pull [-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SOURCE]...

pull changes from the specified source

    Pull changes from a remote repository to a local one.

    This finds all changes from the repository at the specified path
    or URL and adds them to a local repository (the current one unless
    -R is specified). By default, this does not update the copy of the
    project in the working directory.

    When cloning from servers that support it, Mercurial may fetch
    pre-generated data. When this is done, hooks operating on incoming
    changesets and changegroups may fire more than once, once for each
    pre-generated bundle and as well as for any additional remaining
    data. See :hg:`help -e clonebundles` for more.

    Use :hg:`incoming` if you want to see what would have been added
    by a pull at the time you issued this command. If you then decide
    to add those changes to the repository, you should use :hg:`pull
    -r X` where ``X`` is the last changeset listed by :hg:`incoming`.

    If SOURCE is omitted, the 'default' path will be used.
    See :hg:`help urls` for more information.

    If multiple sources are specified, they will be pulled sequentially as if
    the command was run multiple time. If --update is specify and the command
    will stop at the first failed --update.

    Specifying bookmark as ``.`` is equivalent to specifying the active
    bookmark's name.

    .. container:: verbose

        One can use the `--remote-hidden` flag to pull changesets
        hidden on the remote. This flag is "best effort", and will only
        work if the server supports the feature and is configured to
        allow the user to access hidden changesets. This option is
        experimental and backwards compatibility is not garanteed.

    Returns 0 on success, 1 if an update had unresolved files.
    

options ([+] can be repeated):

 == ======================= ==============================================================
 -u --update                update to new branch head if new descendants were pulled      
 -f --force                 run even when remote repository is unrelated                  
    --confirm               confirm pull before applying changes                          
 -r --rev REV [+]           a remote changeset intended to be added                       
 -B --bookmark BOOKMARK [+] bookmark to pull                                              
 -b --branch BRANCH [+]     a specific branch you would like to pull                      
    --remote-hidden         include changesets hidden on the remote (EXPERIMENTAL)        
 -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)
 == ======================= ==============================================================

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: utf-8)                         
    --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)
 == =================== ==================================================================