comparison etc/etags.1 @ 155:43dd3413c7c7 r20-3b4

Import from CVS: tag r20-3b4
author cvs
date Mon, 13 Aug 2007 09:39:39 +0200
parents 25f70ba0133c
children 182f72e8cd0d
comparison
equal deleted inserted replaced
154:94141801dd7e 155:43dd3413c7c7
38 .BR emacs ( 1 )\c 38 .BR emacs ( 1 )\c
39 \&; the `\|\fBctags\fP\|' program is used to create a similar table in a 39 \&; the `\|\fBctags\fP\|' program is used to create a similar table in a
40 format understood by 40 format understood by
41 .BR vi ( 1 )\c 41 .BR vi ( 1 )\c
42 \&. Both forms of the program understand 42 \&. Both forms of the program understand
43 the syntax of C, Objective C, C++, Fortran, Pascal, LaTeX, Scheme, 43 the syntax of C, Objective C, C++, Java, Fortran, Pascal, Cobol,
44 Emacs Lisp/Common Lisp, Erlang, Postscript, Prolog and 44 LaTeX, Scheme, Emacs Lisp/Common Lisp, Postscript, Erlang, Prolog and
45 most assembler\-like syntaxes. 45 most assembler\-like syntaxes.
46 Both forms read the files specified on the command line, and write a tag 46 Both forms read the files specified on the command line, and write a tag
47 table (defaults: `\|TAGS\|' for \fBetags\fP, `\|tags\|' for 47 table (defaults: `\|TAGS\|' for \fBetags\fP, `\|tags\|' for
48 \fBctags\fP) in the current working directory. 48 \fBctags\fP) in the current working directory.
49 Files specified with relative file names will be recorded in the tag 49 Files specified with relative file names will be recorded in the tag
97 extensions. The `auto' language can be used to restore automatic 97 extensions. The `auto' language can be used to restore automatic
98 detection of language based on filename extension. The `none' 98 detection of language based on filename extension. The `none'
99 language may be used to disable language parsing altogether; only 99 language may be used to disable language parsing altogether; only
100 regexp matching is done in this case (see the \fB\-\-regex\fP option). 100 regexp matching is done in this case (see the \fB\-\-regex\fP option).
101 .TP 101 .TP
102 \fB\-\-no_globals\fP
103 Do not tag global variables in C, C++, Objective C, Java. Typically
104 this reduces the file size by one fourth.
105 .TP
106 \fB\-\-members\fP
107 Tag variables that are members of strucure-like constructs in C++,
108 Objective C, Java.
109 .TP
102 \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP 110 \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP
103 Explicit name of file for tag table; overrides default `\|TAGS\|' or 111 Explicit name of file for tag table; overrides default `\|TAGS\|' or
104 `\|tags\|'. (But ignored with \fB\-v\fP or \fB\-x\fP.) 112 `\|tags\|'. (But ignored with \fB\-v\fP or \fB\-x\fP.)
105 .TP 113 .TP
106 \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP 114 \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP
136 .br 144 .br
137 \fI\-\-language\=none\ \-\-regex='/[\ \\t]*\\(ARCHITECTURE\\|\\ 145 \fI\-\-language\=none\ \-\-regex='/[\ \\t]*\\(ARCHITECTURE\\|\\
138 CONFIGURATION\\)\ +[^\ ]*\ +OF/'\ \-\-regex\='/[\ \\t]*\\ 146 CONFIGURATION\\)\ +[^\ ]*\ +OF/'\ \-\-regex\='/[\ \\t]*\\
139 \\(ATTRIBUTE\\|ENTITY\\|FUNCTION\\|PACKAGE\\(\ BODY\\)?\\ 147 \\(ATTRIBUTE\\|ENTITY\\|FUNCTION\\|PACKAGE\\(\ BODY\\)?\\
140 \\|PROCEDURE\\|PROCESS\\|TYPE\\)[\ \\t]+\\([^\ \\t(]+\\)/\\3/'\fP 148 \\|PROCEDURE\\|PROCESS\\|TYPE\\)[\ \\t]+\\([^\ \\t(]+\\)/\\3/'\fP
141 .br
142
143 Tag Cobol files:
144 .br
145 \fI\-\-language\=none \-\-regex\='/.......[a\-zA\-Z0\-9\-]+\\./'\fP
146 .br
147
148 Tag Postscript files:
149 .br
150 \fI\-\-language\=none \-\-regex\='#/[^\ \\t{]+#/'\fP
151 .br 149 .br
152 150
153 Tag TCL files (this last example shows the usage of a \fItagregexp\fP): 151 Tag TCL files (this last example shows the usage of a \fItagregexp\fP):
154 .br 152 .br
155 \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP 153 \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP