- newfunction(:difference, :type => :rvalue, :doc => <<-EOS
-This function returns the difference between two arrays.
-The returned array is a copy of the original array, removing any items that
-also appear in the second array.
+ newfunction(:difference, :type => :rvalue, :doc => <<-DOC
+ @summary
+ This function returns the difference between two arrays.
+
+ The returned array is a copy of the original array, removing any items that
+ also appear in the second array.
+
+ @example Example usage
+
+ difference(["a","b","c"],["b","c","d"])
+ Would return: `["a"]`