Handle special case when converting an empty bare repository to a working copy repository
authorBruce Williams <bruce@codefluency.com>
Sat, 13 Mar 2010 09:35:05 +0000 (01:35 -0800)
committerBruce Williams <bruce@codefluency.com>
Sat, 13 Mar 2010 09:35:05 +0000 (01:35 -0800)
README.GIT.markdown

index 08545aa..4e3c095 100644 (file)
@@ -7,7 +7,8 @@ To create a blank repository
 Define a `vcsrepo` without a `source` or `revision`:
 
     vcsrepo { "/path/to/repo":
-      ensure: present
+      ensure => present,
+      provider => git
     }
 
 If you're defining this for a central/"official" repository, you'll
@@ -15,6 +16,34 @@ probably want to make it a "bare" repository.  Do this by setting
 `ensure` to `bare` instead of `present`:
 
     vcsrepo { "/path/to/repo":
-        ensure: bare
+        ensure => bare,
+        provider => git
+    }
+
+To clone/pull a repository
+----------------------------
+
+To get the current [master] HEAD:
+
+    vcsrepo { "/path/to/repo":
+        ensure => present,
+        provider => git,
+        source => "git://example.com/repo.git"
+    }
+
+For a specific revision (can be a commit SHA or tag):
+
+    vcsrepo { "/path/to/repo":
+        ensure => present,
+        provider => git,
+        source => 'git://example.com/repo.git',
+        revision => '0c466b8a5a45f6cd7de82c08df2fb4ce1e920a31'
+    }
+
+    vcsrepo { "/path/to/repo":
+        ensure => present,
+        provider => git,
+        source => 'git://example.com/repo.git',
+        revision => '1.1.2rc1'
     }