From: Simon Ruderich <simon@ruderich.org>
Date: Sun, 7 Oct 2012 23:26:52 +0000 (+0200)
Subject: vimrc: Minor documentation updates.
X-Git-Url: https://ruderich.org/simon/gitweb/?a=commitdiff_plain;h=30b641a798b3b6d13784d4c1ef744ddeca2091f4;hp=6f4bf58f56c240a42c9ee3e8755ea1cb6748d000;p=config%2Fdotfiles.git

vimrc: Minor documentation updates.
---

diff --git a/vimrc b/vimrc
index 48f52f3..58f8255 100644
--- a/vimrc
+++ b/vimrc
@@ -75,13 +75,15 @@ if exists('+completeopt')
     set completeopt+=menuone
 endif
 
-" Increase history of executed commands (:).
+" Increase history of executed commands (:) and search patterns (/).
 set history=1000
 
 " Increase number of possible undos.
 set undolevels=1000
 
-" Remember marks (including the last cursor position) for more files.
+" Remember marks (including the last cursor position) for more files. ^= is
+" necessary because 'viminfo' is parsed from the beginning and the first match
+" is used.
 if has('viminfo')
     set viminfo^='1000
 endif
@@ -92,7 +94,7 @@ if exists('+cryptmethod')
 endif
 
 " Clear all vimrc-related autocmds. Has to be done here as the vimrc augroup
-" is used multiple times.
+" is used multiple times. Necessary to support reloading the vimrc.
 if has('autocmd')
     augroup vimrc
         autocmd!
@@ -175,7 +177,7 @@ endif
 set virtualedit=block
 
 " Already display matches while typing the search command. This makes spotting
-" errors easy.
+" typos easy and searching faster.
 set incsearch
 
 " Activate syntax folding.
@@ -205,7 +207,7 @@ endif
 
 " Allow buffers with changes to be hidden. Very important for effective
 " editing with multiple buffers. Prevents the "E37: No write since last change
-" (add ! to override)" warning.
+" (add ! to override)" warning when switching buffers.
 set hidden