---

Ⅰ. 插件描述

Vim plugin for super fast Cscope/GNU GLOBAL results navigation using quickfix window

Ⅱ. 基本信息

创建日期：  2016-04-21 使用用户：  20 Github星：  19 插件作者：  Ronak Gandhi

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'ronakg/quickr-cscope-vim'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'ronakg/quickr-cscope-vim'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'ronakg/quickr-cscope-vim'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/ronakg/quickr-cscope.vim

Ⅳ. 文档说明

# quickr-cscope.vim
Vim plugin for super fast Cscope results navigation using quickfix window.

Features

quickr-cscope.vim provides faster access to
Cscope database search queries within Vim.
Each type of Cscope query is just a keystroke away. Results are shown in a
quickfix window ready for
faster navigation. Paired with excellent quickfix-reflector.vim
plugin, quickr-cscope.vim is a powerful tool for project navigation and
refactoring.

Biggest advantage of using this plugin is, it prevents the
quickfix to jump to first result automatically. Thus preventing it to spoil
your open buffer list.

• Quickly search for symbol, function name, file name, assignments under the cursor
• Quickly search for visually selected text
• Search results are shown in quickfix window, which is way more flexible for
  navigation compared to Cscope's fixed list
• Search term can be navigated using n and N in quickfix window for faster
  movement
• Find the Cscope database and load automatically on startup
• Also works with GNU GLOBAL database

Installation

This plugin follows the standard runtime path structure, and as such it can be
installed with a variety of plugin managers:

• Plug

  • Plug 'ronakg/quickr-cscope.vim'

• NeoBundle

  • NeoBundle 'ronakg/quickr-cscope.vim'

• Vundle

  • Plugin 'ronakg/quickr-cscope.vim'

• Pathogen

  • git clone https://github.com/ronakg/quickr-cscope.vim ~/.vim/bundle/quickr-cscope.vim

• Manual

  • Copy all the files in to your ~/.vim directory

Default Key maps

<leader>s : Search for all symbol occurances of word under the cursor
<leader>g : Search for global definition of the word under the cursor
<leader>c : Search for all callers of the function name under the cursor
<leader>f : Search for all files matching filename under the cursor
<leader>i : Search for all files including filename under the cursor
<leader>t : Search for text matching word under the cursor/visualy selected text
<leader>e : Enter an egrep patter for searching
<leader>d : Search all the functions called by funtion name under the cursor
<leader>a : Search all the places where the symbol under the cursor is assigned a value

P.S.: \ is the leader key by default. So the mappings are \s, \g, \c, etc. unless <leader> key is mapped to something else.

Customization

Disable default key mappings

If you want to use your own key mappings, you can disable the default key
mappings by adding following to your ~/.vimrc file.

let g:quickr_cscope_keymaps = 0

Define custom key mappings

Use following <plug>s to your own liking:

<plug>(quickr_cscope_symbols)
<plug>(quickr_cscope_global)
<plug>(quickr_cscope_callers)
<plug>(quickr_cscope_files)
<plug>(quickr_cscope_includes)
<plug>(quickr_cscope_text)
<plug>(quickr_cscope_egrep)
<plug>(quickr_cscope_functions)
<plug>(quickr_cscope_assignments)

There are 2 more additional <plug>s available for global defintion to open the result in
a horizontal or vertical split.

<plug>(quickr_cscope_global_split)
<plug>(quickr_cscope_global_vert_split)

For example:

nmap <C-s> <plug>(quickr_cscope_symbols)
nmap <C-g>s <plug>(quickr_cscope_global_split)
nmap <C-g>v <plug>(quickr_cscope_global_vert_split)

Use GNU GLOBAL instead of Cscope

If you want to use GNU GLOBAL for searching your codebase, it can be done by
define following in your ~/.vimrc.

let g:quickr_cscope_program = "gtags-cscope"
let g:quickr_cscope_db_file = "GTAGS"

Disable automatic search and load of Cscope database

If you're already using another Cscope plugin that loads the database, you can
disable this feature of the plugin by adding following to your ~/.vimrc.

let g:quickr_cscope_autoload_db = 0

FAQ

I'm not able to use Ctrl-T to go back in tag stack like I used to before.

When you use quickfix to view results of a Cscope query, those results
are not passed to taglist. You need to use Ctrl-o (jumplist) to go back to
where you were from a result.

When there are multiple matches for global definition, it doesn't open in quickfix window.

By default global definitions are not shown in quickfix window. This
behavior can be set by setting g:quickr_cscope_use_qf_g to 1.

let g:quickr_cscope_use_qf_g = 1

License

Copyright (c) Ronak Gandhi. Distributed under the same terms as Vim itself. See
:help license