procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update documentation of 'etags' regexps some more

Browse source 
* doc/emacs/maintaining.texi (Etags Regexps):
* doc/man/etags.1: Give more details about what's not supported.
This commit is contained in:
Paul Eggert 2024-12-15 00:16:10 -07:00
parent 4c68846223
commit 856a58e282
2 changed files with 10 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
doc/emacs/maintaining.texi
View file

@ -3094,8 +3094,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 bell, @samp{\b} for back space, @samp{\e} for escape, @samp{\f} for
formfeed, @samp{\n} for newline, @samp{\r} for carriage return, formfeed, @samp{\n} for newline, @samp{\r} for carriage return,
@samp{\t} for tab, and @samp{\v} for vertical tab. In addition, @samp{\t} for tab, and @samp{\v} for vertical tab. In addition,
@samp{\d} stands for the @code{DEL} character. Shy groups are not @samp{\d} stands for the @code{DEL} character. Otherwise,
supported by @command{etags}. 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 Ideally, @var{tagregexp} should not match more characters than are
needed to recognize what you want to tag. If the syntax requires you needed to recognize what you want to tag. If the syntax requires you

5
doc/man/etags.1
View file

@ -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 needed are unavoidably matched by \fItagregexp\fP, it may be useful to
add a \fInameregexp\fP, to narrow down the tag scope. \fBctags\fP add a \fInameregexp\fP, to narrow down the tag scope. \fBctags\fP
ignores regexps without a \fInameregexp\fP. The syntax of regexps is 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: The following character escape sequences are supported:
\\a, \\b, \\d, \\e, \\f, \\n, \\r, \\t, \\v, which respectively \\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. stand for the ASCII characters BEL, BS, DEL, ESC, FF, NL, CR, TAB, VT.