From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 15 Dec 2024 05:52:40 +0000 (+0200)
Subject: Update documentation of 'etags' regexps
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=369348b59edf9064b8f8d8e905881e197a8d9acc;p=emacs.git

Update documentation of 'etags' regexps

* doc/emacs/maintaining.texi (Etags Regexps):
* doc/man/etags.1: Say that shy groups are not supported (bug#74861).

(cherry picked from commit 4c68846223b91e50e4a15fbc59d2238605ce2a57)
---

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 9faa9dbf512..561a810eec2 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -3113,7 +3113,8 @@ and all the C character escape sequences are supported: @samp{\a} for
 bell, @samp{\b} for back space, @samp{\e} for escape, @samp{\f} for
 formfeed, @samp{\n} for newline, @samp{\r} for carriage return,
 @samp{\t} for tab, and @samp{\v} for vertical tab.  In addition,
-@samp{\d} stands for the @code{DEL} character.
+@samp{\d} stands for the @code{DEL} character.  Shy groups are not
+supported by @command{etags}.
 
   Ideally, @var{tagregexp} should not match more characters than are
 needed to recognize what you want to tag.  If the syntax requires you
diff --git a/doc/man/etags.1 b/doc/man/etags.1
index 9b8df50a6bb..12c2afc88b2 100644
--- a/doc/man/etags.1
+++ b/doc/man/etags.1
@@ -1,5 +1,5 @@
 .\" See section COPYING for copyright and redistribution information.
-.TH ETAGS 1 "2022-06-10" "GNU Tools" "GNU"
+.TH ETAGS 1 "2024-12-15" "GNU Tools" "GNU"
 .de BP
 .sp
 .ti -.2i
@@ -185,10 +185,10 @@ useless characters.  If the match is such that more characters than
 needed are unavoidably matched by \fItagregexp\fP, it may be useful to
 add a \fInameregexp\fP, to narrow down the tag scope.  \fBctags\fP
 ignores regexps without a \fInameregexp\fP.  The syntax of regexps is
-the same as in emacs.  The following character escape sequences are
-supported: \\a, \\b, \\d, \\e, \\f, \\n, \\r, \\t, \\v, which
-respectively stand for the ASCII characters BEL, BS, DEL, ESC, FF, NL,
-CR, TAB, VT.
+the same as in emacs, except that shy groups are not supported.
+The following character escape sequences are supported:
+\\a, \\b, \\d, \\e, \\f, \\n, \\r, \\t, \\v, which respectively
+stand for the ASCII characters BEL, BS, DEL, ESC, FF, NL, CR, TAB, VT.
 .br
 The \fImodifiers\fP are a sequence of 0 or more characters among
 \fIi\fP, which means to ignore case when matching; \fIm\fP, which means