[F009] Pull

This functionality aims to surround : hg pull and to adapt it for <ant> tags.

Shell command


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.

    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 added those
    changes to the repository, you should use 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.

options:

 -u --update     update to new tip if changesets were pulled
 -f --force      run even when remote repository is unrelated
 -r --rev        a specific remote revision up to which you would like to pull
 -e --ssh        specify ssh command to use
    --remotecmd  specify hg command to run on the remote side

use "hg -v help pull" to show global options

Parameters

Attribute Description Value Required
dir the local directory no : uses current directory by default
source the local or remote source to pull - http://url
- https://url
- file://path | path
- ssh://url
NEED HELP FOR SSH 		no : hg uses hgrc configuration by default
update update to new tip if changesets were pulled true/false, yes/no, on/off no
force run even when remote repository is unrelated true/false, yes/no, on/off no
revision a specific revision up to which you would like to pull no
ssh specify ssh command to use no
remotecmd specify hg command to run on the remote side no
Nested element Description Required
dirset resource collections no
arg command line argument value no
auth authentification no : hg uses hgrc configuration by default

Examples


# without prompt using read-only access
<hg cmd="pull" dir="ant4hg" source="http://hg.code.sf.net/p/ant4hg/code"/>

# using ant4hg authentification :
<hg cmd="pull" 
    dir="/my/local/dir/"
    source="http://mercurial.intuxication.org/hg/ant4hg-tests" 
    update="true">
  <auth user="ant4hg" password="******" />
</hg>

# using hgrc configuration :
<hg cmd="pull" dir="my/local/repository"/>

# hgrc : 
[paths]
default=http://mercurial.intuxication.org/hg/ant4hg-tests
default-push=http://mercurial.intuxication.org/hg/ant4hg-tests  

[auth]
ant4hg.prefix = http://mercurial.intuxication.org
ant4hg.username = ant4hg
ant4hg.password = ******
ant4hg.schemes = http