Mercurial > emacs
comparison etc/etags.1 @ 26339:91bc9f283495
Added wording for the regex files and the --ignore-case-regex option.
author | Francesco Potortì <pot@gnu.org> |
---|---|
date | Wed, 03 Nov 1999 23:10:47 +0000 |
parents | 81cd0c225dd9 |
children | 446514f572dd |
comparison
equal
deleted
inserted
replaced
26338:5a357bdec3e3 | 26339:91bc9f283495 |
---|---|
19 [\|\-\-append\|] [\|\-\-c++\|] [\|\-\-no\-defines\|] | 19 [\|\-\-append\|] [\|\-\-c++\|] [\|\-\-no\-defines\|] |
20 [\|\-\-no\-globals\|] [\|\-\-include=\fIfile\fP\|] | 20 [\|\-\-no\-globals\|] [\|\-\-include=\fIfile\fP\|] |
21 [\|\-\-ignore\-indentation\|] [\|\-\-language=\fIlanguage\fP\|] | 21 [\|\-\-ignore\-indentation\|] [\|\-\-language=\fIlanguage\fP\|] |
22 [\|\-\-members\|] [\|\-\-output=\fItagfile\fP\|] | 22 [\|\-\-members\|] [\|\-\-output=\fItagfile\fP\|] |
23 [\|\-\-regex=\fIregexp\fP\|] [\|\-\-no\-regex\|] | 23 [\|\-\-regex=\fIregexp\fP\|] [\|\-\-no\-regex\|] |
24 [\|\-\-ignore\-case\-regex=\fIregexp\fP\|] | |
24 [\|\-\-help\|] [\|\-\-version\|] | 25 [\|\-\-help\|] [\|\-\-version\|] |
25 \fIfile\fP .\|.\|. | 26 \fIfile\fP .\|.\|. |
26 | 27 |
27 .B ctags [\|\-aCdgImRVh\|] [\|\-BtTuvwx\|] [\|\-l \fIlanguage\fP\|] | 28 .B ctags [\|\-aCdgImRVh\|] [\|\-BtTuvwx\|] [\|\-l \fIlanguage\fP\|] |
28 .if n .br | 29 .if n .br |
31 [\|\-\-append\|] [\|\-\-backward\-search\|] [\|\-\-c++\|] | 32 [\|\-\-append\|] [\|\-\-backward\-search\|] [\|\-\-c++\|] |
32 [\|\-\-cxref\|] [\|\-\-defines\|] [\|\-\-forward\-search\|] | 33 [\|\-\-cxref\|] [\|\-\-defines\|] [\|\-\-forward\-search\|] |
33 [\|\-\-globals\|] [\|\-\-ignore\-indentation\|] | 34 [\|\-\-globals\|] [\|\-\-ignore\-indentation\|] |
34 [\|\-\-language=\fIlanguage\fP\|] [\|\-\-members\|] | 35 [\|\-\-language=\fIlanguage\fP\|] [\|\-\-members\|] |
35 [\|\-\-output=\fItagfile\fP\|] [\|\-\-regex=\fIregexp\fP\|] | 36 [\|\-\-output=\fItagfile\fP\|] [\|\-\-regex=\fIregexp\fP\|] |
37 [\|\-\-ignore\-case\-regex=\fIregexp\fP\|] | |
36 [\|\-\-typedefs\|] [\|\-\-typedefs\-and\-c++\|] | 38 [\|\-\-typedefs\|] [\|\-\-typedefs\-and\-c++\|] |
37 [\|\-\-update\|] [\|\-\-no\-warn\|] | 39 [\|\-\-update\|] [\|\-\-no\-warn\|] |
38 [\|\-\-help\|] [\|\-\-version\|] | 40 [\|\-\-help\|] [\|\-\-version\|] |
39 \fIfile\fP .\|.\|. | 41 \fIfile\fP .\|.\|. |
40 .ad b | 42 .ad b |
140 \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP | 142 \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP |
141 Explicit name of file for tag table; overrides default `\|TAGS\|' or | 143 Explicit name of file for tag table; overrides default `\|TAGS\|' or |
142 `\|tags\|'. (But ignored with \fB\-v\fP or \fB\-x\fP.) | 144 `\|tags\|'. (But ignored with \fB\-v\fP or \fB\-x\fP.) |
143 .TP | 145 .TP |
144 \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP | 146 \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP |
145 Make tags based on regexp matching for each line of the files | 147 \fB\-\-ignore\-case\-regex=\fIregexp\fP\ |
146 following this option, in addition to the tags made with the standard | 148 Make tags based on regexp matching for each line of the files following |
147 parsing based on language. May be freely intermixed with filenames | 149 this option, in addition to the tags made with the standard parsing based |
148 and the \fB\-R\fP option. The regexps are cumulative, i.e. each | 150 on language. When using \-\-regex, case is significant, while it is not |
149 option will add to the previous ones. The regexps are of the form: | 151 with \-\-ignore\-case\-regex. May be freely intermixed with filenames and |
150 .br | 152 the \fB\-R\fP option. The regexps are cumulative, i.e. each option will |
151 | 153 add to the previous ones. The regexps are of the form: |
152 \fB/\fP\fItagregexp\fP[\fB/\fP\fInameregexp\fP]\fB/\fP | 154 .br |
155 \fB/\fP\fItagregexp\fP[\fB/\fP\fInameregexp\fP]\fB/\fP | |
153 .br | 156 .br |
154 | 157 |
155 where \fItagregexp\fP is used to match the lines that must be tagged. | 158 where \fItagregexp\fP is used to match the lines that must be tagged. |
156 It should not match useless characters. If the match is | 159 It should not match useless characters. If the match is |
157 such that more characters than needed are unavoidably matched by | 160 such that more characters than needed are unavoidably matched by |
180 | 183 |
181 Tag TCL files (this last example shows the usage of a \fItagregexp\fP): | 184 Tag TCL files (this last example shows the usage of a \fItagregexp\fP): |
182 .br | 185 .br |
183 \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP | 186 \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP |
184 | 187 |
188 .br | |
189 A regexp can be preceded by {lang}, thus restriciting it to match lines of | |
190 files of the specified language. Use \fBetags --help\bP to obtain a list | |
191 of the recognised languages. This feature is particularly useful inside | |
192 \fBregex files\fB. A regex file contains one regex per line. Empty lines, | |
193 and those lines beginning with space or tab are ignored. Lines beginning | |
194 with @ are references to regex files whose name follows the @ sign. Other | |
195 lines are considered regular expressions like those following \-\-regex. | |
196 .br | |
197 For example, the command | |
198 .br | |
199 etags \-\-regex=@regex.file *.c | |
200 .br | |
201 reads the regexes contained in the file regex.file. | |
185 .TP | 202 .TP |
186 .B \-R, \-\-no\-regex | 203 .B \-R, \-\-no\-regex |
187 Don't do any more regexp matching on the following files. May be | 204 Don't do any more regexp matching on the following files. May be |
188 freely intermixed with filenames and the \fB\-\-regex\fP option. | 205 freely intermixed with filenames and the \fB\-\-regex\fP option. |
189 .TP | 206 .TP |