A Narrow Region Plugin for vim (like Emacs Narrow Region)
VimL Shell Makefile Perl
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
autoload
doc Spelling correction Dec 15, 2015
plugin Allow for :'<,'>NarrowRegion! Apr 20, 2016
test test for issue #47 Jul 25, 2015
.gitignore ignore testfiles May 6, 2015
Makefile add some tests Mar 30, 2015
NrrwRgn.vmb
README.md updated README Mar 28, 2015
post.pl update vim version Apr 22, 2014
screencast.gif
todo.txt add bug description Jun 25, 2015

README.md

NrrwRgn plugin

A Vim plugin for focussing on a selected region

This plugin is inspired by the Narrowing feature of Emacs and means to focus on a selected region while making the rest inaccessible. You simply select the region, call :NR and the selected part will open in a new split window while the rest of the buffer will be protected. Once you are finished, simply write the narrowed window (:w) and all the changes will be moved back to the original buffer.

See also the following screencast, that shows several features available: screencast of the plugin

Installation

Use the plugin manager of your choice. Or download the stable version of the plugin, edit it with Vim (vim NrrwRgn-XXX.vmb) and simply source it (:so %). Restart and take a look at the help (:h NrrwRgn.txt)

Usage

Once installed, take a look at the help at :h NrrwRgn

Here is a short overview of the functionality provided by the plugin:

Ex commands:

:NR      - Open the selected region in a new narrowed window
:NW      - Open the current visual window in a new narrowed window
:WidenRegion - (In the narrowed window) write the changes back to the original buffer.
:NRV     - Open the narrowed window for the region that was last visually selected.
:NUD     - (In a unified diff) open the selected diff in 2 Narrowed windows
:NRP     - Mark a region for a Multi narrowed window
:NRM     - Create a new Multi narrowed window (after :NRP)
:NRS     - Enable Syncing the buffer content back (default on)
:NRN     - Disable Syncing the buffer content back
:NRL     - Reselect the last selected region and open it again in a narrowed window

Visual mode commands:

<Leader>nr       - Open the current visual selection in a new narrowed window

Scripting Functions:

nrrwrgn#NrrwRgnStatus()   - Return a dict with all the status information for the current window

Attention

:NRM is currently experimental

Similar Work

Andreas Politz' narrow_region
Kana Natsunos narrow
Jonas Kramers narrow
Marcin Szamotulskis ViewPort

License & Copyright

© 2009-2014 by Christian Brabandt. The Vim License applies. See :h license

NO WARRANTY, EXPRESS OR IMPLIED. USE AT-YOUR-OWN-RISK