e96db89951990f40f58cf6d25b90e802c64392de
[puppet_vcsrepo.git] / README.HG.markdown
1 Using vcsrepo with Mercurial
2 ============================
3
4 To create a blank repository
5 ----------------------------
6
7 Define a `vcsrepo` without a `source` or `revision`:
8
9     vcsrepo { "/path/to/repo":
10       ensure   => present,
11       provider => hg
12     }
13
14 To clone/pull & update a repository
15 ----------------------------
16
17 To get the default branch tip:
18
19     vcsrepo { "/path/to/repo":
20         ensure   => present,
21         provider => hg,
22         source   => "http://hg.example.com/myrepo"
23     }
24
25 For a specific changeset, use `revision`:
26
27     vcsrepo { "/path/to/repo":
28         ensure   => present,
29         provider => hg,
30         source   => "http://hg.example.com/myrepo"
31         revision => '21ea4598c962'
32     }
33
34 You can also set `revision` to a tag:
35
36     vcsrepo { "/path/to/repo":
37         ensure   => present,
38         provider => hg,
39         source   => "http://hg.example.com/myrepo"
40         revision => '1.1.2'
41     }