ctags.html

ctags的最新版5.7,可以比较5.6版看看,免费下载

<td width="11%"></td>
<td width="89%">

<p><b>&minus;&minus;filter</b>[=<i>yes</i>|<i>no</i>]</p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Causes <b>ctags</b> to behave as a filter, reading source
file names from standard input and printing their tags to
standard output on a file-by-file basis. If
<b>&minus;&minus;sorted</b> is enabled, tags are sorted only
within the source file in which they are defined. File names
are read from standard input in line-oriented input mode
(see note for <b>&minus;L</b> option) and only after file
names listed on the command line or from any file supplied
using the <b>&minus;L</b> option. When this option is
enabled, the options <b>&minus;f</b>, <b>&minus;o</b>, and
<b>&minus;&minus;totals</b> are ignored. This option is
quite esoteric and is disabled by default. This option must
appear before the first file name.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">

<p><b>&minus;&minus;filter&minus;terminator</b>=<i>string</i></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Specifies a string to print to standard output following
the tags for each file name parsed when the
<b>&minus;&minus;filter</b> option is enabled. This may
permit an application reading the output of ctags to
determine when the output for each file is finished. Note
that if the file name read is a directory and
<b>&minus;&minus;recurse</b> is enabled, this string will be
printed only one once at the end of all tags found for by
descending the directory. This string will always be
separated from the last tag line for the file by its
terminating newline. This option is quite esoteric and is
empty by default. This option must appear before the first
file name.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">
<p><b>&minus;&minus;format</b>=<i>level</i></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Change the format of the output tag file. Currently the
only valid values for <i>level</i> are <i>1</i> or <i>2</i>.
Level 1 specifies the original tag file format and level 2
specifies a new extended format containing extension fields
(but in a manner which retains backward-compatibility with
original <b>vi</b>(1) implementations). The default level is
2. This option must appear before the first file name.
[Ignored in etags mode]</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">
<p><b>&minus;&minus;help</b></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Prints to standard output a detailed usage description,
and then exits.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">
<p><b>&minus;&minus;if0</b>[=<i>yes</i>|<i>no</i>]</p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Indicates a preference as to whether code within an
&quot;#if 0&quot; branch of a preprocessor conditional
should be examined for non-macro tags (macro tags are always
included). Because the intent of this construct is to
disable code, the default value of this option is <i>no</i>.
Note that this indicates a preference only and does not
guarantee skipping code within an &quot;#if 0&quot; branch,
since the fall-back algorithm used to generate tags when
preprocessor conditionals are too complex follows all
branches of a conditional. This option is disabled by
default.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">

<p><b>&minus;&minus;&lt;LANG&gt;&minus;kinds</b>=<i>[+|&minus;]kinds</i></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Specifies a list of language-specific kinds of tags (or
kinds) to include in the output file for a particular
language, where <b>&lt;LANG&gt;</b> is case-insensitive and
is one of the built-in language names (see the
<b>&minus;&minus;list&minus;languages</b> option for a
complete list). The parameter <i>kinds</i> is a group of
one-letter flags designating kinds of tags (particular to
the language) to either include or exclude from the output.
The specific sets of flags recognized for each language,
their meanings and defaults may be list using the
<b>&minus;&minus;list&minus;kinds</b> option. Each letter or
group of letters may be preceded by either &rsquo;+&rsquo;
to add it to, or &rsquo;&minus;&rsquo; to remove it from,
the default set. In the absence of any preceding
&rsquo;+&rsquo; or &rsquo;&minus;&rsquo; sign, only those
kinds explicitly listed in <i>kinds</i> will be included in
the output (i.e. overriding the default for the specified
language).</p>
<!-- INDENTATION -->
<p>As an example for the C language, in order to add
prototypes and external variable declarations to the default
set of tag kinds, but exclude macros, use
<b>&minus;&minus;c&minus;kinds</b>=<i>+px&minus;d</i>; to
include only tags for functions, use
<b>&minus;&minus;c&minus;kinds</b>=<i>f</i>.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">
<p><b>&minus;&minus;langdef</b>=<i>name</i></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Defines a new user-defined language, <i>name</i>, to be
parsed with regular expressions. Once defined, <i>name</i>
may be used in other options taking language names. The
typical use of this option is to first define the language,
then map file names to it using
<i>&minus;&minus;langmap</i>, then specify regular
expressions using
<i>&minus;&minus;regex&minus;&lt;LANG&gt;</i> to define how
its tags are found.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">

