ctags.html

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

directive specifies an absolute path). This option is off by
default. <b>Note:</b> This option is generally only useful
when used together with the
<b>&minus;&minus;excmd</b>=<i>number</i> (<b>&minus;n</b>)
option. Also, you may have to use either the
<b>&minus;&minus;langmap</b> or
<b>&minus;&minus;language&minus;force</b> option if the
extension of the preprocessor output file is not known to
<b>ctags</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="11%"></td>
<td width="89%">

<p><b>&minus;&minus;links</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 symbolic links (if supported) should be
followed. When disabled, symbolic links are ignored. This
option is on 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;list&minus;kinds</b>[=<i>language</i>|<i>all</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>Lists the tag kinds recognized for either the specified
language or all languages, and then exits. Each kind of tag
recorded in the tag file is represented by a one-letter
flag, which is also used to filter the tags placed into the
output through use of the
<b>&minus;&minus;&lt;LANG&gt;&minus;kinds</b> option. Note
that some languages and/or tag kinds may be implemented
using regular expressions and may not be available if regex
support is not compiled into <b>ctags</b> (see the
<b>&minus;&minus;regex&minus;&lt;LANG&gt;</b> option). Each
kind listed is enabled unless followed by
&quot;[off]&quot;.</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;list&minus;maps</b>[=<i>language</i>|<i>all</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>Lists the file extensions and file name patterns which
associate a file name with a language for either the
specified language or all languages, and then exits. See the
<b>&minus;&minus;langmap</b> option, and <b>SOURCE
FILES</b>, above.</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;list&minus;languages</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>Lists the names of the languages understood by
<b>ctags</b>, and then exits. These language names are case
insensitive and may be used in the
<b>&minus;&minus;language&minus;force</b>,
<b>&minus;&minus;languages</b>,
<b>&minus;&minus;&lt;LANG&gt;&minus;kinds</b>, and
<b>&minus;&minus;regex&minus;&lt;LANG&gt;</b> options.</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;options</b>=<i>file</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>Read additional options from <i>file</i>. The file should
contain one option per line. As a special case, if
<b>&minus;&minus;options</b>=<i>NONE</i> is specified as the
first option on the command line, it will disable the
automatic reading of any configuration options from either a
file or the environment (see <b>FILES</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="11%"></td>
<td width="89%">

<p><b>&minus;&minus;recurse</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>Recurse into directories encountered in the list of
supplied files. If the list of supplied files is empty and
no file list is specified with the <b>&minus;L</b> option,
then the current directory (i.e. &quot;.&quot;) is assumed.
Symbolic links are followed. If you don&rsquo;t like these
behaviors, either explicitly specify the files or pipe the
output of <b>find</b>(1) into <b>ctags &minus;L&minus;</b>
instead. <b>Note:</b> This option is not supported on all
platforms at present. It is available if the output of the
<b>&minus;&minus;help</b> option includes this option. See,
also, the <b>&minus;&minus;exclude</b> to limit
recursion.</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;regex&minus;&lt;LANG&gt;</b>=<i>/regexp/replacement/[kind&minus;spec/][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>The <i>/regexp/replacement/</i> pair define a regular
expression replacement pattern, similar in style to
<b>sed</b> substitution commands, with which to generate
tags from source files mapped to the named language,
<b>&lt;LANG&gt;</b>, (case-insensitive; either a built-in or
user-defined language). The regular expression,
<i>regexp</i>, defines an extended regular expression
(roughly that used by <b>egrep</b>(1)), which is used to
locate a single source line containing a tag and may specify
tab characters using \t. When a matching line is found, a
tag will be generated for the name defined by
<i>replacement</i>, which generally will contain the special
back-references \1 through \9 to refer to matching
sub-expression groups within <i>regexp</i>. The
&rsquo;/&rsquo; separator characters shown in the parameter
to the option can actually be replaced by any character.
Note that whichever separator character is used will have to
be escaped with a backslash (&rsquo;\&rsquo;) character
wherever it is used in the parameter as something other than
a separator. The regular expression defined by this option
is added to the current list of regular expressions for the
specified language unless the parameter is omitted, in which
case the current list is cleared.</p>
<!-- INDENTATION -->
<p>Unless modified by <i>flags</i>, <i>regexp</i> is
interpreted as a Posix extended regular expression. The
<i>replacement</i> should expand for all matching lines to a
non-empty string of characters, or a warning message will be
reported. An optional kind specifier for tags matching
<i>regexp</i> may follow <i>replacement</i>, which will
determine what kind of tag is reported in the
&quot;kind&quot; extension field (see <b>TAG FILE
FORMAT</b>, below). The full form of <i>kind&minus;spec</i>
is in the form of a single letter, a comma, a name (without
spaces), a comma, a description, followed by a separator,
which specify the short and long forms of the kind value and
its textual description (displayed using
<b>&minus;&minus;list&minus;kinds</b>). Either the kind name
and/or the description may be omitted. If
<i>kind&minus;spec</i> is omitted, it defaults to
&quot;<i>r,regex</i>&quot;. Finally, <i>flags</i> are one or
more single-letter characters having the following effect
upon the interpretation of <i>regexp</i>:</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>b</i></p>
</td>
<td width="4%"></td>
<td width="71%">

<p>The pattern is interpreted as a Posix basic regular
expression.</p>
</td>
<tr valign="top" align="left">
<td width="23%"></td>
<td width="2%">

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

<p>The pattern is interpreted as a Posix extended regular
expression (default).</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>The regular expression is to be applied in a
case-insensitive manner.</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>Note that this option is available only if <b>ctags</b>
was compiled with support for regular expressions, which
depends upon your platform. You can determine if support for
regular expressions is compiled in by examining the output
of the <b>&minus;&minus;version</b> option, which will
include &quot;+regex&quot; in the compiled feature list.</p>
<!-- INDENTATION -->
<p>For more information on the regular expressions used by
<b>ctags</b>, see either the <b>regex(5,7)</b> man page, or
the GNU info documentation for regex (e.g. &quot;info
regex&quot;).</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;sort</b>[=<i>yes</i>|<i>no</i>|<i>foldcase</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 the tag file should be sorted on the
tag name (default is <i>yes</i>). Note that the original
<b>vi</b>(1) required sorted tags. The <i>foldcase</i> value
specifies case insensitive (or case-folded) sorting. Fast
binary searches of tag files sorted with case-folding will
require special support from tools using tag files, such as
that found in the ctags readtags library, or Vim version 6.2
or higher (using &quot;set ignorecase&quot;). 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;tag&minus;relative</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 that the file paths recorded in the tag file
should be relative to the directory containing the tag file,
rather than relative to the current directory, unless the
files supplied on the command line are specified with
absolute paths. This option must appear before the first
file name. The default is <i>yes</i> when running in etags
mode (see the <b>&minus;e</b> option), <i>no</i>
otherwise.</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;totals</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>Prints statistics about the source files read and the tag
file written during the current invocation of <b>ctags</b>.
This option is off 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;verbose</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>Enable verbose mode. This prints out information on
option processing and a brief message describing what action
is being taken for each file considered by <b>ctags</b>.
Normally, <b>ctags</b> does not read command line arguments
until after options are read from the configuration files
(see <b>FILES</b>, below) and the <b>CTAGS</b> environment
variable. However, if this option is the first argument on
the command line, it will take effect before any options are
read from these sources. The default is <i>no</i>.</p>
</td>
</table>
<!-- INDENTATION -->