More param documentation

lib/puppet/functions/dehydrated/file.rb

@@ -6,6 +6,8 @@
 require 'base64'
 
 Puppet::Functions.create_function(:'dehydrated::file') do
+  # @param files File to check
+  # @param more_files optional other files to check
   dispatch :getfile do
     required_param 'String', :files
     optional_repeated_param 'String', :more_files

lib/puppet/type/dehydrated_csr.rb

@@ -9,6 +9,7 @@
   desc 'CSRs for dehydrated'
 
   newparam(:path, namevar: true) do
+    desc 'Absolute path of the CSR location'
     validate do |value|
       path = Pathname.new(value)
       raise ArgumentError, "Path must be absolute: #{path}" unless path.absolute?
@@ -26,6 +27,7 @@
   end
 
   newparam(:private_key) do
+    desc 'Absolute path of the key we want to use'
     defaultto do
       path = Pathname.new(@resource[:path])
       "#{path.dirname}/#{path.basename(path.extname)}.key"

lib/puppet/type/dehydrated_dhparam.rb

@@ -8,6 +8,7 @@
   desc 'DH params for dehydrated'
 
   newparam(:path, namevar: true) do
+    desc 'Absolute pathname of the DH file'
     validate do |value|
       path = Pathname.new(value)
       raise ArgumentError, "Path must be absolute: #{path}" unless path.absolute?

lib/puppet/type/dehydrated_pfx.rb

@@ -6,6 +6,7 @@
   desc 'pkcs12 / pfx files for dehydrated'
 
   newparam(:path, namevar: true) do
+    desc 'Absolute path of the pfx file'
     validate do |value|
       path = Pathname.new(value)
       raise ArgumentError, "Path must be absolute: #{path}" unless path.absolute?
@@ -48,6 +49,7 @@
   end
 
   newparam(:private_key) do
+    desc 'absolute path of the private keyfile'
     defaultto do
       path = Pathname.new(@resource[:path])
       "#{path.dirname}/#{path.basename(path.extname)}.key"