Reword doc-string of Fcompare_buffer_substrings.

* editfns.c (Fcompare_buffer_substrings): Reword doc-string.

etc/NEWS

@@ -701,6 +701,10 @@ depends on the graphical library.
 that substring is inserted literally even if the LITERAL arg is
 non-nil, instead of causing an error to be signaled.
 
++++
+** `select-window' now always makes the window's buffer current.
+It does so even if the window was selected before.
+
 +++
 ** Docstrings starting with `*' no longer indicate user options.
 Only variables defined using `defcustom' are considered user options.

src/ChangeLog

@@ -1,3 +1,7 @@
+2012-12-07  Martin Rudalics  <rudalics@gmx.at>
+
+	* editfns.c (Fcompare_buffer_substrings): Reword doc-string.
+
 2012-12-05  Eli Zaretskii  <eliz@gnu.org>
 
 	* callproc.c (Fcall_process_region) [!HAVE_MKSTEMP]: If mktemp

src/editfns.c

@@ -2650,10 +2650,10 @@ They default to the values of (point-min) and (point-max) in BUFFER.  */)
 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings, Scompare_buffer_substrings,
        6, 6, 0,
        doc: /* Compare two substrings of two buffers; return result as number.
-the value is -N if first string is less after N-1 chars,
+Return -N if first string is less after N-1 chars, +N if first string is
-+N if first string is greater after N-1 chars, or 0 if strings match.
+greater after N-1 chars, or 0 if strings match.  Each substring is
-Each substring is represented as three arguments: BUFFER, START and END.
+represented as three arguments: BUFFER, START and END.  That makes six
-That makes six args in all, three for each substring.
+args in all, three for each substring.
 
 The value of `case-fold-search' in the current buffer
 determines whether case is significant or ignored.  */)