# HG changeset patch
# User Eli Zaretskii <eliz@gnu.org>
# Date 966961793 0
# Node ID e500b247bb59a01248ae05bfbdb4c5e52463b7af
# Parent  93f2d24e394243111b87b5a0e7dc6838d63c7b47
Document re-builder.

diff -r 93f2d24e3942 -r e500b247bb59 man/search.texi
--- a/man/search.texi	Tue Aug 22 16:08:36 2000 +0000
+++ b/man/search.texi	Tue Aug 22 16:29:53 2000 +0000
@@ -684,6 +684,19 @@
 enter a tab, and @kbd{C-j} to enter a newline.  You would also type
 single backslashes as themselves, instead of doubling them for Lisp syntax.
 
+@findex re-builder
+@cindex authoring regular expressions
+  For easier authoring of regular expressions, you can use the @kbd{M-x
+re-builder} command.  It provides a convenient interface for creating
+regular expressions, by giving immediate visual feedback.  The buffer
+from which @code{re-builder} was invoked becomes the target for the
+regexp editor, which pops in a separate window.  Text that matches the
+regular expression you typed so far is color marked in the target
+buffer.  Each parenthesized sub-expression of the regexp is shown in a
+distinct face, which makes it easier to verify even very complex
+regexps.  (On displays that don't support colors, Emacs blinks the
+cursor around the matched text, like it does for matching parens.)
+
 @node Search Case, Replace, Regexps, Search
 @section Searching and Case