diff options
| author | Francesco Potortì | 2001-05-14 12:53:48 +0000 |
|---|---|---|
| committer | Francesco Potortì | 2001-05-14 12:53:48 +0000 |
| commit | 2e98c9c87f37c3869f814edf4a2685161709e9dc (patch) | |
| tree | 575d43bf90bb118efa54609ea15fe1368d063aaa /lib-src | |
| parent | 7b16a6bf075b9d77cd28ec59cc7059d8977802f5 (diff) | |
| download | emacs-2e98c9c87f37c3869f814edf4a2685161709e9dc.tar.gz emacs-2e98c9c87f37c3869f814edf4a2685161709e9dc.zip | |
Markups corrected.
Diffstat (limited to 'lib-src')
| -rw-r--r-- | lib-src/etags.1 | 51 |
1 files changed, 27 insertions, 24 deletions
diff --git a/lib-src/etags.1 b/lib-src/etags.1 index 3ae60ec9a87..abdee8185dc 100644 --- a/lib-src/etags.1 +++ b/lib-src/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 "14gen2001" "GNU Tools" "GNU Tools" | 3 | .TH etags 1 "8apr2001" "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 the syntax of C, Objective C, | 51 | \&. Both forms of the program understand the syntax of C, Objective C, |
| @@ -53,14 +53,14 @@ C++, Java, Fortran, Ada, Cobol, Erlang, LaTeX, Emacs Lisp/Common Lisp, | |||
| 53 | makefiles, Pascal, Perl, Postscript, Python, Prolog, Scheme and most | 53 | makefiles, Pascal, Perl, Postscript, Python, Prolog, Scheme and most |
| 54 | assembler\-like syntaxes. | 54 | 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 |
| @@ -135,16 +135,17 @@ Do not tag member variables. This is the default behavior. | |||
| 135 | Only tag packages in Ada files. | 135 | Only tag packages in Ada files. |
| 136 | .TP | 136 | .TP |
| 137 | \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP | 137 | \fB\-o\fP \fItagfile\fP, \fB\-\-output=\fItagfile\fP |
| 138 | Explicit name of file for tag table; overrides default `\|TAGS\|' or | 138 | Explicit name of file for tag table; overrides default \fBTAGS\fP or |
| 139 | `\|tags\|'. (But ignored with \fB\-v\fP or \fB\-x\fP.) | 139 | \fBtags\fP. (But ignored with \fB\-v\fP or \fB\-x\fP.) |
| 140 | .TP | 140 | .TP |
| 141 | \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP, \fB\-\-ignore\-case\-regex=\fIregexp\fP | 141 | \fB\-r\fP \fIregexp\fP, \fB\-\-regex=\fIregexp\fP, \fB\-\-ignore\-case\-regex=\fIregexp\fP |
| 142 | Make tags based on regexp matching for each line of the files following | 142 | Make tags based on regexp matching for each line of the files following |
| 143 | this option, in addition to the tags made with the standard parsing based | 143 | this option, in addition to the tags made with the standard parsing |
| 144 | on language. When using \-\-regex, case is significant, while it is not | 144 | based on language. When using \fB\-\-regex\fP, case is significant, |
| 145 | with \-\-ignore\-case\-regex. May be freely intermixed with filenames and | 145 | while it is not with \fB\-\-ignore\-case\-regex\fP. May be freely |
| 146 | the \fB\-R\fP option. The regexps are cumulative, i.e. each option will | 146 | intermixed with filenames and the \fB\-R\fP option. The regexps are |
| 147 | add to the previous ones. The regexps are of the form: | 147 | cumulative, i.e. each option will add to the previous ones. The regexps |
| 148 | are of the form: | ||
| 148 | .br | 149 | .br |
| 149 | \fB/\fP\fItagregexp\fP[\fB/\fP\fInameregexp\fP]\fB/\fP | 150 | \fB/\fP\fItagregexp\fP[\fB/\fP\fInameregexp\fP]\fB/\fP |
| 150 | .br | 151 | .br |
| @@ -155,7 +156,8 @@ such that more characters than needed are unavoidably matched by | |||
| 155 | \fItagregexp\fP, it may be useful to add a \fInameregexp\fP, to | 156 | \fItagregexp\fP, it may be useful to add a \fInameregexp\fP, to |
| 156 | narrow down the tag scope. \fBctags\fP ignores regexps without a | 157 | narrow down the tag scope. \fBctags\fP ignores regexps without a |
| 157 | \fInameregexp\fP. The syntax of regexps is the same as in emacs, | 158 | \fInameregexp\fP. The syntax of regexps is the same as in emacs, |
| 158 | augmented with intervals of the form \\{m,n\\}, as in ed or grep. | 159 | augmented with intervals of the form \\{m,n\\}, as in \fBed\fP or |
| 160 | \fBgrep\fP. | ||
| 159 | .br | 161 | .br |
| 160 | Here are some examples. All the regexps are quoted to protect them | 162 | Here are some examples. All the regexps are quoted to protect them |
| 161 | from shell interpretation. | 163 | from shell interpretation. |
| @@ -180,17 +182,18 @@ Tag TCL files (this last example shows the usage of a \fItagregexp\fP): | |||
| 180 | \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP | 182 | \fI\-\-lang\=none \-\-regex\='/proc[\ \\t]+\\([^\ \\t]+\\)/\\1/'\fP |
| 181 | 183 | ||
| 182 | .br | 184 | .br |
| 183 | A regexp can be preceded by {lang}, thus restriciting it to match lines of | 185 | A regexp can be preceded by {\fIlang\fP}, thus restricting it to match |
| 184 | files of the specified language. Use \fBetags --help\fP to obtain a list | 186 | lines of files of the specified language. Use \fBetags --help\fP to |
| 185 | of the recognised languages. This feature is particularly useful inside | 187 | obtain a list of the recognised languages. This feature is particularly |
| 186 | \fBregex files\fP. A regex file contains one regex per line. Empty lines, | 188 | useful inside \fBregex files\fP. A regex file contains one regex per |
| 187 | and those lines beginning with space or tab are ignored. Lines beginning | 189 | line. Empty lines, and those lines beginning with space or tab are |
| 188 | with @ are references to regex files whose name follows the @ sign. Other | 190 | ignored. Lines beginning with @ are references to regex files whose |
| 189 | lines are considered regular expressions like those following \-\-regex. | 191 | name follows the @ sign. Other lines are considered regular expressions |
| 192 | like those following \fB\-\-regex\fP. | ||
| 190 | .br | 193 | .br |
| 191 | For example, the command | 194 | For example, the command |
| 192 | .br | 195 | .br |
| 193 | etags \-\-regex=@regex.file *.c | 196 | \fIetags \-\-regex=@regex.file *.c\fP |
| 194 | .br | 197 | .br |
| 195 | reads the regexes contained in the file regex.file. | 198 | reads the regexes contained in the file regex.file. |
| 196 | .TP | 199 | .TP |
| @@ -245,7 +248,7 @@ Stallman. | |||
| 245 | .BR vi ( 1 ). | 248 | .BR vi ( 1 ). |
| 246 | 249 | ||
| 247 | .SH COPYING | 250 | .SH COPYING |
| 248 | Copyright (c) 1999 Free Software Foundation, Inc. | 251 | Copyright (c) 1999, 2001 Free Software Foundation, Inc. |
| 249 | .PP | 252 | .PP |
| 250 | Permission is granted to make and distribute verbatim copies of | 253 | Permission is granted to make and distribute verbatim copies of |
| 251 | this manual provided the copyright notice and this permission notice | 254 | this manual provided the copyright notice and this permission notice |