diff options
| author | Eli Zaretskii | 2001-04-13 09:30:00 +0000 |
|---|---|---|
| committer | Eli Zaretskii | 2001-04-13 09:30:00 +0000 |
| commit | f9f999d98447e02c462d72d2015cddc4eb7adb4e (patch) | |
| tree | eca286f37f333d5571618e20e1320555da94c37e /etc | |
| parent | 9010db4cd33c5cecb3de3d3a37958f4c377f87bb (diff) | |
| download | emacs-f9f999d98447e02c462d72d2015cddc4eb7adb4e.tar.gz emacs-f9f999d98447e02c462d72d2015cddc4eb7adb4e.zip | |
Fix copyright year, update date, and the markup.
Diffstat (limited to 'etc')
| -rw-r--r-- | etc/etags.1 | 51 |
1 files changed, 27 insertions, 24 deletions
diff --git a/etc/etags.1 b/etc/etags.1 index 735b187744e..b43f9293ac7 100644 --- a/etc/etags.1 +++ b/etc/etags.1 | |||
| @@ -1,6 +1,6 @@ | |||
| 1 | .\" Copyright (c) 1992 Free Software Foundation | 1 | .\" Copyright (c) 1992, 2001 Free Software Foundation |
| 2 | .\" See section COPYING for conditions for redistribution | 2 | .\" See section COPYING for conditions for redistribution |
| 3 | .TH etags 1 "02nov1999" "GNU Tools" "GNU Tools" | 3 | .TH etags 1 "08apr2001" "GNU Tools" "GNU Tools" |
| 4 | .de BP | 4 | .de BP |
| 5 | .sp | 5 | .sp |
| 6 | .ti -.2i | 6 | .ti -.2i |
| @@ -42,10 +42,10 @@ etags, ctags \- generate tag file for Emacs, vi | |||
| 42 | .ad b | 42 | .ad b |
| 43 | .hy 1 | 43 | .hy 1 |
| 44 | .SH DESCRIPTION | 44 | .SH DESCRIPTION |
| 45 | The `\|\fBetags\fP\|' program is used to create a tag table file, in a format | 45 | The \|\fBetags\fP\| program is used to create a tag table file, in a format |
| 46 | understood by | 46 | understood by |
| 47 | .BR emacs ( 1 )\c | 47 | .BR emacs ( 1 )\c |
| 48 | \&; the `\|\fBctags\fP\|' program is used to create a similar table in a | 48 | \&; the \|\fBctags\fP\| program is used to create a similar table in a |
| 49 | format understood by | 49 | format understood by |
| 50 | .BR vi ( 1 )\c | 50 | .BR vi ( 1 )\c |
| 51 | \&. Both forms of the program understand | 51 | \&. Both forms of the program understand |
| @@ -53,14 +53,14 @@ the syntax of C, Objective C, C++, Java, Fortran, Pascal, Cobol, Ada, Perl, | |||
| 53 | LaTeX, Scheme, Emacs Lisp/Common Lisp, Postscript, Erlang, Python, Prolog and | 53 | LaTeX, Scheme, Emacs Lisp/Common Lisp, Postscript, Erlang, Python, Prolog and |
| 54 | most assembler\-like syntaxes. | 54 | most assembler\-like syntaxes. |
| 55 | Both forms read the files specified on the command line, and write a tag | 55 | Both forms read the files specified on the command line, and write a tag |
| 56 | table (defaults: `\|TAGS\|' for \fBetags\fP, `\|tags\|' for | 56 | table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for |
| 57 | \fBctags\fP) in the current working directory. | 57 | \fBctags\fP) in the current working directory. |
| 58 | Files specified with relative file names will be recorded in the tag | 58 | Files specified with relative file names will be recorded in the tag |
| 59 | table with file names relative to the directory where the tag table | 59 | table with file names relative to the directory where the tag table |
| 60 | resides. Files specified with absolute file names will be recorded | 60 | resides. Files specified with absolute file names will be recorded |
| 61 | with absolute file names. | 61 | with absolute file names. |
| 62 | The programs recognize the language used in an input file based on its | 62 | The programs recognize the language used in an input file based on its |
| 63 | file name and contents. The --language switch can be used to force | 63 | file name and contents. The \fB\-\-language\fP switch can be used to force |
| 64 | parsing of the file names following the switch according to the given | 64 | parsing of the file names following the switch according to the given |
| 65 | language, overriding guesses based on filename extensions. | 65 | language, overriding guesses based on filename extensions. |
| 66 | .SH OPTIONS | 66 | .SH OPTIONS |
| @@ -70,7 +70,7 @@ by ctags; | |||
| 70 | The programs accept unambiguous abbreviations for long option names. | 70 | The programs accept unambiguous abbreviations for long option names. |
| 71 | .TP | 71 | .TP |
| 72 | .B \-a, \-\-append | 72 | .B \-a, \-\-append |
| 73 | Append to existing tag file. (For vi-format tag files, see also | 73 | Append to existing tag file. (For \fBvi\fP-format tag files, see also |
| 74 | \fB\-\-update\fP.) | 74 | \fB\-\-update\fP.) |
| 75 | .TP | 75 | .TP |
| 76 | .B \-B, \-\-backward\-search | 76 | .B \-B, \-\-backward\-search |
| @@ -140,17 +140,19 @@ Do not tag member variables. This is the default behavior. | |||
| 140 | Only tag packages in Ada files. | 140 | Only tag packages in Ada files. |
| 141 | .TP | 141 | .TP |
| 142 | \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP | 142 | \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP |
| 143 | Explicit name of file for tag table; overrides default `\|TAGS\|' or | 143 | Explicit name of file for tag table; overrides default \fBTAGS\fP or |
| 144 | `\|tags\|'. (But ignored with \fB\-v\fP or \fB\-x\fP.) | 144 | \fBtags\fP. (But ignored with \fB\-v\fP or \fB\-x\fP.) |
| 145 | .TP | 145 | .TP |
| 146 | \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP | 146 | \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP |
| 147 | \fB\-\-ignore\-case\-regex=\fIregexp\fP\ | 147 | .TP |
| 148 | Make tags based on regexp matching for each line of the files following | 148 | \fB\-\-ignore\-case\-regex=\fIregexp\fP |
| 149 | this option, in addition to the tags made with the standard parsing based | 149 | Make tags based on regexp matching for each line of the files |
| 150 | on language. When using \-\-regex, case is significant, while it is not | 150 | following this option, in addition to the tags made with the standard |
| 151 | with \-\-ignore\-case\-regex. May be freely intermixed with filenames and | 151 | parsing based on language. When using \fB\-\-regex\fP, case is |
| 152 | the \fB\-R\fP option. The regexps are cumulative, i.e. each option will | 152 | significant, while it is not with \fB\-\-ignore\-case\-regex\fP. May |
| 153 | add to the previous ones. The regexps are of the form: | 153 | be freely intermixed with filenames and the \fB\-R\fP option. The |
| 154 | regexps are cumulative, i.e. each option will add to the previous | ||
| 155 | ones. The regexps are of the form: | ||
| 154 | .br | 156 | .br |
| 155 | \fB/\fP\fItagregexp\fP[\fB/\fP\fInameregexp\fP]\fB/\fP | 157 | \fB/\fP\fItagregexp\fP[\fB/\fP\fInameregexp\fP]\fB/\fP |
| 156 | .br | 158 | .br |
| @@ -161,7 +163,8 @@ such that more characters than needed are unavoidably matched by | |||
| 161 | \fItagregexp\fP, it may be useful to add a \fInameregexp\fP, to | 163 | \fItagregexp\fP, it may be useful to add a \fInameregexp\fP, to |
| 162 | narrow down the tag scope. \fBctags\fP ignores regexps without a | 164 | narrow down the tag scope. \fBctags\fP ignores regexps without a |
| 163 | \fInameregexp\fP. The syntax of regexps is the same as in emacs, | 165 | \fInameregexp\fP. The syntax of regexps is the same as in emacs, |
| 164 | augmented with intervals of the form \\{m,n\\}, as in ed or grep. | 166 | augmented with intervals of the form \\{m,n\\}, as in \fBed\fP or |
| 167 | \fBgrep\fP. | ||
| 165 | .br | 168 | .br |
| 166 | Here are some examples. All the regexps are quoted to protect them | 169 | Here are some examples. All the regexps are quoted to protect them |
| 167 | from shell interpretation. | 170 | from shell interpretation. |
| @@ -186,17 +189,17 @@ Tag TCL files (this last example shows the usage of a \fItagregexp\fP): | |||
| 186 | \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP | 189 | \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP |
| 187 | 190 | ||
| 188 | .br | 191 | .br |
| 189 | A regexp can be preceded by {lang}, thus restriciting it to match lines of | 192 | A regexp can be preceded by {\fIlang\fP}, thus restriciting it to match |
| 190 | files of the specified language. Use \fBetags --help\bP to obtain a list | 193 | lines of files of the specified language. Use \fBetags --help\fP to obtain |
| 191 | of the recognised languages. This feature is particularly useful inside | 194 | a list of the recognised languages. This feature is particularly useful inside |
| 192 | \fBregex files\fB. A regex file contains one regex per line. Empty lines, | 195 | \fBregex files\fP. A regex file contains one regex per line. Empty lines, |
| 193 | and those lines beginning with space or tab are ignored. Lines beginning | 196 | and those lines beginning with space or tab are ignored. Lines beginning |
| 194 | with @ are references to regex files whose name follows the @ sign. Other | 197 | with @ are references to regex files whose name follows the @ sign. Other |
| 195 | lines are considered regular expressions like those following \-\-regex. | 198 | lines are considered regular expressions like those following \fB\-\-regex\fP. |
| 196 | .br | 199 | .br |
| 197 | For example, the command | 200 | For example, the command |
| 198 | .br | 201 | .br |
| 199 | etags \-\-regex=@regex.file *.c | 202 | \fIetags \-\-regex=@regex.file *.c\fP |
| 200 | .br | 203 | .br |
| 201 | reads the regexes contained in the file regex.file. | 204 | reads the regexes contained in the file regex.file. |
| 202 | .TP | 205 | .TP |
| @@ -251,7 +254,7 @@ Stallman. | |||
| 251 | .BR vi ( 1 ). | 254 | .BR vi ( 1 ). |
| 252 | 255 | ||
| 253 | .SH COPYING | 256 | .SH COPYING |
| 254 | Copyright (c) 1999 Free Software Foundation, Inc. | 257 | Copyright (c) 1999, 2001 Free Software Foundation, Inc. |
| 255 | .PP | 258 | .PP |
| 256 | Permission is granted to make and distribute verbatim copies of | 259 | Permission is granted to make and distribute verbatim copies of |
| 257 | this manual provided the copyright notice and this permission notice | 260 | this manual provided the copyright notice and this permission notice |