Add README for Mercurial

README.HG.markdown

@@ -0,0 +1,32 @@
+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'
+    }