SuperTab

Ⅰ. 插件描述

Perform all your vim insert mode completions with Tab

Ⅱ. 基本信息

创建日期：  2006-08-30
使用用户：  10497
Github星：  2752
插件作者：  Eric Van Dewoestine

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加: 
Plugin 'ervandew/supertab'
… 然后在Vim中运行以下命令: 
:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加: 
NeoBundle 'ervandew/supertab'
… 然后在Vim中运行以下命令: 
:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加: 
Plug 'ervandew/supertab'
… 然后在Vim中运行以下命令: 
:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令: 
cd ~/.vim/bundle
git clone https://github.com/ervandew/supertab

Ⅳ. 文档说明

.. Copyright (c) 2012 - 2017, Eric Van Dewoestine
All rights reserved.

Redistribution and use of this software in source and binary forms, with
or without modification, are permitted provided that the following
conditions are met:

  • Redistributions of source code must retain the above
    copyright notice, this list of conditions and the
    following disclaimer.
  • Redistributions in binary form must reproduce the above
    copyright notice, this list of conditions and the
    following disclaimer in the documentation and/or other
    materials provided with the distribution.
  • Neither the name of Eric Van Dewoestine nor the names of its
    contributors may be used to endorse or promote products derived from
    this software without specific prior written permission of
    Eric Van Dewoestine.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

.. _overview:

==================

Overview

Supertab is a vim plugin which allows you to use <Tab> for all your insert
completion needs (:help ins-completion).

Features

  • Configurable to suit your needs:

    • Default completion type to use.
    • Prevent <Tab> from completing after/before defined patterns.
    • Close vim's completion preview window when code completion is finished.
    • When using other completion types, you can configure how long to 'remember'
      the current completion type before returning to the default.
    • Don't like using <Tab>? You can also configure a different pair of keys to
      scroll forwards and backwards through completion results.
  • Optional improved 'longest' completion support (after typing some characters,
    hitting <Tab> will highlight the next longest match).

  • Built in 'context' completion option which chooses the appropriate completion
    type based on the text preceding the cursor.

    • You can also plug in your own functions to determine which completion type
      to use.
  • Support for simple completion chaining (falling back to a different
    completion type, keyword completion for example, if omni or user completion

returns no results).

Installation

You have a few options when it comes to installing supertab:

  1. Use your linux package manager:

Some linux distributions include a supertab package so you don't have to
manage the install/upgrade of supertab separately from other software on your
system.

  1. Use a vim plugin manager:

There are several plugin managers for vim, which will either allow you to
manually clone vim plugin repositories, or will do so for you. Probably the
two most popular ones currently are `pathogen
https://github.com/tpope/vim-pathogen_ and vundle
https://github.com/gmarik/Vundle.vim`_. Please refer to their docs for
instructions on how to install plugins.

  1. And lastly you can use the vimball (.vmb) file found on
    vim.org <http://www.vim.org/scripts/script.php?script_id=1643>_:

Vimball files are installed by simply opening them in vim and then sourcing
the file:

::

 $ vim supertab.vmb
 :source %

Documentation

You can access the supertab documentation from within vim using the following
command:

::

:help supertab

You can also view the text file on
github <https://github.com/ervandew/supertab/blob/master/doc/supertab.txt>_.

Frequently Asked Questions

  • Why isn't anything happening when I hit <tab>?

First make sure you properly installed supertab and that you have plugin
support enabled in vim. You can run the following in vim to check that
supertab was loaded:

::

:scriptnames

Next make sure that the supertab insert mapping exists. It's possible some
other plugin could have overridden the mapping. You can check this by running
the following in vim, which would show that it's mapped to SuperTabForward:

::

:verbose imap <tab>

If supertab has been loaded and the insert mapping looks correct, make sure
you don't have the paste option enabled in your vimrc or elsewhere. When
that option is enabled, all insert mappings are disabled. You can run the
following command in vim to check if and where that option was set:

::

:verbose set paste?
  • **Why isn't supertab honoring my configured settings (attempts to complete at the
    start of a line, always performs keyword completion instead of my configured

default, etc.)?**

Chances are that you have a very old version of `snipmate
https://github.com/msanders/snipmate.vim`_ installed, or something similar,
which will issue a <c-n> when no snippet is found. Supertab use to map to
<c-n>, so this behavior would act as a fallback to supertab, but current
versions of supertab no longer do so, resulting in snipmate bypassing supertab
entirely.

You can check if this is the case by running the following in vim to see what
is mapped to <tab>:

::

:verbose imap <tab>

To resolve the issue you can either:

#. Install my fork <https://github.com/ervandew/snipmate.vim>_ or
#. Upgrade to a more recent snipmate fork, like `garbas/vim-snipmate

 <https://github.com/garbas/vim-snipmate>`_

See #74 <https://github.com/ervandew/supertab/issues/74>_ for additional
details.

  • Why does <tab> navigate the completion menu from bottom to top?

First, if after reading the explanation below (or if you don't want to bother
reading it), you still want the default to scroll down the list then you can
use:

::

let g:SuperTabDefaultCompletionType = "<c-n>"

or if your default completion type is currently context then you can use
this instead:

::

let g:SuperTabContextDefaultCompletionType = "<c-n>"

Now on to the reasoning behind this. When using <c-p> or <c-n> to start
insert completion, both populate the completion popup with the same list of
words in the same order, the only difference is that <c-p> highlights the
nearest matching word located above the current cursor position, which is the
result at the bottom of the completion popup. Without supertab installed,
continuing to hit <c-p> will walk up the list to next nearest word above the
cursor.

I think Bram chose to display the results like this so that

#. the completion logic is the same for <c-n> and <c-p>, only the first

 entry to highlight differs

#. so that the behavior of <c-p> mode is consistent, always moving up the

 list and

#. when starting <c-p> mode you don't have to switch over to

 using `<c-n>` to get the next nearest entry, just continue to hit `<c-p>`.

So, with supertab I wanted to preserve the same behavior. If <c-p> is your
default completion method (supertab defaults to this being the case), then
<tab> will start it and additional uses of <tab> will move up the list
instead of down so that you don't have to suddenly switch to using <s-tab>
to get the next nearest result.

Why is <c-p> the supertab default? The original supertab author found (and I
agree with his finding) that while coding, the keyword match you want is
typically the closer of the matches above the cursor, which <c-p> naturally
provides.

添加新评论