ctags.html

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

<td width="3%">

<p>1.</p>
</td>
<td width="3%"></td>
<td width="62%">

<p>Significantly reduces the size of the resulting tag
file.</p>
</td>
<tr valign="top" align="left">
<td width="32%"></td>
<td width="3%">

<p>2.</p>
</td>
<td width="3%"></td>
<td width="62%">

<p>Eliminates failures to find tags because the line
defining the tag has changed, causing the pattern match to
fail (note that some editors, such as <b>vim</b>, are able
to recover in many such instances).</p>
</td>
<tr valign="top" align="left">
<td width="32%"></td>
<td width="3%">

<p>3.</p>
</td>
<td width="3%"></td>
<td width="62%">

<p>Eliminates finding identical matching, but incorrect,
source lines (see <b>BUGS</b>, below).</p>
</td>
<tr valign="top" align="left">
<td width="32%"></td>
<td width="3%">

<p>4.</p>
</td>
<td width="3%"></td>
<td width="62%">

<p>Retains separate entries in the tag file for lines which
are identical in content. In <i>pattern</i> mode, duplicate
entries are dropped because the search patterns they
generate are identical, making the duplicate entries
useless.</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="32%"></td>
<td width="68%">
<p>However, this option has one significant drawback:
changes to the source files can cause the line numbers
recorded in the tag file to no longer correspond to the
lines in the source file, causing jumps to some tags to miss
the target definition by one or more lines. Basically, this
option is best used when the source code to which it is
applied is not subject to change. Selecting this option type
causes the following options to be ignored:
<b>&minus;BF</b>.</p>
</td>
</table>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="4" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="18%"></td>
<td width="11%">

<p><i>pattern</i></p>
</td>
<td width="3%"></td>
<td width="68%">

<p>Use only search patterns for all tags, rather than the
line numbers usually used for macro definitions. This has
the advantage of not referencing obsolete line numbers when
lines have been added or removed since the tag file was
generated.</p>
</td>
<tr valign="top" align="left">
<td width="18%"></td>
<td width="11%">

<p><i>mixed</i></p>
</td>
<td width="3%"></td>
<td width="68%">

<p>In this mode, patterns are generally used with a few
exceptions. For C, line numbers are used for macro
definition tags. This was the default format generated by
the original <b>ctags</b> and is, therefore, retained as the
default for this option. For Fortran, line numbers are used
for common blocks because their corresponding source lines
are generally identical, making pattern searches useless for
finding all matches.</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;extra</b>=<i>[+|&minus;]flags</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 to include extra tag entries for
certain kinds of information. The parameter <i>flags</i> is
a set of one-letter flags, each representing one kind of
extra tag entry to include in the tag file. If <i>flags</i>
is preceded by by either the &rsquo;+&rsquo; or
&rsquo;&minus;&rsquo; character, the effect of each flag is
added to, or removed from, those currently enabled;
otherwise the flags replace any current settings. The
meaning of each flag is as follows:</p>
</td>
</table>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="4" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>f</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Include an entry for the base file name of every source
file (e.g. &quot;example.c&quot;), which addresses the first
line of the file.</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>q</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Include an extra class-qualified tag entry for each tag
which is a member of a class (for languages for which this
information is extracted; currently C++, Eiffel, and Java).
The actual form of the qualified tag depends upon the
language from which the tag was derived (using a form that
is most natural for how qualified calls are specified in the
language). For C++, it is in the form
&quot;class::member&quot;; for Eiffel and Java, it is in the
form &quot;class.member&quot;. This may allow easier
location of a specific tags when multiple occurrences of a
tag name occur in the tag file. Note, however, that this
could potentially more than double the size of the tag
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;fields</b>=<i>[+|&minus;]flags</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 available extension fields which are to be
included in the entries of the tag file (see <b>TAG FILE
FORMAT</b>, below, for more information). The parameter
<i>flags</i> is a set of one-letter flags, each representing
one type of extension field to include, with the following
meanings (disabled by default unless indicated):</p>
</td>
</table>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="4" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>a</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Access (or export) of class members</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>f</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>File-restricted scoping [enabled]</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>i</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Inheritance information</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>k</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Kind of tag as a single letter [enabled]</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>K</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Kind of tag as full name</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>l</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Language of source file containing tag</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>m</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Implementation information</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>n</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Line number of tag definition</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>s</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Scope of tag definition [enabled]</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>S</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Signature of routine (e.g. prototype or parameter
list)</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>z</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Include the &quot;kind:&quot; key in kind field</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

<p><i>t</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>Type and name of a variable or typedef as
&quot;typeref:&quot; field [enabled]</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>Each letter or group of letters may be preceded by either
&rsquo;+&rsquo; to add it to the default set, or
&rsquo;&minus;&rsquo; to exclude it. In the absence of any
preceding &rsquo;+&rsquo; or &rsquo;&minus;&rsquo; sign,
only those kinds explicitly listed in <i>flags</i> will be
included in the output (i.e. overriding the default set).
This option is ignored if the option
<b>&minus;&minus;format</b>=<i>1</i> has been specified. The
default value of this option is <i>fks</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;file&minus;scope</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 whether tags scoped only for a single file
(i.e. tags which cannot be seen outside of the file in which
they are defined, such as &quot;static&quot; tags) should be
included in the output. See, also, the <b>&minus;h</b>
option. This option is enabled 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">