-.\" Copyright (C) 1992, 2001, 2002, 2003, 2004,
-.\" 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
-.\" See section COPYING for conditions for redistribution
+.\" See section COPYING for copyright and redistribution information.
.TH etags 1 "23nov2001" "GNU Tools" "GNU Tools"
.de BP
.sp
[\|\-o \fItagfile\fP\|] [\|\-r \fIregexp\fP\|]
[\|\-\-parse\-stdin=\fIfile\fP\|]
.br
-[\|\-\-append\|] [\|\-\-no\-defines\|]
+[\|\-\-append\|] [\|\-\-no\-defines\|] [\|\-\-globals\|]
[\|\-\-no\-globals\|] [\|\-\-include=\fIfile\fP\|]
[\|\-\-ignore\-indentation\|] [\|\-\-language=\fIlanguage\fP\|]
-[\|\-\-no\-members\|] [\|\-\-output=\fItagfile\fP\|]
+[\|\-\-members\|] [\|\-\-no\-members\|] [\|\-\-output=\fItagfile\fP\|]
[\|\-\-regex=\fIregexp\fP\|] [\|\-\-no\-regex\|]
[\|\-\-help\|] [\|\-\-version\|]
\fIfile\fP .\|.\|.
[\|\-\-parse\-stdin=\fIfile\fP\|]
.br
[\|\-\-append\|] [\|\-\-backward\-search\|]
-[\|\-\-cxref\|] [\|\-\-no\-defines\|] [\|\-\-forward\-search\|]
-[\|\-\-no\-globals\|] [\|\-\-ignore\-indentation\|]
-[\|\-\-language=\fIlanguage\fP\|] [\|\-\-no\-members\|]
+[\|\-\-cxref\|] [\|\-\-no\-defines\|]
+[\|\-\-globals\|] [\|\-\-no\-globals\|] [\|\-\-ignore\-indentation\|]
+[\|\-\-language=\fIlanguage\fP\|] [\|\-\-members\|] [\|\-\-no\-members\|]
[\|\-\-output=\fItagfile\fP\|] [\|\-\-regex=\fIregexp\fP\|]
[\|\-\-update\|]
[\|\-\-help\|] [\|\-\-version\|]
format understood by
.BR vi ( 1 )\c
\&. Both forms of the program understand
-the syntax of C, Objective C, C++, Java, Fortran, Ada, Cobol, Erlang, HTML,
-LaTeX, Emacs Lisp/Common Lisp, Lua, makefile, Pascal, Perl, PHP, Postscript,
-Python, Prolog, Scheme and
+the syntax of C, Objective C, C++, Java, Fortran, Ada, Cobol, Erlang,
+Forth, HTML, LaTeX, Emacs Lisp/Common Lisp, Lua, Makefile, Pascal, Perl,
+PHP, Postscript, Python, Prolog, Scheme and
most assembler\-like syntaxes.
Both forms read the files specified on the command line, and write a tag
table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for
with absolute file names. Files generated from a source file\-\-like
a C file generated from a source Cweb file\-\-will be recorded with
the name of the source file.
+Compressed files are supported using gzip and bzip2.
The programs recognize the language used in an input file based on its
file name and contents. The \fB\-\-language\fP switch can be used to force
parsing of the file names following the switch according to the given
and enum constants.
This may make the tags file much smaller if many header files are tagged.
.TP
+.B \-\-globals
+Create tag entries for global variables in Perl and Makefile. This is
+the default in C and derived languages.
+.TP
.B \-\-no\-globals
-Do not tag global variables. Typically this reduces the file size by
-one fourth.
+Do not tag global variables in C and derived languages. Typically this
+reduces the file size by one fourth.
.TP
\fB\-i\fP \fIfile\fP, \fB\-\-include=\fIfile\fP
Include a note in the tag file indicating that, when searching for a
.TP
.B \-\-members
Create tag entries for variables that are members of structure-like
-constructs in C++, Objective C, Java. This is the default.
+constructs in PHP. This is the default for C and derived languages.
.TP
.B \-\-no\-members
Do not tag member variables.
.br
A regexp can be preceded by {\fIlang\fP}, thus restricting it to match
lines of files of the specified language. Use \fBetags \-\-help\fP to obtain
-a list of the recognised languages. This feature is particularly useful inside
+a list of the recognized languages. This feature is particularly useful inside
\fBregex files\fP. A regex file contains one regex per line. Empty lines,
and those lines beginning with space or tab are ignored. Lines beginning
with @ are references to regex files whose name follows the @ sign. Other
.SH COPYING
Copyright
.if t \(co
-.if n (c)
-1999, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
+.if n (C)
+1992, 1999, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
+2010 Free Software Foundation, Inc.
.PP
Permission is granted to make and distribute verbatim copies of this
document provided the copyright notice and this permission notice are