AIX命令参考大全,卷 1,a - c - ctags 命令
[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 |
法律条款
]
AIX命令参考大全,卷 1,a - c
ctags 命令
用途
产生标记文件以帮助在源文件中定位对象。
语法
ctags [ -u | -x ] [ -B | -F ] [ -a ] [ -m ]
[ -o ] [ -t ] [ -v ] [ -w ] [ -f TagsFile ] File . ..
描述
ctags 命令从指定的 C、Pascal、FORTRAN、yacc、lex 和 LISP 源文件中创建一个标记文件,以便
ex 和 vi 编辑器使用。标记文件是由源文件中的编程语言指定对象(例如函数和类型定义)的定位器组成的。一个定位器的组成包括:对象名、定义的文件和基本正则表达式或用以搜索对象定义的行号。
提供的说明符位于行的不同字段,由空格或制表符分开。使用标记
文件, ex 和 vi 可以快速的查找这些对象定义。
以下文件名后缀是由 ctags 命令支持的:
.c
当作 C 语言源代码对待并搜索 C 例程和宏定义。
.h
当作 C 语言源代码对待并搜索 C 例程和宏定义。
.f
当作 FORTRAN 语言源代码对待。
.l
如果第一个非空格字符是 [ (开方括号),( (开圆括号)和; (分号),则当作 LISP 语言源代码对待。否则当作 lex 语言
源代码对待。
以任意其它后缀结束的文件名,首先要被检查是否包含任何
Pascal 或 FORTRAN 例程定义。如果不包含,它们被当作 C 语言源代码重新进行处理。没有
一个 . (点)后缀的文件被当作 C 语言源代码处理。
在 C 程序中, main 标记被特别对待。标记格式的创建是通过将前缀 M 加到文件名中,除去扩展名 .c (如果任意)并除去最主要的路径名组件。
使用 ctags 实际上位于超过一个程序的目录中。
注意:
识别关键字 Function ,在 FORTRAN 和 Pascal 代码中用于指定 subroutine 和 procedure 的地址,而不管块的结构。
如果任意两个 Pascal 过程有相同的名称,即使它们在不同的块中,ctags 命令可能产生不充分的结果。
ctags 命令不能识别
#if 和 #ifdef 语句。
如果 -B 和 -F 选项都被指定,最后被指定的选项将被优先使用。
这个 -x 选项优先于其它任意选项(-a 、-u 或 -f ),这些选项将另外创建标记文件。
当 -v 选项被指定后,-x 选项是默示的。
ctags 命令的输出总是由对象标识符分类。
标志
-a
附加到标记文件。附加完以后,ctags 将标记文件分类。
-B
引起 ctags 使用反向搜索模式 (?. .?)。
-F
引起 ctags 使用正向搜索模式
(/. . ./)。 这是缺省的搜索模式。
-f TagsFile
创建一个标记文件,其名称被 TagsFile 指定,而不是缺省的 tags 文件。
-m
引起 ctags 不为宏定义创建标记。
-o
引起 ctags 为类型定义产生行号,而不是用来搜索对象定义的基本正则表达式。
-t
为类型定义创建标记。由于标准一致,这个标记是缺省的。
-u
更新指定的标记文件,即所有对它们的引用被删除,新的值被附加到文件中。这个标记会减慢
命令的处理。(简单重建标记文件通常是比较快的。)
-v
产生 vgrind 命令在标准输出中所期望的格式的索引。这个列表包含函数名、文件名和页码(假定 64 行页面)。
-w
引起 ctags 排除诊断警告消息。
-x
引起 ctags 命令显示对象名、行数和文件名的列表,其中的每一个已被定义,正如行的文本一样。这提供了一个简单的、可读的函数索引。如果指定这个标志,ctags 命令
不会构建、更新或附加一个标记文件,但写到标准输出中。
示例
要把 ctags 命令输出的 C 语言源文件 x.c 、y.c 和 z.c 写到标准输出中,输入:
ctags -x x.c y.c z.c
要对于所有的当前目录中的 C 语言源文件创建命名为 foo_tags 的标记文件,输入:
ctags -f foo_tags *
要添加附加的标记(包含类型定义)到
foo_tags 标记文件中,为所有的 C 语言源文件 zip.c ,输入:
ctags -utf foo_tags zip.c
退出状态
以下退出值被返回:
文件
usr/bin/more/tags
输出标记文件。
相关信息
ex
命令、lex 命令、vgrind 命令、vi 命令、yacc 命令。
[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 |
法律条款
]