forked from pool/ctags
153 lines
6.0 KiB
Diff
153 lines
6.0 KiB
Diff
|
--- 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
|
||
|
@@ -26,7 +26,7 @@
|
||
|
[\|\-\-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\|]
|
||
|
@@ -46,7 +46,7 @@
|
||
|
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
|
||
|
@@ -56,7 +56,7 @@
|
||
|
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
|
||
|
@@ -71,7 +71,7 @@
|
||
|
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
|
||
|
@@ -85,7 +85,7 @@
|
||
|
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,
|
||
|
@@ -94,24 +94,24 @@
|
||
|
.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
|
||
|
@@ -168,7 +168,7 @@
|
||
|
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
|
||
|
@@ -224,7 +224,7 @@
|
||
|
|
||
|
.br
|
||
|
A regexp can be preceded by {\fIlang\fP}, thus restricting it to match
|
||
|
-lines of files of the specified language. Use \fBetags --help\fP to obtain
|
||
|
+lines of files of the specified language. Use \fBetags \-\-help\fP to obtain
|
||
|
a list of the recognised languages. This feature is particularly useful inside
|
||
|
\fBregex files\fP. A regex file contains one regex per line. Empty lines,
|
||
|
and those lines beginning with space or tab are ignored. Lines beginning
|
||
|
@@ -243,12 +243,12 @@
|
||
|
.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
|
||
|
@@ -256,11 +256,11 @@
|
||
|
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 \-w, \-\-no\-warn
|
||
|
Suppress warning messages about duplicate entries. The \fBetags\fP
|
||
|
@@ -269,7 +269,7 @@
|
||
|
.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
|
||
|
@@ -283,8 +283,10 @@
|
||
|
`\|\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 ).
|
||
|
|