CTAGS(CP) XENIX System V CTAGS(CP)
Name
ctags - Creates a tags file.
Syntax
ctags [ -a ] [ -u ] [ -v ] [ -w ] [ -x ] name ...
Description
ctags makes a tags file for vi(C) from the specified C
sources. A tags file gives the locations of specified
objects (in this case functions) in a group of files. Each
line of the tags file contains the function name, the file
in which it is defined, and a scanning pattern used to find
the function definition. These are given in separate fields
on the line, separated by blanks or tabs. Using the tags
file, vi can quickly find these function definitions.
If the -x flag is given, ctags produces a list of function
names, the line number and file name on which each is
defined, as well as the text of that line and prints this on
the standard output. With the -x option no tags file is
created. This is a simple index which can be printed out as
an off-line readable function index.
Files whose name ends in .c or .h are assumed to be C source
files and are searched for C routine and macro definitions.
Other options are:
-w Suppresses warning diagnostics.
-u Causes 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.)
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
Page 1 (printed 8/7/87)
CTAGS(CP) XENIX System V CTAGS(CP)
See Also
ex(C), vi(C)
Credit
This utility was developed at the University of California
at
Berkeley and is used with permission.
Page 2 (printed 8/7/87)