/vim-sensible

sensible.vim: Defaults everyone can agree on

Primary LanguageVim Script

sensible.vim

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

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

Installation

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

mkdir -p ~/.vim/pack/tpope/start
cd ~/.vim/pack/tpope/start
git clone https://tpope.io/vim/sensible.git

Features

See the source for the authoritative list of features. (Don't worry, it's mostly :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 pressing u.
  • runtime! macros/matchit.vim: Load the version of matchit.vim that ships with Vim.

FAQ

How can I see what this plugin actually does?

The source is authoritative. Use :help 'option' to see the documentation for an option. If you install scriptease.vim, you can press K 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 to override (although you could use after/plugin/sensible.vim). If you want to load it earlier, add the following line to your vimrc, then put your overrides below.

runtime! plugin/sensible.vim

Feel free to let me know which setting you object to, so I can reassess whether it makes sense to include it.

Contributing

I want this to be a plugin nobody objects to installing. Let me know if you have any objections to anything. There are a handful of settings I figured might be controversial, but I included anyways, just to settle the question once and for all. It won't take much persuasion 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 I haven't put much effort into documenting that.

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

Self-Promotion

Like sensible.vim? Follow the repository on GitHub and vote for it on vim.org. And if you're feeling especially charitable, follow tpope on Twitter and GitHub.

This pairs great with sleuth.vim.

License

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