Repository files navigation

Think of sensible.vim as one step above'nocompatible' mode: a universalset of defaults that (hopefully) everyone can agree on.

• If you're new to Vim, you can install this as a starting point, rather thancopying some random vimrc you found.
• If you're pair programming and you can't agree on whose vimrc to use, thiscan be your neutral territory.
• If you're administrating a server with an account that's not exclusivelyyours, you canscp this up to make things a bit more tolerable.
• If you're troubleshooting a plugin and need to rule out interference fromyour vimrc, having this installed will ensure you still have some basicamenities.

Install using your favorite package manager, or use Vim's built-in packagesupport:

mkdir -p ~/.vim/pack/tpope/startcd ~/.vim/pack/tpope/startgit clone https://tpope.io/vim/sensible.git

See thesource for the authoritative list of features. (Don't worry, it'smostly:set calls.) Here's a taste:

• 'backspace': Backspace through anything in insert mode.
• 'incsearch': Start searching before pressing enter.
• 'listchars': Makes:set list (visible whitespace) prettier.
• 'scrolloff': Always show at least one line above/below the cursor.
• 'autoread': Autoload file changes. You can undo by pressingu.
• runtime! macros/matchit.vim: Load the version of matchit.vim that shipswith Vim.

How can I see what this plugin actually does?

Thesource is authoritative. Use:help 'option' to see thedocumentation for an option. If you installscriptease.vim, you can pressK on an option (or command, or function) to jump to its documentation.

How can I override a setting?

Normally, sensible.vim loads after your vimrc, making it a bit tricky tooverride (although you could useafter/plugin/sensible.vim). If you want toload it earlier, add the following line to your vimrc, then put your overridesbelow.

runtime! plugin/sensible.vim

Feel free tolet me know which setting you object to, so Ican reassess whether it makes sense to include it.

I want this to be a plugin nobody objects to installing.Let meknow if you have any objections toanything. There are ahandful of settings I figuredmight be controversial, but I includedanyways, just to settle the question once and for all. It won't take muchpersuasion for me to remove them. Everything else is negotiable.

Feel free to ask a question if you're not sure why I've set something, as Ihaven't put much effort into documenting that.

I'm a stickler forcommit messages, so if you send me a pull request withso much as a superfluous period in the subject line, I will close it withoutso much as a second thought, and save my precious attention for someone whocan actually follow directions.

Like sensible.vim? Follow the repository onGitHub and vote for it onvim.org. And ifyou're feeling especially charitable, followtpope onTwitter andGitHub.

This pairs great withsleuth.vim.

Copyright © Tim Pope. Distributed under the same terms as Vim itself.See:help license.