README.HG.markdown


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

Using vcsrepo with Mercurial
============================

To create a blank repository
----------------------------

Define a `vcsrepo` without a `source` or `revision`:

    vcsrepo { "/path/to/repo":
      ensure   => present,
      provider => hg
    }

To clone/pull & update a repository
----------------------------

To get the default branch tip:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "http://hg.example.com/myrepo"
    }

For a specific changeset, use `revision`:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "http://hg.example.com/myrepo"
        revision => '21ea4598c962'
    }

You can also set `revision` to a tag:

    vcsrepo { "/path/to/repo":
        ensure   => present,
        provider => hg,
        source   => "http://hg.example.com/myrepo"
        revision => '1.1.2'
    }