- newfunction(:flatten, :type => :rvalue, :doc => <<-EOS
-This function flattens any deeply nested arrays and returns a single flat array
-as a result.
+ newfunction(:flatten, :type => :rvalue, :doc => <<-DOC
+ @summary
+ This function flattens any deeply nested arrays and returns a single flat array
+ as a result.
+
+ @return
+ convert nested arrays into a single flat array