annotate doc/man/etags.1 @ 112353:71904feb29f6

Improve performance on non-GCC hosts with __aligned__.
author Paul Eggert <eggert@cs.ucla.edu>
date Mon, 17 Jan 2011 20:55:12 -0800
parents ef719132ddfa
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
100391
eadf60be353b Don't duplicate copyright info in initial comment,
Glenn Morris <rgm@gnu.org>
parents: 97509
diff changeset
1 .\" See section COPYING for copyright and redistribution information.
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2 .TH etags 1 "23nov2001" "GNU Tools" "GNU Tools"
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3 .de BP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4 .sp
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5 .ti -.2i
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6 \(**
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7 ..
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9 .SH NAME
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10 etags, ctags \- generate tag file for Emacs, vi
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
11 .SH SYNOPSIS
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
12 .hy 0
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13 .na
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
14 \fBetags\fP [\|\-aCDGIRVh\|] [\|\-i \fIfile\fP\|] [\|\-l \fIlanguage\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
15 .if n .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
16 [\|\-o \fItagfile\fP\|] [\|\-r \fIregexp\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17 [\|\-\-parse\-stdin=\fIfile\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
18 .br
97509
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
19 [\|\-\-append\|] [\|\-\-no\-defines\|] [\|\-\-globals\|]
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
20 [\|\-\-no\-globals\|] [\|\-\-include=\fIfile\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21 [\|\-\-ignore\-indentation\|] [\|\-\-language=\fIlanguage\fP\|]
97509
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
22 [\|\-\-members\|] [\|\-\-no\-members\|] [\|\-\-output=\fItagfile\fP\|]
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
23 [\|\-\-regex=\fIregexp\fP\|] [\|\-\-no\-regex\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
24 [\|\-\-help\|] [\|\-\-version\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25 \fIfile\fP .\|.\|.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27 \fBctags\fP [\|\-aCdgIRVh\|] [\|\-BtTuvwx\|] [\|\-l \fIlanguage\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 .if n .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29 [\|\-o \fItagfile\fP\|] [\|\-r \fIregexp\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30 [\|\-\-parse\-stdin=\fIfile\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 [\|\-\-append\|] [\|\-\-backward\-search\|]
97509
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
33 [\|\-\-cxref\|] [\|\-\-no\-defines\|]
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
34 [\|\-\-globals\|] [\|\-\-no\-globals\|] [\|\-\-ignore\-indentation\|]
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
35 [\|\-\-language=\fIlanguage\fP\|] [\|\-\-members\|] [\|\-\-no\-members\|]
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36 [\|\-\-output=\fItagfile\fP\|] [\|\-\-regex=\fIregexp\fP\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 [\|\-\-update\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38 [\|\-\-help\|] [\|\-\-version\|]
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39 \fIfile\fP .\|.\|.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 .ad b
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41 .hy 1
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42 .SH DESCRIPTION
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43 The \|\fBetags\fP\| program is used to create a tag table file, in a format
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 understood by
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45 .BR emacs ( 1 )\c
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46 \&; the \|\fBctags\fP\| program is used to create a similar table in a
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47 format understood by
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 .BR vi ( 1 )\c
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49 \&. Both forms of the program understand
97509
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
50 the syntax of C, Objective C, C++, Java, Fortran, Ada, Cobol, Erlang,
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
51 Forth, HTML, LaTeX, Emacs Lisp/Common Lisp, Lua, Makefile, Pascal, Perl,
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
52 PHP, Postscript, Python, Prolog, Scheme and
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53 most assembler\-like syntaxes.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54 Both forms read the files specified on the command line, and write a tag
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56 \fBctags\fP) in the current working directory.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57 Files specified with relative file names will be recorded in the tag
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58 table with file names relative to the directory where the tag table
86089
127279e2403a Note that you can use "-" with -o in Etags.
Francesco Potortì <pot@gnu.org>
parents: 83913
diff changeset
59 resides. If the tag table is in /dev or is the standard output,
127279e2403a Note that you can use "-" with -o in Etags.
Francesco Potortì <pot@gnu.org>
parents: 83913
diff changeset
60 however, the file names are made relative to the working directory.
127279e2403a Note that you can use "-" with -o in Etags.
Francesco Potortì <pot@gnu.org>
parents: 83913
diff changeset
61 Files specified with absolute file names will be recorded
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 with absolute file names. Files generated from a source file\-\-like
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 a C file generated from a source Cweb file\-\-will be recorded with
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64 the name of the source file.
110579
5fabe7db5188 Add more xz compression support.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
65 Compressed files are supported using gzip, bzip2, and xz.
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 The programs recognize the language used in an input file based on its
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 file name and contents. The \fB\-\-language\fP switch can be used to force
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68 parsing of the file names following the switch according to the given
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 language, overriding guesses based on filename extensions.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70 .SH OPTIONS
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 Some options make sense only for the \fBvi\fP style tag files produced
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72 by ctags;
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73 \fBetags\fP does not recognize them.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
74 The programs accept unambiguous abbreviations for long option names.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
75 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76 .B \-a, \-\-append
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77 Append to existing tag file. (For \fBvi\fP-format tag files, see also
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
78 \fB\-\-update\fP.)
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
79 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
80 .B \-B, \-\-backward\-search
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
81 Tag files written in the format expected by \fBvi\fP contain regular
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
82 expression search instructions; the \fB\-B\fP option writes them using
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
83 the delimiter `\|\fB?\fP\|', to search \fIbackwards\fP through files.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
84 The default is to use the delimiter `\|\fB/\fP\|', to search \fIforwards\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
85 through files.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
86 Only \fBctags\fP accepts this option.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
87 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
88 .B \-\-declarations
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
89 In C and derived languages, create tags for function declarations,
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
90 and create tags for extern variables unless \-\-no\-globals is used.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
91 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
92 .B \-D, \-\-no\-defines
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
93 Do not create tag entries for C preprocessor constant definitions
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
94 and enum constants.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
95 This may make the tags file much smaller if many header files are tagged.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
96 .TP
97509
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
97 .B \-\-globals
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
98 Create tag entries for global variables in Perl and Makefile. This is
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
99 the default in C and derived languages.
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
100 .TP
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
101 .B \-\-no\-globals
97509
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
102 Do not tag global variables in C and derived languages. Typically this
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
103 reduces the file size by one fourth.
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
104 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
105 \fB\-i\fP \fIfile\fP, \fB\-\-include=\fIfile\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
106 Include a note in the tag file indicating that, when searching for a
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
107 tag, one should also consult the tags file \fIfile\fP after checking the
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
108 current file. Only \fBetags\fP accepts this option.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
109 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
110 .B \-I, \-\-ignore\-indentation
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
111 Don't rely on indentation as much as we normally do. Currently, this
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
112 means not to assume that a closing brace in the first column is the
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
113 final brace of a function or structure definition in C and C++.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
114 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
115 \fB\-l\fP \fIlanguage\fP, \fB\-\-language=\fIlanguage\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
116 Parse the following files according to the given language. More than
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
117 one such options may be intermixed with filenames. Use \fB\-\-help\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
118 to get a list of the available languages and their default filename
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
119 extensions. The `auto' language can be used to restore automatic
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
120 detection of language based on the file name. The `none'
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
121 language may be used to disable language parsing altogether; only
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
122 regexp matching is done in this case (see the \fB\-\-regex\fP option).
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
123 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
124 .B \-\-members
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
125 Create tag entries for variables that are members of structure-like
97509
763d3ace20b5 Compressed files are supported using gzip and bzip2.
Francesco Potortì <pot@gnu.org>
parents: 96448
diff changeset
126 constructs in PHP. This is the default for C and derived languages.
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
127 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
128 .B \-\-no\-members
86317
2aa93dd1b1cb Ctags and Etags now share the same defaults, so remove
Francesco Potortì <pot@gnu.org>
parents: 86089
diff changeset
129 Do not tag member variables.
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
130 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
131 .B \-\-packages\-only
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
132 Only tag packages in Ada files.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
133 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
134 \fB\-\-parse\-stdin=\fIfile\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
135 May be used (only once) in place of a file name on the command line.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
136 \fBetags\fP will read from standard input and mark the produced tags
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
137 as belonging to the file \fBFILE\fP.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
138 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
139 \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP
86089
127279e2403a Note that you can use "-" with -o in Etags.
Francesco Potortì <pot@gnu.org>
parents: 83913
diff changeset
140 Explicit name of file for tag table; for \fBetags\fP only, a file name
127279e2403a Note that you can use "-" with -o in Etags.
Francesco Potortì <pot@gnu.org>
parents: 83913
diff changeset
141 of \- means standard output; overrides default \fBTAGS\fP or \fBtags\fP.
127279e2403a Note that you can use "-" with -o in Etags.
Francesco Potortì <pot@gnu.org>
parents: 83913
diff changeset
142 (But ignored with \fB\-v\fP or \fB\-x\fP.)
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
143 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
144 \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
145
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
146 Make tags based on regexp matching for the files following this option,
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
147 in addition to the tags made with the standard parsing based on
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
148 language. May be freely intermixed with filenames and the \fB\-R\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
149 option. The regexps are cumulative, i.e. each such option will add to
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
150 the previous ones. The regexps are of one of the forms:
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
151 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
152 [\fB{\fP\fIlanguage\fP\fB}\fP]\fB/\fP\fItagregexp/\fP[\fInameregexp\fP\fB/\fP]\fImodifiers\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
153 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
154 \fB@\fP\fIregexfile\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
155 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
156
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
157 where \fItagregexp\fP is used to match the tag. It should not match
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
158 useless characters. If the match is such that more characters than
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
159 needed are unavoidably matched by \fItagregexp\fP, it may be useful to
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
160 add a \fInameregexp\fP, to narrow down the tag scope. \fBctags\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
161 ignores regexps without a \fInameregexp\fP. The syntax of regexps is
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
162 the same as in emacs. The following character escape sequences are
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
163 supported: \\a, \\b, \\d, \\e, \\f, \\n, \\r, \\t, \\v, which
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
164 respectively stand for the ASCII characters BEL, BS, DEL, ESC, FF, NL,
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
165 CR, TAB, VT.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
166 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
167 The \fImodifiers\fP are a sequence of 0 or more characters among
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
168 \fIi\fP, which means to ignore case when matching; \fIm\fP, which means
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
169 that the \fItagregexp\fP will be matched against the whole file contents
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
170 at once, rather than line by line, and the matching sequence can match
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
171 multiple lines; and \fIs\fP, which implies \fIm\fP and means that the
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
172 dot character in \fItagregexp\fP matches the newline char as well.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
173 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
174 The separator, which is \fB/\fP in the examples, can be any character
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
175 different from space, tab, braces and \fB@\fP. If the separator
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
176 character is needed inside the regular expression, it must be quoted
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
177 by preceding it with \fB\\\fP.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
178 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
179 The optional \fB{\fP\fIlanguage\fP\fB}\fP prefix means that the tag
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
180 should be
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
181 created only for files of language \fIlanguage\fP, and ignored
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
182 otherwise. This is particularly useful when storing many predefined
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
183 regexps in a file.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
184 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
185 In its second form, \fIregexfile\fP is the name of a file that contains
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
186 a number of arguments to the \fI\-\-regex\=\fP option,
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
187 one per line. Lines beginning with a space or tab are assumed
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
188 to be comments, and ignored.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
189
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
190 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
191 Here are some examples. All the regexps are quoted to protect them
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
192 from shell interpretation.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
193 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
194
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
195 Tag the DEFVAR macros in the emacs source files:
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
196 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
197 \fI\-\-regex\='/[ \\t]*DEFVAR_[A-Z_ \\t(]+"\\([^"]+\\)"/'\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
198 .\"" This comment is to avoid confusion to Emacs syntax highlighting
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
199 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
200
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
201 Tag VHDL files (this example is a single long line, broken here for
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
202 formatting reasons):
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
203 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
204 \fI\-\-language\=none\ \-\-regex='/[\ \\t]*\\(ARCHITECTURE\\|\\
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
205 CONFIGURATION\\)\ +[^\ ]*\ +OF/'\ \-\-regex\='/[\ \\t]*\\
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
206 \\(ATTRIBUTE\\|ENTITY\\|FUNCTION\\|PACKAGE\\(\ BODY\\)?\\
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
207 \\|PROCEDURE\\|PROCESS\\|TYPE\\)[\ \\t]+\\([^\ \\t(]+\\)/\\3/'\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
208 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
209
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
210 Tag TCL files (this last example shows the usage of a \fItagregexp\fP):
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
211 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
212 \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
213
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
214 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
215 A regexp can be preceded by {\fIlang\fP}, thus restricting it to match
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
216 lines of files of the specified language. Use \fBetags \-\-help\fP to obtain
96448
187da50507c8 American English spelling fix.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
217 a list of the recognized languages. This feature is particularly useful inside
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
218 \fBregex files\fP. A regex file contains one regex per line. Empty lines,
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
219 and those lines beginning with space or tab are ignored. Lines beginning
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
220 with @ are references to regex files whose name follows the @ sign. Other
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
221 lines are considered regular expressions like those following \fB\-\-regex\fP.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
222 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
223 For example, the command
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
224 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
225 \fIetags \-\-regex=@regex.file *.c\fP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
226 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
227 reads the regexes contained in the file regex.file.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
228 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
229 .B \-R, \-\-no\-regex
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
230 Don't do any more regexp matching on the following files. May be
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
231 freely intermixed with filenames and the \fB\-\-regex\fP option.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
232 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
233 .B \-u, \-\-update
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
234 Update tag entries for \fIfiles\fP specified on command line, leaving
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
235 tag entries for other files in place. Currently, this is implemented
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
236 by deleting the existing entries for the given files and then
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
237 rewriting the new entries at the end of the tags file. It is often
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
238 faster to simply rebuild the entire tag file than to use this.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
239 Only \fBctags\fP accepts this option.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
240 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
241 .B \-v, \-\-vgrind
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
242 Instead of generating a tag file, write index (in \fBvgrind\fP format)
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
243 to standard output. Only \fBctags\fP accepts this option.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
244 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
245 .B \-x, \-\-cxref
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
246 Instead of generating a tag file, write a cross reference (in
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
247 \fBcxref\fP format) to standard output. Only \fBctags\fP accepts this option.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
248 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
249 .B \-h, \-H, \-\-help
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
250 Print usage information. Followed by one or more \-\-language=LANG
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
251 prints detailed information about how tags are created for LANG.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
252 .TP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
253 .B \-V, \-\-version
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
254 Print the current version of the program (same as the version of the
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
255 emacs \fBetags\fP is shipped with).
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
256
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
257 .SH "SEE ALSO"
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
258 `\|\fBemacs\fP\|' entry in \fBinfo\fP; \fIGNU Emacs Manual\fP, Richard
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
259 Stallman.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
260 .br
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
261 .BR cxref ( 1 ),
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
262 .BR emacs ( 1 ),
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
263 .BR vgrind ( 1 ),
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
264 .BR vi ( 1 ).
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
265
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
266 .SH COPYING
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
267 Copyright
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
268 .if t \(co
100391
eadf60be353b Don't duplicate copyright info in initial comment,
Glenn Morris <rgm@gnu.org>
parents: 97509
diff changeset
269 .if n (C)
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 100974
diff changeset
270 1992, 1999, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
112218
376148b31b5e Add 2011 to FSF/AIST copyright years.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
271 2010, 2011 Free Software Foundation, Inc.
83913
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
272 .PP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
273 Permission is granted to make and distribute verbatim copies of this
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
274 document provided the copyright notice and this permission notice are
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
275 preserved on all copies.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
276 .PP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
277 Permission is granted to copy and distribute modified versions of
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
278 this document under the conditions for verbatim copying, provided that
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
279 the entire resulting derived work is distributed under the terms of
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
280 a permission notice identical to this one.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
281 .PP
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
282 Permission is granted to copy and distribute translations of this
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
283 document into another language, under the above conditions for
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
284 modified versions, except that this permission notice may be stated
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
285 in a translation approved by the Free Software Foundation.
a6f4778a1ad7 Move here from ../../etc/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
286