Improve the docstring of case-fold-search

[Bastien <bastienguerry@googlemail.com>]

[-- Attachment #1: Type: text/plain, Size: 508 bytes --]

I suggest to complete the docstring of `case-fold-search' like the
attached patch does.

In the current docstring, the expression "ignore case" is not really
appropriate because the search will not ignore uppercase characters in
the search string.  A very short way to tell this would be "*Non-nil if
searches and matches should ignore lowercase."  But while accurate, this
is confusing IMO.  Hence the long sentence in this patch, inspired by
the "Search case" section of Emacs manual.

Should I apply it?


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: buffer.c.patch --]
[-- Type: text/x-diff, Size: 571 bytes --]

--- buffer.c.~1.583.~	2009-07-17 21:12:21.000000000 +0200
+++ buffer.c	2009-07-22 03:55:26.000000000 +0200
@@ -5727,7 +5727,9 @@
 
   DEFVAR_PER_BUFFER ("case-fold-search", &current_buffer->case_fold_search,
 		     Qnil,
-		     doc: /* *Non-nil if searches and matches should ignore case.  */);
+		     doc: /* *Non-nil if searches and matches should ignore case.
+If there is an uppercase character in the search string
+then the search becomes case sensitive.  */);
 
   DEFVAR_PER_BUFFER ("fill-column", &current_buffer->fill_column,
 		     make_number (Lisp_Int),

[-- Attachment #3: Type: text/plain, Size: 14 bytes --]


-- 
 Bastien