sponsor Vim development Vim logo Vim Book Ad

LineComplete : Insert mode completion of entire lines based on looser matching.

 script karma  Rating 2/2, Downloaded by 1139  Comments, bugs, improvements  Vim wiki

created by
Ingo Karkat
 
script type
utility
 
description
DESCRIPTION
The built-in i_CTRL-X_CTRL-L line completion allows to quickly grab entire
lines, but you have to know and type the first characters as a completion
base. That's bad if the start is difficult to type (e.g. because of comment
prefixes) or the key differentiating word only comes late in the line. On the
other hand, any indent is ignored, so you cannot reduce the number of matches
even if you know that the indent of the desired line is the same as the
current one.

This plugin offers an alternative full-line completion that considers any
existing indent, and lifts the restriction that matches must _start_ with the
completion base. Instead, the WORDs of the base can appear anywhere in the
line, with fallbacks allowing other WORDs in between or even the WORDs
appearing anywhere inside the line.

SEE ALSO
- Check out the CompleteHelper.vim plugin page (vimscript #3914) for a full
  list of insert mode completions powered by it.

USAGE
In insert mode, invoke the line completion via CTRL-X l
You can then search forward and backward via CTRL-N / CTRL-P, as usual.

CTRL-X l                Find matches for whole lines that have the same indent
                        as the current line (only if any exists!) and match
                        the text before the cursor (not necessarily at the
                        start), falling back to a match of all WORDs before
                        the cursor (possibly with other text in between each,
                        but still in the given order), first as
                        space-separated WORDs, finally accepting matches
                        anywhere.

                        In contrast, the built-in i_CTRL-X_CTRL-L always
                        ignores the indent. This completion is stricter if
                        indent is given (it must match exactly), but otherwise
                        much more loose, because the completion base need not
                        specify the start of the line.
                        If you don't want the indent restriction, use
                        i_CTRL-U before typing the completion base to clear
                        any indent.

                        Further use of CTRL-X l will copy the line after the
                        one that has been completed.
 
install details
INSTALLATION
This script is packaged as a vimball. If you have the "gunzip" decompressor
in your PATH, simply edit the *.vmb.gz package in Vim; otherwise, decompress
the archive first, e.g. using WinZip. Inside Vim, install by sourcing the
vimball or via the :UseVimball command.
    vim LineComplete*.vmb.gz
    :so %
To uninstall, use the :RmVimball command.

DEPENDENCIES
- Requires Vim 7.0 or higher.
- Requires the CompleteHelper.vim plugin (vimscript #3914).

CONFIGURATION
For a permanent configuration, put the following commands into your vimrc:

Analoguous to the 'complete' option, you can specify which buffers will be
scanned for completion candidates. Currently, '.' (current buffer), 'w'
(buffers from other windows), and 'b' (other listed buffers) are supported.
    let g:LineComplete_complete = '.,w,b'
The global setting can be overridden for a particular buffer
(b:LineComplete_complete).

If you want to use a different mapping, map your keys to the
<Plug>(LineComplete) mapping target _before_ sourcing the script
(e.g. in your vimrc):
    imap <C-x>l <Plug>(LineComplete)
 

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
LineComplete-1.00.vmb.gz 1.00 2014-04-04 7.0 Ingo Karkat Initial upload
ip used for rating: 18.97.9.171

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
   
Vim at Github