Ruby

I very much think the output record separator was meant, and I suggest the following:

diff --git a/io.c b/io.c index cd615fb..fabd5d5 100644 --- a/io.c +++ b/io.c @@ -7185,15 +7185,17 @@ io_puts_ary(VALUE ary, VALUE out, int recur) * call-seq: * ios.puts(obj, ...) -> nil * - * Writes the given object(s) to <em>ios</em> as with <code>IO#write</code>. + * Writes the given object(s) to <em>ios</em>.  * Writes a newline after any that do not already end - * with a newline sequence. + * with a newline sequence. Returns +nil+.  * + * The stream must be opened for writing.  * If called with an array argument, writes each element on a new line. + * Each given object that isn't a string or array will be converted + * by calling its <code>to_s</code> method.  * If called without arguments, outputs a single newline. - * This doesn't affect $/. ($RS or $INPUT_RECORD_SEPARATOR in English.rb)  * - * $stdout.puts("this", "is", "a", "test") + * $stdout.puts("this", "is", ["a", "test"])  * * <em>produces:</em> * @@ -7201,6 +7203,9 @@ io_puts_ary(VALUE ary, VALUE out, int recur) * is * a * test + * + * Note that +puts+ always uses newlines and is not affected + * by the output record separator (<code>$\\</code>).  */ VALUE -- 1.9.1 

Since the record separator is of no use here, IMO it doesn't make sense to mention "English"; furthermore, the other methods of IO also only mention the "non-English" forms.

I'll apply in a couple of days unless there are objections.