NAME

       hg pull - pull changes from the specified source

SYNOPSIS

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

DESCRIPTION

       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.

       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

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

              [+] marked option can be specified multiple times

                                                                                                        HG(PULL)