From: Paul Eggert <eggert@cs.ucla.edu>
Date: Sun, 15 Dec 2024 07:16:10 +0000 (-0700)
Subject: Update documentation of 'etags' regexps some more
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=163a1c09a65f45a7a2bb3605f16ce5db4696a3cd;p=emacs.git

Update documentation of 'etags' regexps some more

* doc/emacs/maintaining.texi (Etags Regexps):
* doc/man/etags.1: Give more details about what's not supported.

(cherry picked from commit 856a58e28279139cfd6503917954fd75fcdd7e78)
---

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 561a810eec2..e4a4d166f99 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -3113,8 +3113,12 @@ 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.  Shy groups are not
-supported by @command{etags}.
+@samp{\d} stands for the @code{DEL} character.  Otherwise,
+the regular expression syntax is the same as Emacs
+except that backslash escapes are the same
+as GNU grep (which means, for example, that shy groups are not supported),
+and @samp{[:ascii:]}, @samp{[:multibyte:]}, @samp{[:nonascii:]},
+@samp{[:word:]}, and @samp{[:unibyte:]} are not supported.
 
   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 12c2afc88b2..d26e2445e44 100644
--- a/doc/man/etags.1
+++ b/doc/man/etags.1
@@ -185,7 +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, except that shy groups are not supported.
+the same as in Emacs, except that backslash escapes are the same
+as GNU grep (which means, for example, that shy groups are not supported),
+and \fB[:ascii:]\fP, \fB[:multibyte:]\fP, \fB[:nonascii:]\fP,
+\fB[:word:]\fP, and \fB[:unibyte:]\fP 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.