[Pkg-puppet-devel] [SCM] Puppet packaging for Debian branch, experimental, updated. debian/2.6.8-1-844-g7ec39d5

[James Turnbull]

The following commit has been merged in the experimental branch:
commit ee1df783ddd4b72bd959735443b5dbdfea69e323
Author: Ben Hughes <ben at puppetlabs.com>
Date:   Fri Apr 1 12:48:38 2011 +1100

    (#6937) Document the recurse parameter of File type.
    
    Update the desc block with information gleaned from #1469 and the code
    about recurse => remote and other types of recursion.
    
    The auto generated documentation was sparse and this is an area that often
    comes up on the mailing list/IRC.

diff --git a/lib/puppet/type/file.rb b/lib/puppet/type/file.rb
index 1a6d0c3..a73ada5 100644
--- a/lib/puppet/type/file.rb
+++ b/lib/puppet/type/file.rb
@@ -122,7 +122,17 @@ Puppet::Type.newtype(:file) do
 
   newparam(:recurse) do
     desc "Whether and how deeply to do recursive
-      management."
+      management. Options are:
+        inf,true  => Regular style recursion on both remote and local
+                     directory structure.
+        remote    => Descends recursively into the remote directory
+                     but not the local directory. Allows copying of
+                     a few files into a directory containing many
+                     unmanaged files without scanning all the local files.
+        false     => Default of no-recursion.
+        [0-9]+    => Both, but limit recursion. Warning: this syntax
+                     is deprecated and has moved to recurselimit.
+    "
 
     newvalues(:true, :false, :inf, :remote, /^[0-9]+$/)
 

-- 
Puppet packaging for Debian