From f4a0bf04910db6e6b5faac21b2299ce8ce476b59 Mon Sep 17 00:00:00 2001
From: Dario Daic <dariodaic5.1@gmail.com>
Date: Thu, 24 Nov 2016 10:11:10 +0100
Subject: [PATCH] Edit documentation for IO#print

Important changes made:
- Delete duplicate sentence regarding global variable "$_"
- Split the whole paragraph into three semantically related smaller ones
- Emphasiz names of separators
- Add "and is a string" where usage of "$'" and "$\" is explained
---
 io.c | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/io.c b/io.c
index 716bc6d..9c3cb3c 100644
--- a/io.c
+++ b/io.c
@@ -6971,15 +6971,16 @@ rb_f_printf(int argc, VALUE *argv)
  *     ios.print()             -> nil
  *     ios.print(obj, ...)     -> nil
  *
- *  Writes the given object(s) to <em>ios</em>. The stream must be
- *  opened for writing. If the output field separator (<code>$,</code>)
- *  is not <code>nil</code>, it will be inserted between each object.
- *  If the output record separator (<code>$\\</code>)
- *  is not <code>nil</code>, it will be appended to the output. If no
- *  arguments are given, prints <code>$_</code>. Objects that aren't
- *  strings will be converted by calling their <code>to_s</code> method.
- *  With no argument, prints the contents of the variable <code>$_</code>.
- *  Returns <code>nil</code>.
+ *  Writes the given object(s) to <em>ios</em>. The stream must be opened for writing.
+ *
+ *  Each given object that isn't a string will be converted to one by calling
+ *  its <code>to_s</code> method. It always returns <code>nil</code>.
+ *
+ *  When called without arguments it prints out the contents of <code>$_</code>.
+ *  If the <em>output field separator</em> (<code>$,</code>) is not <code>nil</code>,
+ *  and is a string, it is inserted between objects.
+ *  If the <em>output record separator</em> (<code>$\\</code>) is not <code>nil</code>,
+ *  and is a string, it is appended to the output.
  *
  *     $stdout.print("This is ", 100, " percent.\n")
  *
-- 
2.7.4