Cscope 的使用
这下更厉害了, 用Cscope自己的话说 - "你可以把它当做是超过频的ctags",
其功能和强大程度可见一斑吧, 关于它的介绍我就不详细说了, 如果你安装好了前
文介绍的中文帮助手册, 用下面的命令看看介绍吧:
:help if_cscop.txt
我在这里简单摘抄一点, 供还在犹豫的朋友看看:
Cscope 是一个交互式的屏幕下使用的工具，用来帮助你:
* 无须在厚厚的程序清单中翻来翻去就可以认识一个 C 程序的工作原理。
* 无须熟悉整个程序就可以知道清楚程序 bug 所要修改的代码位置。
* 检查提议的改动 (如添加一个枚举值) 可能会产生的效果。
* 验证所有的源文件都已经作了需要的修改；例如给某一个现存的函数添
加一个参数。
* 在所有相关的源文件中对一个全局变量改名。
* 在所有相关的位置将一个常数改为一个预处理符号。
它被设计用来回答以下的问题:
* 什么地方用到了这个符号？
* 这是在什么地方定义的？
* 这个变量在哪里被赋值？
* 这个全局符号的定义在哪里？
* 这个函数在源文件中的哪个地方？
* 哪些函数调用了这个函数？
* 这个函数调用了哪些函数？
* 信息 "out of space" 从哪来？
* 这个源文件在整个目录结构中处于什么位置？
* 哪些文件包含这个头文件？
安装Cscope:
如果你的系统中有cscope命令, 则可以跳过这一小段, 如果没有, 就先跟着我
一起安装一个吧.
在Cscope的主页: http://cscope.sourceforge.net下载一个源码包, 解压后
编译安装:
# ./configure
# make
# make install // 需要root权限
先在~/vimrc中增加一句:
:set cscopequickfix=s-,c-,d-,i-,t-,e-
这个是设定是否使用 quickfix 窗口来显示 cscope 结果, 用法在后面会说到
。
跟Ctags一样, 要使用其功能必须先为你的代码生成一个cscope的数据库, 在项
目的根目录运行下面的命令:
$ cd /home/wooin/vim71/
$ cscope -Rbq
# 此后会生成三个文件
$ ll cscope.*
-rw-rw-r-- 1 wooin wooin 1.1M 2007-09-30 10:56 cscope.in.out
-rw-rw-r-- 1 wooin wooin 6.7M 2007-09-30 10:56 cscope.out
-rw-rw-r-- 1 wooin wooin 5.1M 2007-09-30 10:56 cscope.po.out
# 打开文件, 开始Coding
$ cd src
$ vi main.c
进入vim后第一件事是要把刚才生成的cscope文件导入到vim中来, 用下面的命
令:
:cs add /home/wooin/vim71/cscope.out /home/wooin/vim71
上面这条命令很重要, 必须写全, 不能只写前半句:
:cs add /home/wooin/vim71/cscope.out
因为源码是多级目录的, 如果这样写, cscope是无法在子目录中的源码中工作
的, 当然, 如果你的源码都在同一级目录中就无所谓了. 如果你要经常用cscope的
话, 可以把上面那句加到~/.vimrc中去.
下面我们来操练一下, 查找函数vim_strsave()的定义, 用命令:
:cs find g vim_strsave
按下回车后会自动跳转到vim_strsave()的定义处. 此时你肯定会说Ctags也可
以做到这个呀, 那么下面说的这个Ctags就无法做到了, 我想查找vim_strsave()到
底在那些地方被调用过了, 用命令:
:cs find c vim_strsave
按下回车后vim会自动跳转到第一个符合要求的地方, 并且在命令栏显示有多少
符合要求的结果,
如果自动跳转的位置你不满意, 想看其他的结果, 可以用下面的命令打开Quick
Fix窗口:
:cw
这时你就可以慢慢挑选了^_^
cscope的主要功能是通过同的子命令"find"来实现的
"cscope find"的用法:
cs find c|d|e|f|g|i|s|t name
0 或 s 查找本 C 符号(可以跳过注释)
1 或 g 查找本定义
2 或 d 查找本函数调用的函数
3 或 c 查找调用本函数的函数
4 或 t 查找本字符串
6 或 e 查找本 egrep 模式
7 或 f 查找本文件
8 或 i 查找包含本文件的文件
如果每次查找都要输入一长串命令的话还真是件讨人厌的事情, Cscope的帮助
手册中推荐了一些快捷键的用法, 下面是其中一组, 也是我用的, 将下面的内容添
加到~/.vimrc中, 并重启vim:
nmap <C-_>s :cs find s <C-R>=expand("<cword>")<CR><CR>
nmap <C-_>g :cs find g <C-R>=expand("<cword>")<CR><CR>
nmap <C-_>c :cs find c <C-R>=expand("<cword>")<CR><CR>
nmap <C-_>t :cs find t <C-R>=expand("<cword>")<CR><CR>
nmap <C-_>e :cs find e <C-R>=expand("<cword>")<CR><CR>
nmap <C-_>f :cs find f <C-R>=expand("<cfile>")<CR><CR>
nmap <C-_>i :cs find i ^<C-R>=expand("<cfile>")<CR>$<CR>
nmap <C-_>d :cs find d <C-R>=expand("<cword>")<CR><CR>
当光标停在某个你要查找的词上时, 按下<C-_>g, 就是查找该对象的定义, 其
他的同理.
按这种组合键有一点技巧,按了<C-_>后要马上按下一个键,否则屏幕一闪就回到
nomal状态了
<C-_>g的按法是先按"Ctrl+Shift+-", 然后很快再按"s"
很奇怪, 其中的这句:
nmap <C-_>i :cs find i ^<C-R>=expand("<cfile>")<CR>$<CR>
在我的vim中无法工作, 但是我改成:
nmap <C-_>i :cs find i <C-R>=expand("<cfile>")<CR><CR>
就可以正常工作了, 不知道是什么原因? 有哪位朋友知道请告诉我.
cscope的其他功能你可以通过帮助手册自己慢慢学习
reset : 重新初始化所有连接。
用法 : cs reset
