- newfunction(:shell_escape, :type => :rvalue, :doc => <<-EOS
-Escapes a string so that it can be safely used in a Bourne shell command line.
+ newfunction(:shell_escape, :type => :rvalue, :doc => <<-DOC
+ @summary
+ Escapes a string so that it can be safely used in a Bourne shell command line.
+
+ @return
+ A string of characters with metacharacters converted to their escaped form.