version 1.5, 1999/06/05 01:21:22 |
version 1.6, 1999/07/04 11:53:52 |
|
|
.Op Fl f Ar tagsfile |
.Op Fl f Ar tagsfile |
.Ar name ... |
.Ar name ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm ctags |
.Nm |
makes a tags file for |
makes a tags file for |
.Xr ex 1 |
.Xr ex 1 |
from the specified C, |
from the specified C, |
|
|
.It Fl w |
.It Fl w |
Suppress warning diagnostics. |
Suppress warning diagnostics. |
.It Fl x |
.It Fl x |
.Nm ctags |
.Nm |
produces a list of object |
produces a list of object |
names, the line number and file name on which each is defined, as well |
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. This |
as the text of that line and prints this on the standard output. This |
|
|
.Nm \&.c |
.Nm \&.c |
and any leading pathname components removed. This |
and any leading pathname components removed. This |
makes use of |
makes use of |
.Nm ctags |
.Nm |
practical in directories with more than one |
practical in directories with more than one |
program. |
program. |
.Pp |
.Pp |
|
|
default output tags file |
default output tags file |
.El |
.El |
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
.Nm ctags |
.Nm |
exits with a value of 1 if an error occurred, 0 otherwise. |
exits with a value of 1 if an error occurred, 0 otherwise. |
Duplicate objects are not considered errors. |
Duplicate objects are not considered errors. |
.Sh SEE ALSO |
.Sh SEE ALSO |
|
|
.Xr vi 1 |
.Xr vi 1 |
.Sh BUGS |
.Sh BUGS |
Recognition of |
Recognition of |
.Nm functions , |
.Nm functions , |
.Nm subroutines |
.Nm subroutines |
and |
and |
.Nm procedures |
.Nm procedures |
|
|
and Pascal is done in a very simple-minded way. No attempt |
and Pascal is done in a very simple-minded way. No attempt |
is made to deal with block structure; if you have two Pascal procedures |
is made to deal with block structure; if you have two Pascal procedures |
in different blocks with the same name you lose. |
in different blocks with the same name you lose. |
.Nm ctags |
.Nm |
doesn't |
doesn't |
understand about Pascal types. |
understand about Pascal types. |
.Pp |
.Pp |
|
|
.Tn FORTRAN |
.Tn FORTRAN |
functions is a hack. |
functions is a hack. |
.Pp |
.Pp |
.Nm ctags |
.Nm |
relies on the input being well formed, and any syntactical |
relies on the input being well formed, and any syntactical |
errors will completely confuse it. It also finds some legal syntax |
errors will completely confuse it. It also finds some legal syntax |
confusing; for example, since it doesn't understand |
confusing; for example, since it doesn't understand |