- newfunction(:join_keys_to_values, :type => :rvalue, :doc => <<-EOS
-This function joins each key of a hash to that key's corresponding value with a
-separator. Keys and values are cast to strings. The return value is an array in
-which each element is one joined key/value pair.
+ newfunction(:join_keys_to_values, :type => :rvalue, :doc => <<-DOC
+ @summary
+ This function joins each key of a hash to that key's corresponding value with a
+ separator.
+
+ Keys are cast to strings. If values are arrays, multiple keys
+ are added for each element. The return value is an array in
+ which each element is one joined key/value pair.