Mercurial > emacs
annotate lib-src/etags.1 @ 35528:4ca44cbfa530
(sturct ccl_program): New member suppress_error.
author | Kenichi Handa <handa@m17n.org> |
---|---|
date | Wed, 24 Jan 2001 23:29:42 +0000 |
parents | e34fbc66493b |
children | 2ce207b252dc |
rev | line source |
---|---|
25859 | 1 .\" Copyright (c) 1992 Free Software Foundation |
2 .\" See section COPYING for conditions for redistribution | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
3 .TH etags 1 "14gen2001" "GNU Tools" "GNU Tools" |
25859 | 4 .de BP |
5 .sp | |
6 .ti -.2i | |
7 \(** | |
8 .. | |
9 | |
10 .SH NAME | |
11 etags, ctags \- generate tag file for Emacs, vi | |
12 .SH SYNOPSIS | |
13 .hy 0 | |
14 .na | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
15 .B etags [\|\-aCDGImRVh\|] [\|\-i \fIfile\fP\|] [\|\-l \fIlanguage\fP\|] |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
16 .if n .br |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
17 .B [\|\-o \fItagfile\fP\|] [\|\-r \fIregexp\fP\|] |
25859 | 18 .br |
35304
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
19 .B [\|\-\-append\|] [\|\-\-c++\|] [\|\-\-no\-defines\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
20 .B [\|\-\-no\-globals\|] [\|\-\-include=\fIfile\fP\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
21 .B [\|\-\-ignore\-indentation\|] [\|\-\-language=\fIlanguage\fP\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
22 .B [\|\-\-members\|] [\|\-\-output=\fItagfile\fP\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
23 .B [\|\-\-regex=\fIregexp\fP\|] [\|\-\-no\-regex\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
24 .B [\|\-\-ignore\-case\-regex=\fIregexp\fP\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
25 .B [\|\-\-help\|] [\|\-\-version\|] |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
26 \fIfile\fP .\|.\|. |
25859 | 27 |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
28 .B ctags [\|\-aCdgImRVh\|] [\|\-BtTuvwx\|] [\|\-l \fIlanguage\fP\|] |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
29 .if n .br |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
30 .B [\|\-o \fItagfile\fP\|] [\|\-r \fIregexp\fP\|] |
25859 | 31 .br |
35304
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
32 .B [\|\-\-append\|] [\|\-\-backward\-search\|] [\|\-\-c++\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
33 .B [\|\-\-cxref\|] [\|\-\-defines\|] [\|\-\-forward\-search\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
34 .B [\|\-\-globals\|] [\|\-\-ignore\-indentation\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
35 .B [\|\-\-language=\fIlanguage\fP\|] [\|\-\-members\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
36 .B [\|\-\-output=\fItagfile\fP\|] [\|\-\-regex=\fIregexp\fP\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
37 .B [\|\-\-ignore\-case\-regex=\fIregexp\fP\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
38 .B [\|\-\-typedefs\|] [\|\-\-typedefs\-and\-c++\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
39 .B [\|\-\-update\|] [\|\-\-no\-warn\|] |
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
40 .B [\|\-\-help\|] [\|\-\-version\|] |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
41 \fIfile\fP .\|.\|. |
25859 | 42 .ad b |
43 .hy 1 | |
44 .SH DESCRIPTION | |
45 The `\|\fBetags\fP\|' program is used to create a tag table file, in a format | |
46 understood by | |
47 .BR emacs ( 1 )\c | |
48 \&; the `\|\fBctags\fP\|' program is used to create a similar table in a | |
49 format understood by | |
50 .BR vi ( 1 )\c | |
35303
a1775d96a961
*** empty log message ***
Francesco Potortì <pot@gnu.org>
parents:
35297
diff
changeset
|
51 \&. Both forms of the program understand the syntax of C, Objective C, |
a1775d96a961
*** empty log message ***
Francesco Potortì <pot@gnu.org>
parents:
35297
diff
changeset
|
52 C++, Java, Fortran, Ada, Cobol, Erlang, LaTeX, Emacs Lisp/Common Lisp, |
a1775d96a961
*** empty log message ***
Francesco Potortì <pot@gnu.org>
parents:
35297
diff
changeset
|
53 makefiles, Pascal, Perl, Postscript, Python, Prolog, Scheme and most |
a1775d96a961
*** empty log message ***
Francesco Potortì <pot@gnu.org>
parents:
35297
diff
changeset
|
54 assembler\-like syntaxes. |
25859 | 55 Both forms read the files specified on the command line, and write a tag |
56 table (defaults: `\|TAGS\|' for \fBetags\fP, `\|tags\|' for | |
57 \fBctags\fP) in the current working directory. | |
58 Files specified with relative file names will be recorded in the tag | |
59 table with file names relative to the directory where the tag table | |
60 resides. Files specified with absolute file names will be recorded | |
61 with absolute file names. | |
62 The programs recognize the language used in an input file based on its | |
63 file name and contents. The --language switch can be used to force | |
64 parsing of the file names following the switch according to the given | |
65 language, overriding guesses based on filename extensions. | |
66 .SH OPTIONS | |
67 Some options make sense only for the \fBvi\fP style tag files produced | |
68 by ctags; | |
69 \fBetags\fP does not recognize them. | |
70 The programs accept unambiguous abbreviations for long option names. | |
71 .TP | |
72 .B \-a, \-\-append | |
73 Append to existing tag file. (For vi-format tag files, see also | |
74 \fB\-\-update\fP.) | |
75 .TP | |
76 .B \-B, \-\-backward\-search | |
77 Tag files written in the format expected by \fBvi\fP contain regular | |
78 expression search instructions; the \fB\-B\fP option writes them using | |
79 the delimiter `\|\fB?\fP\|', to search \fIbackwards\fP through files. | |
80 The default is to use the delimiter `\|\fB/\fP\|', to search \fIforwards\fP | |
81 through files. | |
82 Only \fBctags\fP accepts this option. | |
83 .TP | |
84 .B \-C, \-\-c++ | |
85 Treat files with `\|.c\|' and `\|.h\|' extensions as C++ code, not C | |
86 code. Files with `\|.C\|', `\|.H\|', `\|.cxx\|', `\|.hxx\|', or | |
87 `\|.cc\|' extensions are always assumed to be C++ code. | |
88 .TP | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
89 .B \-\-declarations |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
90 In C and derived languages, create tags for function declarations, |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
91 and create tags for extern variables unless \-\-no\-globals is used. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
92 .TP |
25859 | 93 .B \-d, \-\-defines |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
94 Create tag entries for C preprocessor constant definitions |
25859 | 95 and enum constants, too. This is the |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
96 default behavior for \fBetags\fP. |
25859 | 97 .TP |
98 .B \-D, \-\-no\-defines | |
99 Do not create tag entries for C preprocessor constant definitions | |
100 and enum constants. | |
101 This may make the tags file much smaller if many header files are tagged. | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
102 This is the default behavior for \fBctags\fP. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
103 .TP |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
104 .B \-g, \-\-globals |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
105 Create tag entries for global variables in C, C++, Objective C, Java, |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
106 and Perl. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
107 This is the default behavior for \fBetags\fP. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
108 .TP |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
109 .B \-G, \-\-no\-globals |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
110 Do not tag global variables. Typically this reduces the file size by |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
111 one fourth. This is the default behavior for \fBctags\fP. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
112 .TP |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
113 \fB\-i\fP \fIfile\fP, \fB\-\-include=\fIfile\fP |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
114 Include a note in the tag file indicating that, when searching for a |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
115 tag, one should also consult the tags file \fIfile\fP after checking the |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
116 current file. This options is only accepted by \fBetags\fP. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
117 .TP |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
118 .B \-I, \-\-ignore\-indentation |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
119 Don't rely on indentation as much as we normally do. Currently, this |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
120 means not to assume that a closing brace in the first column is the |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
121 final brace of a function or structure definition in C and C++. |
25859 | 122 .TP |
123 \fB\-l\fP \fIlanguage\fP, \fB\-\-language=\fIlanguage\fP | |
124 Parse the following files according to the given language. More than | |
125 one such options may be intermixed with filenames. Use \fB\-\-help\fP | |
126 to get a list of the available languages and their default filename | |
127 extensions. The `auto' language can be used to restore automatic | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
128 detection of language based on the file name. The `none' |
25859 | 129 language may be used to disable language parsing altogether; only |
130 regexp matching is done in this case (see the \fB\-\-regex\fP option). | |
131 .TP | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
132 .B \-m, \-\-members |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
133 Create tag entries for variables that are members of structure-like |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
134 constructs in C++, Objective C, Java. |
25859 | 135 .TP |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
136 .B \-M, \-\-no\-members |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
137 Do not tag member variables. This is the default behavior. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
138 .TP |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
139 .B \-\-packages\-only |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
140 Only tag packages in Ada files. |
25859 | 141 .TP |
142 \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP | |
143 Explicit name of file for tag table; overrides default `\|TAGS\|' or | |
144 `\|tags\|'. (But ignored with \fB\-v\fP or \fB\-x\fP.) | |
145 .TP | |
35304
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
146 \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP, \fB\-\-ignore\-case\-regex=\fIregexp\fP |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
147 Make tags based on regexp matching for each line of the files following |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
148 this option, in addition to the tags made with the standard parsing based |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
149 on language. When using \-\-regex, case is significant, while it is not |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
150 with \-\-ignore\-case\-regex. May be freely intermixed with filenames and |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
151 the \fB\-R\fP option. The regexps are cumulative, i.e. each option will |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
152 add to the previous ones. The regexps are of the form: |
25859 | 153 .br |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
154 \fB/\fP\fItagregexp\fP[\fB/\fP\fInameregexp\fP]\fB/\fP |
25859 | 155 .br |
156 | |
157 where \fItagregexp\fP is used to match the lines that must be tagged. | |
158 It should not match useless characters. If the match is | |
159 such that more characters than needed are unavoidably matched by | |
160 \fItagregexp\fP, it may be useful to add a \fInameregexp\fP, to | |
161 narrow down the tag scope. \fBctags\fP ignores regexps without a | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
162 \fInameregexp\fP. The syntax of regexps is the same as in emacs, |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
163 augmented with intervals of the form \\{m,n\\}, as in ed or grep. |
25859 | 164 .br |
165 Here are some examples. All the regexps are quoted to protect them | |
166 from shell interpretation. | |
167 .br | |
168 | |
169 Tag the DEFVAR macros in the emacs source files: | |
170 .br | |
171 \fI\-\-regex\='/[ \\t]*DEFVAR_[A-Z_ \\t(]+"\\([^"]+\\)"\/'\fP | |
172 .br | |
173 | |
174 Tag VHDL files (this example is a single long line, broken here for | |
175 formatting reasons): | |
176 .br | |
177 \fI\-\-language\=none\ \-\-regex='/[\ \\t]*\\(ARCHITECTURE\\|\\ | |
178 CONFIGURATION\\)\ +[^\ ]*\ +OF/'\ \-\-regex\='/[\ \\t]*\\ | |
179 \\(ATTRIBUTE\\|ENTITY\\|FUNCTION\\|PACKAGE\\(\ BODY\\)?\\ | |
180 \\|PROCEDURE\\|PROCESS\\|TYPE\\)[\ \\t]+\\([^\ \\t(]+\\)/\\3/'\fP | |
181 .br | |
182 | |
183 Tag TCL files (this last example shows the usage of a \fItagregexp\fP): | |
184 .br | |
185 \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP | |
186 | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
187 .br |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
188 A regexp can be preceded by {lang}, thus restriciting it to match lines of |
35304
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
189 files of the specified language. Use \fBetags --help\fP to obtain a list |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
190 of the recognised languages. This feature is particularly useful inside |
35304
e34fbc66493b
2000-05-31 Karl M. Hegbloom <karlheg@debian.org>
Francesco Potortì <pot@gnu.org>
parents:
35303
diff
changeset
|
191 \fBregex files\fP. A regex file contains one regex per line. Empty lines, |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
192 and those lines beginning with space or tab are ignored. Lines beginning |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
193 with @ are references to regex files whose name follows the @ sign. Other |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
194 lines are considered regular expressions like those following \-\-regex. |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
195 .br |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
196 For example, the command |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
197 .br |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
198 etags \-\-regex=@regex.file *.c |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
199 .br |
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
200 reads the regexes contained in the file regex.file. |
25859 | 201 .TP |
202 .B \-R, \-\-no\-regex | |
203 Don't do any more regexp matching on the following files. May be | |
204 freely intermixed with filenames and the \fB\-\-regex\fP option. | |
205 .TP | |
206 .B \-t, \-\-typedefs | |
207 Record typedefs in C code as tags. Since this is the default behaviour | |
208 of \fBetags\fP, only \fBctags\fP accepts this option. | |
209 .TP | |
210 .B \-T, \-\-typedefs\-and\-c++ | |
211 Generate tag entries for typedefs, struct, enum, and union tags, and | |
212 C++ member functions. Since this is the default behaviour | |
213 of \fBetags\fP, only \fBctags\fP accepts this option. | |
214 .TP | |
215 .B \-u, \-\-update | |
216 Update tag entries for \fIfiles\fP specified on command line, leaving | |
217 tag entries for other files in place. Currently, this is implemented | |
218 by deleting the existing entries for the given files and then | |
219 rewriting the new entries at the end of the tags file. It is often | |
220 faster to simply rebuild the entire tag file than to use this. | |
221 Only \fBctags\fP accepts this option. | |
222 .TP | |
223 .B \-v, \-\-vgrind | |
224 Instead of generating a tag file, write index (in \fBvgrind\fP format) | |
225 to standard output. Only \fBctags\fP accepts this option. | |
226 .TP | |
227 .B \-w, \-\-no\-warn | |
228 Suppress warning messages about duplicate entries. The \fBetags\fP | |
229 program does not check for duplicate entries, so this option is not | |
230 allowed with it. | |
231 .TP | |
232 .B \-x, \-\-cxref | |
233 Instead of generating a tag file, write a cross reference (in | |
234 \fBcxref\fP format) to standard output. Only \fBctags\fP accepts this option. | |
235 .TP | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
236 .B \-h, \-H, \-\-help |
25859 | 237 Print usage information. |
238 .TP | |
239 .B \-V, \-\-version | |
240 Print the current version of the program (same as the version of the | |
241 emacs \fBetags\fP is shipped with). | |
242 | |
243 .SH "SEE ALSO" | |
244 `\|\fBemacs\fP\|' entry in \fBinfo\fP; \fIGNU Emacs Manual\fP, Richard | |
245 Stallman. | |
246 .br | |
247 .BR cxref ( 1 ), | |
248 .BR emacs ( 1 ), | |
249 .BR vgrind ( 1 ), | |
250 .BR vi ( 1 ). | |
251 | |
252 .SH COPYING | |
35297
e268b7b500f0
Changes for makefile support in etags.
Francesco Potortì <pot@gnu.org>
parents:
25859
diff
changeset
|
253 Copyright (c) 1999 Free Software Foundation, Inc. |
25859 | 254 .PP |
255 Permission is granted to make and distribute verbatim copies of | |
256 this manual provided the copyright notice and this permission notice | |
257 are preserved on all copies. | |
258 .PP | |
259 Permission is granted to copy and distribute modified versions of this | |
260 manual under the conditions for verbatim copying, provided that the | |
261 entire resulting derived work is distributed under the terms of a | |
262 permission notice identical to this one. | |
263 .PP | |
264 Permission is granted to copy and distribute translations of this | |
265 manual into another language, under the above conditions for modified | |
266 versions, except that this permission notice may be included in | |
267 translations approved by the Free Software Foundation instead of in | |
268 the original English. |