--- a/modules/stdlib/lib/puppet/parser/functions/union.rb	Sat Jan 04 11:42:45 2020 +0000
+++ b/modules/stdlib/lib/puppet/parser/functions/union.rb	Sun Jan 26 11:36:07 2020 +0000
@@ -3,13 +3,15 @@
 #
 module Puppet::Parser::Functions
   newfunction(:union, :type => :rvalue, :doc => <<-DOC
-    This function returns a union of two or more arrays.
-
-    *Examples:*
+    @summary
+      This function returns a union of two or more arrays.
 
-        union(["a","b","c"],["b","c","d"])
+    @return
+      a unionized array of two or more arrays
+    @example **Usage**
 
-    Would return: ["a","b","c","d"]
+      union(["a","b","c"],["b","c","d"])
+      Would return: ["a","b","c","d"]
     DOC
              ) do |arguments|