]> code.delx.au - gnu-emacs/blobdiff - doc/man/etags.1
Fix typos.
[gnu-emacs] / doc / man / etags.1
index f39f391d6c1267de5950755f78e92d39a84febab..f7ffa112f3c4f0ecdeff968ada9441a86bf9681f 100644 (file)
@@ -1,6 +1,4 @@
-.\" 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
 .TH etags 1 "23nov2001" "GNU Tools" "GNU Tools"
 .de BP
 .sp
@@ -18,10 +16,10 @@ etags, ctags \- generate tag file for Emacs, vi
 [\|\-o \fItagfile\fP\|] [\|\-r \fIregexp\fP\|]
 [\|\-\-parse\-stdin=\fIfile\fP\|]
 .br
 [\|\-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\-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 .\|.\|.
 [\|\-\-regex=\fIregexp\fP\|] [\|\-\-no\-regex\|]
 [\|\-\-help\|] [\|\-\-version\|]
 \fIfile\fP .\|.\|.
@@ -32,9 +30,9 @@ etags, ctags \- generate tag file for Emacs, vi
 [\|\-\-parse\-stdin=\fIfile\fP\|]
 .br
 [\|\-\-append\|] [\|\-\-backward\-search\|]
 [\|\-\-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\|]
 [\|\-\-output=\fItagfile\fP\|] [\|\-\-regex=\fIregexp\fP\|]
 [\|\-\-update\|]
 [\|\-\-help\|] [\|\-\-version\|]
@@ -49,9 +47,9 @@ understood by
 format understood by
 .BR vi ( 1 )\c
 \&.  Both forms of the program understand
 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
 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
@@ -64,6 +62,7 @@ Files specified with absolute file names will be recorded
 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.
 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, bzip2, and xz.
 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
 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
@@ -95,9 +94,13 @@ Do not create tag entries for C preprocessor constant definitions
 and enum constants.
 This may make the tags file much smaller if many header files are tagged.
 .TP
 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
 .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
 \fB\-i\fP \fIfile\fP, \fB\-\-include=\fIfile\fP
 Include a note in the tag file indicating that, when searching for a
@@ -120,7 +123,7 @@ regexp matching is done in this case (see the \fB\-\-regex\fP option).
 .TP
 .B \-\-members
 Create tag entries for variables that are members of structure-like
 .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.
 .TP
 .B \-\-no\-members
 Do not tag member variables.
@@ -211,7 +214,7 @@ Tag TCL files (this last example shows the usage of a \fItagregexp\fP):
 .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
 .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
 \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
@@ -263,8 +266,9 @@ Stallman.
 .SH COPYING
 Copyright
 .if t \(co
 .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, 2011  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
 .PP
 Permission is granted to make and distribute verbatim copies of this
 document provided the copyright notice and this permission notice are
@@ -280,4 +284,3 @@ document into another language, under the above conditions for
 modified versions, except that this permission notice may be stated
 in a translation approved by the Free Software Foundation.
 
 modified versions, except that this permission notice may be stated
 in a translation approved by the Free Software Foundation.
 
-.\" arch-tag: 9534977f-af78-42f0-991d-1df6b6c05573