Fix "Missing documentation for Puppet function"

[warn]: Missing documentation for Puppet function 'foo' at lib/puppet/parser/functions/foo.rb:42
[warn]: Missing @return tag near lib/puppet/parser/functions/foo.rb:42

Author: smortex

lib/puppet/parser/functions/defined_with_params.rb

@@ -5,7 +5,7 @@
 
 Puppet::Parser::Functions.newfunction(:defined_with_params,
                                       type: :rvalue,
-                                      doc: <<-DOC,
+                                      doc: <<-DOC
     @summary
       Takes a resource reference and an optional hash of attributes.
 

lib/puppet/parser/functions/dig44.rb

@@ -8,7 +8,7 @@ module Puppet::Parser::Functions
     :dig44,
     type: :rvalue,
     arity: -2,
-    doc: <<-DOC,
+    doc: <<-DOC
     @summary
       **DEPRECATED**: Looks up into a complex structure of arrays and hashes and returns a value
       or the default value if nothing was found.

lib/puppet/parser/functions/ensure_resource.rb

@@ -5,7 +5,7 @@
 
 Puppet::Parser::Functions.newfunction(:ensure_resource,
                                       type: :statement,
-                                      doc: <<-DOC,
+                                      doc: <<-DOC
   @summary
     Takes a resource type, title, and a list of attributes that describe a
     resource.

lib/puppet/parser/functions/ensure_resources.rb

@@ -4,7 +4,7 @@
 
 Puppet::Parser::Functions.newfunction(:ensure_resources,
                                       type: :statement,
-                                      doc: <<-DOC,
+                                      doc: <<-DOC
   @summary
     Takes a resource type, title (only hash), and a list of attributes that describe a
     resource.

lib/puppet/parser/functions/fqdn_rand_string.rb

@@ -4,7 +4,7 @@
   :fqdn_rand_string,
   arity: -2,
   type: :rvalue,
-  doc: <<-DOC,
+  doc: <<-DOC
   @summary
     Generates a random alphanumeric string. Combining the `$fqdn` fact and an
     optional seed for repeatable randomness.

lib/puppet/parser/functions/fqdn_rotate.rb

@@ -6,7 +6,7 @@
 Puppet::Parser::Functions.newfunction(
   :fqdn_rotate,
   type: :rvalue,
-  doc: <<-DOC,
+  doc: <<-DOC
   @summary
     Rotates an array or string a random number of times, combining the `$fqdn` fact
     and an optional seed for repeatable randomness.

lib/puppet/parser/functions/getparam.rb

@@ -5,7 +5,7 @@
 
 Puppet::Parser::Functions.newfunction(:getparam,
                                       type: :rvalue,
-                                      doc: <<-'DOC',
+                                      doc: <<-'DOC'
     @summary
       Returns the value of a resource's parameter.
 

lib/puppet/parser/functions/pw_hash.rb

@@ -7,7 +7,7 @@
   :pw_hash,
   type: :rvalue,
   arity: 3,
-  doc: <<-DOC,
+  doc: <<-DOC
   @summary
     Hashes a password using the crypt function. Provides a hash usable
     on most POSIX systems.

lib/puppet/parser/functions/seeded_rand.rb

@@ -7,7 +7,7 @@
   :seeded_rand,
   arity: 2,
   type: :rvalue,
-  doc: <<-DOC,
+  doc: <<-DOC
     @summary
       Generates a random whole number greater than or equal to 0 and less than MAX, using the value of SEED for repeatable randomness.
 

lib/puppet/parser/functions/try_get_value.rb

@@ -8,7 +8,7 @@ module Puppet::Parser::Functions
     :try_get_value,
     type: :rvalue,
     arity: -2,
-    doc: <<-DOC,
+    doc: <<-DOC
       @summary
         **DEPRECATED:** this function is deprecated, please use dig() instead.