2006-12-28 23:06:40 +00:00
|
|
|
--- etags.1
|
|
|
|
+++ etags.1
|
|
|
|
@@ -9,7 +9,7 @@
|
|
|
|
..
|
|
|
|
|
|
|
|
.SH NAME
|
|
|
|
-etags, ctags \- generate tag file for Emacs, vi
|
|
|
|
+etags, gnuctags \- generate tag file for Emacs, vi
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.hy 0
|
|
|
|
.na
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -26,7 +26,7 @@ etags, ctags \- generate tag file for Em
|
2006-12-28 23:06:40 +00:00
|
|
|
[\|\-\-help\|] [\|\-\-version\|]
|
|
|
|
\fIfile\fP .\|.\|.
|
|
|
|
|
|
|
|
-\fBctags\fP [\|\-aCdgIRVh\|] [\|\-BtTuvwx\|] [\|\-l \fIlanguage\fP\|]
|
|
|
|
+\fBgnuctags\fP [\|\-aCdgIRVh\|] [\|\-BtTuvwx\|] [\|\-l \fIlanguage\fP\|]
|
|
|
|
.if n .br
|
|
|
|
[\|\-o \fItagfile\fP\|] [\|\-r \fIregexp\fP\|]
|
|
|
|
[\|\-\-parse\-stdin=\fIfile\fP\|]
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -46,7 +46,7 @@ etags, ctags \- generate tag file for Em
|
2006-12-28 23:06:40 +00:00
|
|
|
The \|\fBetags\fP\| program is used to create a tag table file, in a format
|
|
|
|
understood by
|
|
|
|
.BR emacs ( 1 )\c
|
|
|
|
-\&; the \|\fBctags\fP\| program is used to create a similar table in a
|
|
|
|
+\&; the \|\fBgnuctags\fP\| program is used to create a similar table in a
|
|
|
|
format understood by
|
|
|
|
.BR vi ( 1 )\c
|
|
|
|
\&. Both forms of the program understand
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -56,7 +56,7 @@ Python, Prolog, Scheme and
|
2006-12-28 23:06:40 +00:00
|
|
|
most assembler\-like syntaxes.
|
|
|
|
Both forms read the files specified on the command line, and write a tag
|
|
|
|
table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for
|
|
|
|
-\fBctags\fP) in the current working directory.
|
|
|
|
+\fBgnuctags\fP) in the current working directory.
|
|
|
|
Files specified with relative file names will be recorded in the tag
|
|
|
|
table with file names relative to the directory where the tag table
|
|
|
|
resides. If the tag table is in /dev, however, the file names are made
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -71,7 +71,7 @@ parsing of the file names following the
|
2006-12-28 23:06:40 +00:00
|
|
|
language, overriding guesses based on filename extensions.
|
|
|
|
.SH OPTIONS
|
|
|
|
Some options make sense only for the \fBvi\fP style tag files produced
|
|
|
|
-by ctags;
|
|
|
|
+by gnuctags;
|
|
|
|
\fBetags\fP does not recognize them.
|
|
|
|
The programs accept unambiguous abbreviations for long option names.
|
|
|
|
.TP
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -85,7 +85,7 @@ expression search instructions; the \fB\
|
2006-12-28 23:06:40 +00:00
|
|
|
the delimiter `\|\fB?\fP\|', to search \fIbackwards\fP through files.
|
|
|
|
The default is to use the delimiter `\|\fB/\fP\|', to search \fIforwards\fP
|
|
|
|
through files.
|
|
|
|
-Only \fBctags\fP accepts this option.
|
|
|
|
+Only \fBgnuctags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-\-declarations
|
|
|
|
In C and derived languages, create tags for function declarations,
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -94,24 +94,24 @@ and create tags for extern variables unl
|
2006-12-28 23:06:40 +00:00
|
|
|
.B \-d, \-\-defines
|
|
|
|
Create tag entries for C preprocessor constant definitions
|
|
|
|
and enum constants, too. Since this is the default behavior of
|
|
|
|
-\fBetags\fP, only \fBctags\fP accepts this option.
|
|
|
|
+\fBetags\fP, only \fBgnuctags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-D, \-\-no\-defines
|
|
|
|
Do not create tag entries for C preprocessor constant definitions
|
|
|
|
and enum constants.
|
|
|
|
This may make the tags file much smaller if many header files are tagged.
|
|
|
|
-Since this is the default behavior of \fBctags\fP, only \fBetags\fP
|
|
|
|
+Since this is the default behavior of \fBgnuctags\fP, only \fBetags\fP
|
|
|
|
accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-\-globals
|
|
|
|
Create tag entries for global variables in C, C++, Objective C, Java,
|
|
|
|
and Perl.
|
|
|
|
-Since this is the default behavior of \fBetags\fP, only \fBctags\fP
|
|
|
|
+Since this is the default behavior of \fBetags\fP, only \fBgnuctags\fP
|
|
|
|
accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-\-no\-globals
|
|
|
|
Do not tag global variables. Typically this reduces the file size by
|
|
|
|
-one fourth. Since this is the default behavior of \fBctags\fP, only
|
|
|
|
+one fourth. Since this is the default behavior of \fBgnuctags\fP, only
|
|
|
|
\fBetags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
\fB\-i\fP \fIfile\fP, \fB\-\-include=\fIfile\fP
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -168,7 +168,7 @@ the previous ones. The regexps are of o
|
2006-12-28 23:06:40 +00:00
|
|
|
where \fItagregexp\fP is used to match the tag. It should not match
|
|
|
|
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
|
|
|
|
+add a \fInameregexp\fP, to narrow down the tag scope. \fBgnuctags\fP
|
|
|
|
ignores regexps without a \fInameregexp\fP. The syntax of regexps is
|
|
|
|
the same as in emacs. The following character escape sequences are
|
|
|
|
supported: \\a, \\b, \\d, \\e, \\f, \\n, \\r, \\t, \\v, which
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -243,12 +243,12 @@ freely intermixed with filenames and the
|
2006-12-28 23:06:40 +00:00
|
|
|
.TP
|
|
|
|
.B \-t, \-\-typedefs
|
|
|
|
Record typedefs in C code as tags. Since this is the default behavior
|
|
|
|
-of \fBetags\fP, only \fBctags\fP accepts this option.
|
|
|
|
+of \fBetags\fP, only \fBgnuctags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-T, \-\-typedefs\-and\-c++
|
|
|
|
Generate tag entries for typedefs, struct, enum, and union tags, and
|
|
|
|
C++ member functions. Since this is the default behavior
|
|
|
|
-of \fBetags\fP, only \fBctags\fP accepts this option.
|
|
|
|
+of \fBetags\fP, only \fBgnuctags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-u, \-\-update
|
|
|
|
Update tag entries for \fIfiles\fP specified on command line, leaving
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -256,15 +256,15 @@ tag entries for other files in place. C
|
2006-12-28 23:06:40 +00:00
|
|
|
by deleting the existing entries for the given files and then
|
|
|
|
rewriting the new entries at the end of the tags file. It is often
|
|
|
|
faster to simply rebuild the entire tag file than to use this.
|
|
|
|
-Only \fBctags\fP accepts this option.
|
|
|
|
+Only \fBgnuctags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-v, \-\-vgrind
|
|
|
|
Instead of generating a tag file, write index (in \fBvgrind\fP format)
|
|
|
|
-to standard output. Only \fBctags\fP accepts this option.
|
|
|
|
+to standard output. Only \fBgnuctags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-x, \-\-cxref
|
|
|
|
Instead of generating a tag file, write a cross reference (in
|
|
|
|
-\fBcxref\fP format) to standard output. Only \fBctags\fP accepts this option.
|
|
|
|
+\fBcxref\fP format) to standard output. Only \fBgnuctags\fP accepts this option.
|
|
|
|
.TP
|
|
|
|
.B \-h, \-H, \-\-help
|
|
|
|
Print usage information. Followed by one or more \-\-language=LANG
|
2007-11-13 20:47:04 +00:00
|
|
|
@@ -278,8 +278,10 @@ emacs \fBetags\fP is shipped with).
|
2006-12-28 23:06:40 +00:00
|
|
|
`\|\fBemacs\fP\|' entry in \fBinfo\fP; \fIGNU Emacs Manual\fP, Richard
|
|
|
|
Stallman.
|
|
|
|
.br
|
|
|
|
+.BR ctags ( 1 ),
|
|
|
|
.BR cxref ( 1 ),
|
|
|
|
.BR emacs ( 1 ),
|
|
|
|
+.BR gnuctags ( 1 ),
|
|
|
|
.BR vgrind ( 1 ),
|
|
|
|
.BR vi ( 1 ).
|
|
|
|
|