---

Ⅰ. 插件描述

A vim plugin to create completions from an external query command (Mutt's query_command, for example)

Ⅱ. 基本信息

创建日期：  2012-07-14 使用用户：  5 Github星：  8 插件作者：  Caio Romão

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'caio/querycommandcomplete'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'caio/querycommandcomplete'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'caio/querycommandcomplete'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/caio/querycommandcomplete.vim

Ⅳ. 文档说明

Query Command Complete

Vim plugin to suggest completions with the results of an external
query command.

The original intention is to use it as a mutt query_command wrapper
to complete addresses in the mail headers, but it can be adapted
to any other kind of functionality by modifying the exposed setting
parameters.

Last Change: 2013 Jun 16
Author: Caio Romão (http://caioromao.com)
License: This file is placed in the public domain
Contributors:
Brian Henderson https://github.com/bhenderson
Mark Stillwell https://github.com/marklee77
Rui Abreu Ferreira http://ruiabreu.org

Setup:
This plugin exports the completion function QueryCommandComplete,
which can be set as the complete function (or omni function) for
any filetype. If you have a working mutt setup with query_command
configured, the plugin works out of the box.

Example:

  let g:qcc_query_command='abook'
  au BufRead /tmp/mutt* setlocal omnifunc=QueryCommandComplete

Settings:
Note: Overriding settings on a buffer-basis is supported. So

    b:qcc_query_command takes precedence over g:qcc_query_command

g:qcc_query_command

  External command that queries for contacts
  If empty, QueryCommandComplete tries to guess what command to
  run by executing `mutt -Q query_command`.

g:qcc_line_separator

  Separator for each entry in the result from the query
  default: '\n'

g:qcc_field_separator

  Separator for the fields of an entry from the result
  default: '\t'

g:qcc_pattern

  Pattern used to match against the current line to decide
  whether to call the query command
  default: '^\(To\|Cc\|Bcc\|From\|Reply-To\):'

g:qcc_multiline

  Whether to try matching g:qcc_pattern against the current
  and any previous line
  default: 0

g:qcc_multiline_pattern

  Pattern to match against the current line when deciding
  wether to keep looking for a line that matches g:qcc_pattern
  This provides finer control over the recursion, which
  is useful if calling the completion on really big files.
  default: '.*'

g:qcc_format_word

  Format string to be used when building the word field
  of the completion (i.e.: the final result, what gets fed into
  the current line when you select an option)
  default: '${1} <${0}>' (as in: FirstName <email@domain.com>)

g:qcc_format_abbr

  Format string to be used when building the abbreviation
  for the completion menu (i.e.: the first row in the completion
  menu).
  default: '${1}'

g:qcc_format_menu

  Format string for the optional second column of the completion
  menu.
  default: '${2}'