1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
|
$NetBSD: patch-ab,v 1.6 2003/04/07 09:30:43 seb Exp $
--- ctags.1.orig 2003-04-01 05:02:33.000000000 +0000
+++ ctags.1
@@ -1,27 +1,27 @@
-.TH CTAGS 1 "Version 5.5" "Darren Hiebert"
+.TH EXCTAGS 1 "Version 5.5" "Darren Hiebert"
.SH "NAME"
-ctags \- Generate tag files for source code
+exctags \- Generate tag files for source code
.SH SYNOPSIS
.TP 6
-\fBctags\fP [\fBoptions\fP] [\fIfile(s)\fP]
+\fBexctags\fP [\fBoptions\fP] [\fIfile(s)\fP]
.TP 6
-\fBetags\fP [\fBoptions\fP] [\fIfile(s)\fP]
+\fBexetags\fP [\fBoptions\fP] [\fIfile(s)\fP]
.SH "DESCRIPTION"
-The \fBctags\fP and \fBetags\fP programs (hereinafter collectively referred to
-as \fBctags\fP, except where distinguished) generate an index (or "tag") file
+The \fBexctags\fP and \fBexetags\fP programs (hereinafter collectively referred to
+as \fBexctags\fP, except where distinguished) generate an index (or "tag") file
for a variety of language objects found in \fIfile(s)\fP.
This tag file allows these items to be quickly and easily located by a text
editor or other utility. A "tag" signifies a language object for which an
index entry is available (or, alternatively, the index entry created for that
object).
-Alternatively, \fBctags\fP can generate a cross reference file which lists, in
+Alternatively, \fBexctags\fP can generate a cross reference file which lists, in
human readable form, information about the various source objects found in a
set of language files.
@@ -62,8 +62,8 @@ to a language and the file is executable
checked to see if the file is a "#!" script for a recognized language.
By default, all other files names are ignored. This permits running
-\fBctags\fP on all files in either a single directory (e.g. "ctags *"), or on
-all files in an entire source directory tree (e.g. "ctags -R"), since only
+\fBexctags\fP on all files in either a single directory (e.g. "exctags *"), or on
+all files in an entire source directory tree (e.g. "exctags -R"), since only
those files whose names are mapped to languages will be scanned.
[The reason that .h extensions are mapped to C++ files rather than C files
@@ -73,8 +73,8 @@ treating them as C++ files.]
.SH "OPTIONS"
-Despite the wealth of available options, defaults are set so that \fBctags\fP
-is most commonly executed without any options (e.g. "ctags *", or "ctags -R"),
+Despite the wealth of available options, defaults are set so that \fBexctags\fP
+is most commonly executed without any options (e.g. "exctags *", or "exctags -R"),
which will create a tag file in the current directory for all recognized
source files. The options described below are provided merely to allow custom
tailoring to meet special needs.
@@ -111,7 +111,7 @@ Use backward searching patterns (e.g. ?p
.TP 5
.B \-e
Enable etags mode, which will create a tag file for use with the Emacs editor.
-Alternatively, if \fBctags\fP is invoked by a name containing the string
+Alternatively, if \fBexctags\fP is invoked by a name containing the string
"etags" (either by renaming, or creating a link to, the executable), etags
mode will be enabled. This option must appear before the first file name.
@@ -122,7 +122,7 @@ or "TAGS" when running in etags mode). I
"-", then the tag file is written to standard output instead. \fBCtags\fP
will stubbornly refuse to take orders if \fItagfile\fP exists and its first
line contains something other than a valid tags line. This will save your neck
-if you mistakenly type "ctags -f *.c", which would otherwise overwrite your
+if you mistakenly type "exctags -f *.c", which would otherwise overwrite your
first C file with the tags generated by the rest! It will also refuse to
accept a multi character file name which begins with a '-' (dash) character,
since this most likely means that you left out the tag file name and this
@@ -163,7 +163,7 @@ Specifies a list of tokens which are to
and C++ source files. This option is specifically provided to handle special
cases arising through the use of preprocessor macros. When the tokens listed
are simple tokens, these tokens will be ignored during parsing of the source
-files. If a token is suffixed with a '+' character, \fBctags\fP will also
+files. If a token is suffixed with a '+' character, \fBexctags\fP will also
ignore any parenthesis-enclosed argument list which may immediately follow the
token in the source files. If two tokens are separated with the '=' character,
the first token is replaced by the second token for parsing purposes. The list
@@ -273,9 +273,9 @@ includes: the tag name; the kind of tag;
source line (with extra white space condensed) of the file which defines the
tag. No tag file is written and all options affecting tag file output will be
ignored. Example applications for this feature are generating a listing of all
-functions located in a source file (e.g. \fBctags -x --c-kinds\fP=\fIf\fP
+functions located in a source file (e.g. \fBexctags -x --c-kinds\fP=\fIf\fP
\fIfile\fP), or generating a list of all externally visible global variables
-located in a source file (e.g. \fBctags -x --c-kinds\fP=\fIv\fP
+located in a source file (e.g. \fBexctags -x --c-kinds\fP=\fIv\fP
\fB--file-scope\fP=\fIno file\fP). This option must appear before the first
file name.
@@ -295,14 +295,14 @@ tag file which "includes" other tag file
\fB--exclude\fP=[\fIpattern\fP]
Add \fIpattern\fP to a list of excluded files and directories. This option
may be specified as many times as desired. For each file name considered by
-\fBctags\fP, each \fIpattern\fP specified using this option will be compared
+\fBexctags\fP, each \fIpattern\fP specified using this option will be compared
against both the complete path (e.g. some/path/base.ext) and the base name
(e.g. base.ext) of the file, thus allowing patterns which match a given file
name irrespective of its path, or match only a specific path. If appropriate
support is available from the runtime library of your C compiler, then
\fIpattern\fP may contain the usual shell wildcards (not regular expressions)
common on Unix (be sure to quote the option parameter to protect the wildcards
-from being expanded by the shell before being passed to \fBctags\fP; also be
+from being expanded by the shell before being passed to \fBexctags\fP; also be
aware that wildcards can match the slash character, '/'). You can determine if
shell wildcards are available on your platform by examining the output of the
\fB--version\fP option, which will include "+wildcards" in the compiled
@@ -471,7 +471,7 @@ is enabled by default.
.TP 5
\fB--filter\fP[=\fIyes\fP|\fIno\fP]
-Causes \fBctags\fP to behave as a filter, reading source file names from
+Causes \fBexctags\fP to behave as a filter, reading source file names from
standard input and printing their tags to standard output on a file-by-file
basis. If \fB--sorted\fP is enabled, tags are sorted only within the source
file in which they are defined. File names are read from standard output in
@@ -485,7 +485,7 @@ by default. This option must appear befo
\fB--filter-terminator\fP=\fIstring\fP
Specifies a string to print to standard output following the tags for each
file name parsed when the \fB--filter\fP option is enabled. This may permit an
-application reading the output of ctags to determine when the output for each
+application reading the output of exctags to determine when the output for each
file is finished. Note that if the file name read is a directory and
\fB--recurse\fP is enabled, this string will be printed only one once at the
end of all tags found for by descending the directory. This string will always
@@ -557,7 +557,7 @@ enclosing the pattern in parentheses (e.
support is available from the runtime library of your C compiler, then the
file name pattern may contain the usual shell wildcards common on Unix (be
sure to quote the option parameter to protect the wildcards from being
-expanded by the shell before being passed to \fBctags\fP). You can determine
+expanded by the shell before being passed to \fBexctags\fP). You can determine
if shell wildcards are available on your platform by examining the output of
the \fB--version\fP option, which will include "+wildcards" in the compiled
feature list; otherwise, the file name patterns are matched against file names
@@ -584,7 +584,7 @@ file name patterns when inferring the la
.TP 5
\fB--language-force\fP=\fIlanguage\fP
-By default, \fBctags\fP automatically selects the language of a source file,
+By default, \fBexctags\fP automatically selects the language of a source file,
ignoring those files whose language cannot be determined (see
\fBSOURCE FILES\fP, above). This option forces the specified \fIlanguage\fP
(case-insensitive; either built-in or user-defined) to be used for every
@@ -622,7 +622,7 @@ Prints a summary of the software license
Specifies whether "#line" directives should be recognized. These are present
in the output of preprocessors and contain the line number, and possibly the
file name, of the original source file(s) from which the preprocessor output
-file was generated. When enabled, this option will cause \fBctags\fP to
+file was generated. When enabled, this option will cause \fBexctags\fP to
generate tag entries marked with the file names and line numbers of their
locations original source file(s), instead of their actual locations in the
preprocessor output. The actual file names placed into the tag file will have
@@ -633,7 +633,7 @@ absolute path). This option is off by de
generally only useful when used together with the \fB--excmd\fP=\fInumber\fP
(\fB-n\fP) option. Also, you may have to use either the \fB--langmap\fP or
\fB--language-force\fP option if the extension of the preprocessor output file
-is not known to \fBctags\fP.
+is not known to \fBexctags\fP.
.TP 5
\fB--links\fP[=\fIyes\fP|\fIno\fP]
@@ -647,7 +647,7 @@ languages. Each kind of tag recorded in
one-letter flag, which is also used to filter the tags placed into the output
through use of the \fB--<LANG>-kind\fP option. Note that some languages and/or
tag kinds may be implemented using regular expressions and may not be
-available if regex support is not compiled into \fBctags\fP (see the
+available if regex support is not compiled into \fBexctags\fP (see the
\fB--regex-<LANG>\fP option). Each kind listed is enabled unless followed by
"[off]".
@@ -659,7 +659,7 @@ the \fB--langmap\fP option, and \fBSOURC
.TP 5
\fB--list-languages\fP
-Lists the names of the languages understood by \fBctags\fP. These language
+Lists the names of the languages understood by \fBexctags\fP. These language
names are case insensitive and may be used in the \fB--language-force\fP,
\fB--languages\fP, \fB--<LANG>-kinds\fP, and \fB--regex-<LANG>\fP options.
@@ -676,7 +676,7 @@ Recurse into directories encountered in
list of supplied files is empty and no file list is specified with the
\fB-L\fP option, then the current directory (i.e. ".") is assumed. Symbolic
links are followed. If you don't like these behaviors, either explicitly
-specify the files or pipe the output of \fBfind\fP(1) into \fBctags -L-\fP
+specify the files or pipe the output of \fBfind\fP(1) into \fBexctags -L-\fP
instead. \fBNote:\fP This option is not supported on all platforms at present.
It is available if the output of the \fB--help\fP option includes this option.
See, also, the \fB--exclude\fP to limit recursion.
@@ -729,13 +729,13 @@ The regular expression is to be applied
.RE
.RS 5
-Note that this option is available only if \fBctags\fP was compiled with
+Note that this option is available only if \fBexctags\fP was compiled with
support for regular expressions, which depends upon your platform. You can
determine if support for regular expressions is compiled in by examining the
output of the \fB--version\fP option, which will include "+regex" in the
compiled feature list.
-For more information on the regular expressions used by \fBctags\fP, see
+For more information on the regular expressions used by \fBexctags\fP, see
either the \fBregex(5,7)\fP man page, or the GNU info documentation for regex
(e.g. "info regex").
.RE
@@ -746,7 +746,7 @@ Indicates whether the tag file should be
\fIyes\fP). Note that the original \fBvi\fP(1) required sorted tags.
The \fIfoldcase\fP value specifies case insensitive (or case-folded) sorting.
Fast binary searches of tag files sorted with case-folding will require
-special support from tools using tag files, such as that found in the ctags
+special support from tools using tag files, such as that found in the exctags
readtags library, or Vim version 6.2 or higher (using "set ignorecase"). This
option must appear before the first file name. [Ignored in etags mode]
@@ -762,14 +762,14 @@ option), \fIno\fP otherwise.
.TP 5
\fB--totals\fP[=\fIyes\fP|\fIno\fP]
Prints statistics about the source files read and the tag file written during
-the current invocation of \fBctags\fP. This option is off by default.
+the current invocation of \fBexctags\fP. This option is off by default.
This option must appear before the first file name.
.TP 5
\fB--verbose\fP[=\fIyes\fP|\fIno\fP]
Enable verbose mode. This prints out information on option processing and a
brief message describing what action is being taken for each file considered
-by \fBctags\fP. Normally, \fBctags\fP does not read command line arguments
+by \fBexctags\fP. Normally, \fBexctags\fP does not read command line arguments
until after options are read from the configuration files (see \fBFILES\fP,
below) and the \fBCTAGS\fP environment variable. However, if this option is
the first argument on the command line, it will take effect before any options
@@ -777,13 +777,13 @@ are read from these sources. The default
.TP 5
\fB--version\fP
-Prints a version identifier for \fBctags\fP to standard output. This is
+Prints a version identifier for \fBexctags\fP to standard output. This is
guaranteed to always contain the string "Exuberant Ctags".
.SH "OPERATIONAL DETAILS"
-As \fBctags\fP considers each file name in turn, it tries to determine the
+As \fBexctags\fP considers each file name in turn, it tries to determine the
language of the file by applying the following three tests in order: if the
file extension has been mapped to a language, if the file name matches a shell
pattern mapped to a language, and finally if the file is executable and its
@@ -799,9 +799,9 @@ code as do legacy implementations. Older
rely upon certain formatting assumptions in order to help it resolve coding
dilemmas caused by preprocessor conditionals.
-In general, \fBctags\fP tries to be smart about conditional preprocessor
+In general, \fBexctags\fP tries to be smart about conditional preprocessor
directives. If a preprocessor conditional is encountered within a statement
-which defines a tag, \fBctags\fP follows only the first branch of that
+which defines a tag, \fBexctags\fP follows only the first branch of that
conditional (except in the special case of "#if 0", in which case it follows
only the last branch). The reason for this is that failing to pursue only one
branch can result in ambiguous syntax, as in the following example:
@@ -824,12 +824,12 @@ long b;
}
.RE
-Both branches cannot be followed, or braces become unbalanced and \fBctags\fP
+Both branches cannot be followed, or braces become unbalanced and \fBexctags\fP
would be unable to make sense of the syntax.
If the application of this heuristic fails to properly parse a file,
generally due to complicated and inconsistent pairing within the conditionals,
-\fBctags\fP will retry the file using a different heuristic which does not
+\fBexctags\fP will retry the file using a different heuristic which does not
selectively follow conditional preprocessor branches, but instead falls back
to relying upon a closing brace ("}") in column 1 as indicating the end of a
block once any brace imbalance results from following a #if conditional branch.
@@ -1003,12 +1003,12 @@ to automatically load that tag file at s
.SH "CAVEATS"
-Because \fBctags\fP is neither a preprocessor nor a compiler, use of
-preprocessor macros can fool \fBctags\fP into either missing tags or
-improperly generating inappropriate tags. Although \fBctags\fP has been
+Because \fBexctags\fP is neither a preprocessor nor a compiler, use of
+preprocessor macros can fool \fBexctags\fP into either missing tags or
+improperly generating inappropriate tags. Although \fBexctags\fP has been
designed to handle certain common cases, this is the single biggest cause of
reported problems. In particular, the use of preprocessor constructs which
-alter the textual syntax of C can fool \fBctags\fP. You can work around many
+alter the textual syntax of C can fool \fBexctags\fP. You can work around many
such problems by using the \fB-I\fP option.
White space is treated as a separator for file names and options read from
@@ -1017,7 +1017,7 @@ using the \fB--filter\fP option). Theref
supply file names or other options containing embedded white space (spaces,
etc.) through these options.
-Note that when \fBctags\fP generates uses patterns for locating tags (see
+Note that when \fBexctags\fP generates uses patterns for locating tags (see
the \fB--excmd\fP option), it is entirely possible that the wrong line may be
found by your editor if there exists another source line which is identical to
the line containing the tag. The following example demonstrates this condition:
@@ -1049,7 +1049,7 @@ by use of the \fB--excmd\fP=\fIn\fP opti
\fBCtags\fP has more options than \fBls\fP(1).
When parsing a C++ member function definition (e.g. "className::function"),
-\fBctags\fP cannot determine whether the scope specifier is a class name or a
+\fBexctags\fP cannot determine whether the scope specifier is a class name or a
namespace specifier and always lists it as a class name in the scope portion
of the extension fields. Also, if a C++ function is defined outside of the
class declaration (the usual case), the access specification (i.e. public,
@@ -1066,7 +1066,7 @@ No qualified tags are generated for lang
.TP 8
.B CTAGS
If this environment variable exists, it will be expected to contain a set of
-default options which are read when \fBctags\fP starts, after the
+default options which are read when \fBexctags\fP starts, after the
configuration files listed in \fBFILES\fP, below, are read, but before any
command line options are read. Options appearing on the command line will
override options specified in this variable. Only options will be read from
@@ -1077,7 +1077,7 @@ embedded space. If this is a problem, us
.TP 8
.B ETAGS
Similar to the \fBCTAGS\fP variable above, this variable, if found, will be
-read when \fBetags\fP starts. If this variable is not found, \fBetags\fP will
+read when \fBexetags\fP starts. If this variable is not found, \fBexetags\fP will
try to use \fBCTAGS\fP instead.
.TP 8
@@ -1086,12 +1086,12 @@ On Unix-like hosts where mkstemp() is av
specifies the directory in which to place temporary files. This can be useful
if the size of a temporary file becomes too large to fit on the partition
holding the default temporary directory defined at compilation time.
-\fBctags\fP creates temporary files only if either (1) an emacs-style tag file
+\fBexctags\fP creates temporary files only if either (1) an emacs-style tag file
is being generated, (2) the tag file is being sent to standard output, or (3)
the program was compiled to use an internal sort algorithm to sort the tag
files instead of the the sort utility of the operating system. If the sort
utility of the operating system is being used, it will generally observe this
-variable also. Note that if \fBctags\fP is setuid, the value of TMPDIR will be
+variable also. Note that if \fBexctags\fP is setuid, the value of TMPDIR will be
ignored.
@@ -1108,10 +1108,10 @@ ignored.
.I .ctags (ctags.cnf on MSDOS, MSWindows)
.IP
If any of these configuration files exist, each will be expected to contain a
-set of default options which are read in the order listed when \fBctags\fP
+set of default options which are read in the order listed when \fBexctags\fP
starts, but before the \fBCTAGS\fP environment variable is read or any command
line options are read. This makes it possible to set up site-wide, personal
-or project-level defaults. It is possible to compile \fBctags\fP to read an
+or project-level defaults. It is possible to compile \fBexctags\fP to read an
additional configuration file before any of those shown above, which will be
indicated if the output produced by the \fB--version\fP option lists the
"custom-conf" feature. Options appearing in the \fBCTAGS\fP environment
@@ -1125,10 +1125,10 @@ lines to indicate separate command-line
.TP
.I tags
-The default tag file created by \fBctags\fP.
+The default tag file created by \fBexctags\fP.
.TP
.I TAGS
-The default tag file created by \fBetags\fP.
+The default tag file created by \fBexetags\fP.
.SH "SEE ALSO"
The official Exuberant Ctags web site at:
@@ -1138,7 +1138,7 @@ http://ctags.sourceforge.net
.RE
Also \fBex\fP(1), \fBvi\fP(1), \fBelvis\fP, or, better yet, \fBvim\fP, the
-official editor of \fBctags\fP. For more information on \fBvim\fP, see the VIM
+official editor of \fBexctags\fP. For more information on \fBvim\fP, see the VIM
Pages web site at:
.RS
@@ -1166,7 +1166,7 @@ to humanity."
.SH "CREDITS"
-This version of \fBctags\fP was originally derived from and inspired by the
+This version of \fBexctags\fP was originally derived from and inspired by the
ctags program by Steve Kirkendall <kirkenda@cs.pdx.edu> that comes with the
Elvis vi clone (though virtually none of the original code remains).
|