<p><b>&minus;&minus;langmap</b>=<i>map[,map[...]]</i></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Controls how file names are mapped to languages (see the
<b>&minus;&minus;list&minus;maps</b> option). Each
comma-separated <i>map</i> consists of the language name
(either a built-in or user-defined language), a colon, and a
list of file extensions and/or file name patterns. A file
extension is specified by preceding the extension with a
period (e.g. &quot;.c&quot;). A file name pattern is
specified by enclosing the pattern in parentheses (e.g.
&quot;([Mm]akefile)&quot;). If appropriate support is
available from the runtime library of your C compiler, then
the file name pattern may contain the usual shell wildcards
common on Unix (be sure to quote the option parameter to
protect the wildcards from being expanded by the shell
before being passed to <b>ctags</b>). You can determine if
shell wildcards are available on your platform by examining
the output of the <b>&minus;&minus;version</b> option, which
will include &quot;+wildcards&quot; in the compiled feature
list; otherwise, the file name patterns are matched against
file names using a simple textual comparison. When mapping a
file extension, it will first be unmapped from any other
languages.</p>
<!-- INDENTATION -->
<p>If the first character in a map is a plus sign, then the
extensions and file name patterns in that map will be
appended to the current map for that language; otherwise,
the map will replace the current map. For example, to
specify that only files with extensions of .c and .x are to
be treated as C language files, use
&quot;<b>&minus;&minus;langmap</b>=<i>c:.c.x</i>&quot;; to
also add files with extensions of .j as Java language files,
specify
&quot;<b>&minus;&minus;langmap</b>=<i>c:.c.x,java:+.j</i>&quot;.
To map makefiles (e.g. files named either
&quot;Makefile&quot;, &quot;makefile&quot;, or having the
extension &quot;.mak&quot;) to a language called
&quot;make&quot;, specify
&quot;<b>&minus;&minus;langmap</b>=<i>make:([Mm]akefile).mak</i>&quot;.
To map files having no extension, specify a period not
followed by a non-period character (e.g. &quot;.&quot;,
&quot;..x&quot;, &quot;.x.&quot;). To clear the mapping for
a particular language (thus inhibiting automatic generation
of tags for that language), specify an empty extension list
(e.g.
&quot;<b>&minus;&minus;langmap</b>=<i>fortran:</i>&quot;).
To restore the default language mappings for all a
particular language, supply the keyword &quot;default&quot;
for the mapping. To specify restore the default language
mappings for all languages, specify
&quot;<b>&minus;&minus;langmap</b>=<i>default</i>&quot;.
Note that file extensions are tested before file name
patterns when inferring the language of a file.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">

<p><b>&minus;&minus;language&minus;force</b>=<i>language</i></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>By default, <b>ctags</b> automatically selects the
language of a source file, ignoring those files whose
language cannot be determined (see <b>SOURCE FILES</b>,
above). This option forces the specified <i>language</i>
(case-insensitive; either built-in or user-defined) to be
used for every supplied file instead of automatically
selecting the language based upon its extension. In
addition, the special value <i>auto</i> indicates that the
language should be automatically selected (which effectively
disables this option).</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">

<p><b>&minus;&minus;languages</b>=<i>[+|&minus;]list</i></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Specifies the languages for which tag generation is
enabled, with <i>list</i> containing a comma-separated list
of language names (case-insensitive; either built-in or
user-defined). If the first language of <i>list</i> is not
preceded by either a &rsquo;+&rsquo; or
&rsquo;&minus;&rsquo;, the current list will be cleared
before adding or removing the languages in <i>list</i>.
Until a &rsquo;&minus;&rsquo; is encountered, each language
in the list will be added to the current list. As either the
&rsquo;+&rsquo; or &rsquo;&minus;&rsquo; is encountered in
the list, the languages following it are added or removed
from the current list, respectively. Thus, it becomes simple
to replace the current list with a new one, or to add or
remove languages from the current list. The actual list of
files for which tags will be generated depends upon the
language extension mapping in effect (see the
<b>&minus;&minus;langmap</b> option). Note that all
languages, including user-defined languages are enabled
unless explicitly disabled using this option. Language names
included in <i>list</i> may be any built-in language or one
previously defined with <b>&minus;&minus;langdef</b>. The
default is &quot;all&quot;, which is also accepted as a
valid argument. See the
<b>&minus;&minus;list&minus;languages</b> option for a
complete list of the built-in language names.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">
<p><b>&minus;&minus;license</b></p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Prints a summary of the software license to standard
output, and then exits.</p>
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="89%">

<p><b>&minus;&minus;line&minus;directives</b>[=<i>yes</i>|<i>no</i>]</p></td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="82%">
<p>Specifies whether &quot;#line&quot; directives should be
recognized. These are present in the output of preprocessors
and contain the line number, and possibly the file name, of
the original source file(s) from which the preprocessor
output file was generated. When enabled, this option will
cause <b>ctags</b> to generate tag entries marked with the
file names and line numbers of their locations original
source file(s), instead of their actual locations in the
preprocessor output. The actual file names placed into the
tag file will have the same leading path components as the
preprocessor output file, since it is assumed that the
original source files are located relative to the
preprocessor output file (unless, of course, the #line