[Emacs-diffs] emacs/doc/lispref ChangeLog searching.texi

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      09/04/10 04:48:05

Modified files:
        doc/lispref    : ChangeLog searching.texi 

Log message:
        * searching.texi (String Search): Document word-search-forward-lax
        and word-search-backward-lax.
        (Searching and Case): Describe isearch behavior more precisely.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.255&r2=1.256
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/searching.texi?cvsroot=emacs&r1=1.11&r2=1.12

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.255
retrieving revision 1.256
diff -u -b -r1.255 -r1.256
--- ChangeLog   10 Apr 2009 02:12:01 -0000      1.255
+++ ChangeLog   10 Apr 2009 04:48:05 -0000      1.256
@@ -1,5 +1,9 @@
 2009-04-10  Chong Yidong  <address@hidden>
 
+       * searching.texi (String Search): Document word-search-forward-lax
+       and word-search-backward-lax.
+       (Searching and Case): Describe isearch behavior more precisely.
+
        * keymaps.texi (Tool Bar): Mention that some platforms do not
        support multi-line toolbars.  Suggested by Stephen Eglen.
 

Index: searching.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/searching.texi,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -b -r1.11 -r1.12
--- searching.texi      8 Jan 2009 05:29:01 -0000       1.11
+++ searching.texi      10 Apr 2009 04:48:05 -0000      1.12
@@ -106,11 +106,9 @@
 @end deffn
 
 @deffn Command word-search-forward string &optional limit noerror repeat
address@hidden  @cindex word search   Redundant
 This function searches forward from point for a ``word'' match for
 @var{string}.  If it finds a match, it sets point to the end of the
 match found, and returns the new value of point.
address@hidden Emacs 19 feature
 
 Word matching regards @var{string} as a sequence of words, disregarding
 punctuation that separates them.  It searches the buffer for the same
@@ -155,6 +153,13 @@
 times.  Point is positioned at the end of the last match.
 @end deffn
 
address@hidden Command word-search-forward-lax string &optional limit noerror 
repeat
+This command is identical to @code{word-search-forward}, except that
+the end of @code{string} need not match a word boundary unless it ends
+in whitespace.  For instance, searching for @samp{ball boy} matches
address@hidden boyee}, but does not match @samp{aball boy}.
address@hidden deffn
+
 @deffn Command word-search-backward string &optional limit noerror repeat
 This function searches backward from point for a word match to
 @var{string}.  This function is just like @code{word-search-forward}
@@ -162,6 +167,12 @@
 beginning of the match.
 @end deffn
 
address@hidden Command word-search-backward-lax string &optional limit noerror 
repeat
+This command is identical to @code{word-search-backward}, except that
+the end of @code{string} need not match a word boundary unless it ends
+in whitespace.
address@hidden deffn
+
 @node Searching and Case
 @section Searching and Case
 @cindex searching and case
@@ -181,21 +192,11 @@
 @code{case-fold-search} for buffers that do not override it.
 
   Note that the user-level incremental search feature handles case
-distinctions differently.  When given a lower case letter, it looks for
-a match of either case, but when given an upper case letter, it looks
-for an upper case letter only.  But this has nothing to do with the
-searching functions used in Lisp code.
-
address@hidden case-replace
-This variable determines whether the higher level replacement
-functions should preserve case.  If the variable is @code{nil}, that
-means to use the replacement text verbatim.  A address@hidden value
-means to convert the case of the replacement text according to the
-text being replaced.
-
-This variable is used by passing it as an argument to the function
address@hidden  @xref{Replacing Match}.
address@hidden defopt
+distinctions differently.  When the search string contains only lower
+case letters, the search ignores case, but when the search string
+contains one or more upper case letters, the search becomes
+case-sensitive.  But this has nothing to do with the searching
+functions used in Lisp code.
 
 @defopt case-fold-search
 This buffer-local variable determines whether searches should ignore
@@ -209,12 +210,23 @@
 same as @code{(default-value 'case-fold-search)}.
 @end defvar
 
address@hidden case-replace
+This variable determines whether the higher level replacement
+functions should preserve case.  If the variable is @code{nil}, that
+means to use the replacement text verbatim.  A address@hidden value
+means to convert the case of the replacement text according to the
+text being replaced.
+
+This variable is used by passing it as an argument to the function
address@hidden  @xref{Replacing Match}.
address@hidden defopt
+
 @node Regular Expressions
 @section Regular Expressions
 @cindex regular expression
 @cindex regexp
 
-  A @dfn{regular expression} (@dfn{regexp}, for short) is a pattern that
+  A @dfn{regular expression}, or @dfn{regexp} for short, is a pattern that
 denotes a (possibly infinite) set of strings.  Searching for matches for
 a regexp is a very powerful operation.  This section explains how to write
 regexps; the following section says how to search for them.