Fix return value documentation on dispatch call

[warn]: The docstring for Puppet 4.x function 'foo' contains @return tags near lib/puppet/functions/foo.rb:42: return value documentation should be made on the dispatch call.
[warn]: Missing @return tag near lib/puppet/functions/foo.rb:42.

Author: smortex

lib/puppet/functions/parsehocon.rb

@@ -4,15 +4,13 @@
 #   This function accepts HOCON as a string and converts it into the correct
 #   Puppet structure
 #
-# @return
-#   Data
-#
 # @example How to parse hocon
 #   $data = parsehocon("{any valid hocon: string}")
 #
 Puppet::Functions.create_function(:parsehocon) do
   # @param hocon_string A valid HOCON string
   # @param default An optional default to return if parsing hocon_string fails
+  # @return [Data]
   dispatch :parsehocon do
     param          'String', :hocon_string
     optional_param 'Any',    :default

lib/puppet/functions/to_python.rb

@@ -15,15 +15,15 @@
 #   }
 
 Puppet::Functions.create_function(:to_python) do
-  dispatch :to_python do
-    param 'Any', :object
-  end
-
   # @param object
   #   The object to be converted
   #
   # @return [String]
   #   The String representation of the object
+  dispatch :to_python do
+    param 'Any', :object
+  end
+
   def to_python(object)
     serialized = Puppet::Pops::Serialization::ToDataConverter.convert(object, rich_data: true)
     serialized_to_python(serialized)

lib/puppet/functions/to_ruby.rb

@@ -15,15 +15,15 @@
 #   }
 
 Puppet::Functions.create_function(:to_ruby) do
-  dispatch :to_ruby do
-    param 'Any', :object
-  end
-
   # @param object
   #   The object to be converted
   #
   # @return [String]
   #   The String representation of the object
+  dispatch :to_ruby do
+    param 'Any', :object
+  end
+
   def to_ruby(object)
     serialized = Puppet::Pops::Serialization::ToDataConverter.convert(object, rich_data: true)
     serialized_to_ruby(serialized)