ctags(1)
_________________________________________________________________
ctags Command
create a tags file
_________________________________________________________________
SYNTAX
ctags [ -BFatuwvx ] name ...
DESCRIPTION
Ctags makes a tags file for ex(1) from the specified C, Pascal
and Fortran sources. A tags file gives the locations of
specified objects (in this case functions and typedefs) in a
group of files. Each line of the tags file contains the object
name, the file in which it is defined, and an address
specification for the object definition. Functions are searched
for with a pattern, typedefs with a line number. Specifiers are
given in separate fields on the line, separated by blanks or
tabs. Using the tags file, ex can quickly find these object
definitions.
If the -x flag is given, ctags produces a list of object names,
the line number and file name on which each is defined, as well
as the text of that line and prints this information on the
standard output. This is a simple index which can be printed
out.
If the -v flag is given, an index of a different form is produced
on the standard output. This listing contains the function name,
file name, and page number (assuming 64 line pages).
Files whose names end in .c or .h are assumed to be C source
files and are searched for C routine and macro definitions.
Others are first examined to see if they contain any Pascal or
Fortran routine definitions; if not, they are processed again
looking for C definitions.
Other options are:
-a append to tags file.
-w suppressing warning diagnostics.
-u causing the specified files to be updated in tags, that is,
all references to them are deleted, and the new values are
appended to the file. (Beware: this option is implemented
in a way which is rather slow; it is usually faster to
simply rebuild the tags file.)
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
ctags(1)
-F use forward searching patterns (/.../) (default).
-B use backward searching patterns (?...?).
-t create tags for typedefs.
The tag main is treated specially in C programs. The tag formed
is created by prepending M to the name of the file, with a
trailing .c removed, if any, and leading pathname components also
removed. This makes use of ctags practical in directories with
more than one program.
FILES
tags output tags file
SEE ALSO
ex(1), vi(1)
BUGS
Recognition of functions, subroutines and procedures for FORTRAN
and Pascal is done in a very simpleminded way. No attempt is
made to deal with block structure; if you have two Pascal
procedures in different blocks with the same name, the procedure
will not work.
Does not know about #ifdefs.
Should know about Pascal types. Relies on the input being well
formed to detect typedefs. Use of -tx shows only the last line
of typedefs.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)