From: Chong Yidong <cyd@stupidchicken.com>
Date: Wed, 15 Apr 2009 21:54:15 +0000 (+0000)
Subject: * searching.texi (Regexp Backslash): Also refer to shy groups as
X-Git-Tag: emacs-pretest-23.0.93~126
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=80d7cdca53f26dfd282c654eadeda63e0ca09715;p=emacs.git

* searching.texi (Regexp Backslash): Also refer to shy groups as
non-capturing or unnumbered groups.
(Regexp Functions): Add cross-reference to Regexp Backslash.
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 073bdc41842..8cb1e0206b3 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,9 @@
 2009-04-15  Chong Yidong  <cyd@stupidchicken.com>
 
+	* searching.texi (Regexp Backslash): Also refer to shy groups as
+	non-capturing or unnumbered groups.
+	(Regexp Functions): Add cross-reference to Regexp Backslash.
+
 	* display.texi (Truncation): Overlays can use line-prefix and
 	wrap-prefix too.
 	(Overlay Properties): Document wrap-prefix and line-prefix.
diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index bc223f8ac3f..9c9b60fb201 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -654,14 +654,19 @@ occasionally there is a conflict, and that led to the introduction of
 shy groups.
 
 @item \(?: @dots{} \)
+@cindex shy groups
+@cindex non-capturing group
+@cindex unnumbered group
 is the @dfn{shy group} construct.  A shy group serves the first two
 purposes of an ordinary group (controlling the nesting of other
 operators), but it does not get a number, so you cannot refer back to
-its value with @samp{\@var{digit}}.
+its value with @samp{\@var{digit}}.  Shy groups are particularly
+useful for mechanically-constructed regular expressions, because they
+can be added automatically without altering the numbering of ordinary,
+non-shy groups.
 
-Shy groups are particularly useful for mechanically-constructed regular
-expressions because they can be added automatically without altering the
-numbering of any ordinary, non-shy groups.
+Shy groups are also called @dfn{non-capturing} or @dfn{unnumbered
+groups}.
 
 @item \(?@var{num}: @dots{} \)
 is the @dfn{explicitly numbered group} construct.  Normal groups get
@@ -939,8 +944,8 @@ regular expression which is equivalent to the actual value
 
 @defun regexp-opt-depth regexp
 This function returns the total number of grouping constructs
-(parenthesized expressions) in @var{regexp}.  (This does not include
-shy groups.)
+(parenthesized expressions) in @var{regexp}.  This does not include
+shy groups (@pxref{Regexp Backslash}).
 @end defun
 
 @node Regexp Search