--- ctags.1 +++ ctags.1 2001/12/14 14:41:12 @@ -9,12 +9,29 @@ .TP 6 \fBctags\fP [\fBoptions\fP] [\fIfile(s)\fP] .TP 6 -\fBetags\fP [\fBoptions\fP] [\fIfile(s)\fP] +\fBctags\fP \fB-e\fP [\fBoptions\fP] [\fIfile(s)\fP] +.SH NOTE +There are three different versions of the +\fBctags\fP program on SuSE Linux. +Besides this one you might want to use either +.BR gnuctags (1), +supporting wide variety of programming languages +and originaly distributed with emacs, or +.BR gctags (1), +which comes with +.BR global (1) +and supports for example Yacc. + +For use with +.BR emacs (1) +the best choice is perhaps +.BR etags (1), +but it's also possible to use \fBctags\ \-e\fP, +as described herein, since it supports for example Eiffel. .SH "DESCRIPTION" -The \fBctags\fP and \fBetags\fP programs (hereinafter collectively referred to -as \fBctags\fP, except where distinguished) generate an index (or "tag") file +The \fBctags\fP program generates an index (or "tag") file for a variety of language objects found in \fIfile(s)\fP. This tag file allows these items to be quickly and easily located by a text editor or other utility. A "tag" signifies a language object for which an @@ -1484,7 +1501,7 @@ .TP 8 .B ETAGS Similar to the \fBCTAGS\fP variable above, this variable, if found, will be -read when \fBetags\fP starts. If this variable is not found, \fBetags\fP will +read when \fBctags\ \-e\fP starts. If this variable is not found, \fBctags\ \-e\fP will try to use \fBCTAGS\fP instead. .TP 8 @@ -1535,9 +1552,15 @@ The default tag file created by \fBctags\fP. .TP .I TAGS -The default tag file created by \fBetags\fP. +The default tag file created by \fBctags -e\fP. .SH "SEE ALSO" +.BR etags (1), +.BR gctags (1), +.BR global (1), +.BR gnuctags (1). + +.PP The official Exuberant Ctags web site at: .RS