X-Git-Url: https://ruderich.org/simon/gitweb/?a=blobdiff_plain;f=vimrc;h=a3c95d338226cc406c55ab9cae8375e983687de6;hb=c8549a38306000d76450d02f220c322117e62ba7;hp=def6a81bad34595249a8e7391cc4376e8a12a1e5;hpb=968d403e6cfc998acca82ff8ba2feadf62e967bd;p=config%2Fdotfiles.git

diff --git a/vimrc b/vimrc
index def6a81..a3c95d3 100644
--- a/vimrc
+++ b/vimrc
@@ -22,7 +22,7 @@ set wildmode=longest,list
 
 " EDIT SETTINGS
 
-" Enable automatic file detection, plugin and indention.
+" Enable automatic file detection, plugin and indention support.
 if has('autocmd')
     filetype plugin indent on
 endif
@@ -38,7 +38,7 @@ set textwidth=78
 set shiftwidth=4
 set softtabstop=4
 set expandtab
-" When < and > is used indent/deindent to the next shiftwidth boundary.
+" When < and > is used indent/deindent to the next 'shiftwidth' boundary.
 set shiftround
 " Use the default value for real tabs.
 set tabstop=8
@@ -86,16 +86,18 @@ if v:version >= 700 && !&diff
     set spelllang=en_us
 endif
 
-" Allow buffers with changes to be hidden.
+" Allow buffers with changes to be hidden. Very important for effective
+" editing with multiple buffers.
 set hidden
 
 
 " DISPLAY SETTINGS
 
-" Use a dark background.
+" Use a dark background. Doesn't change the background color, only sets text
+" colors for a dark terminal.
 set background=dark
 
-" Activate lines display.
+" Display line numbers.
 set number
 " Display the ruler with current line/file position.
 set ruler
@@ -134,7 +136,8 @@ nnoremap <Leader>8 :8b<CR>
 nnoremap <Leader>9 :9b<CR>
 nnoremap <Leader>0 :10b<CR>
 
-" Maps to change spell language between English and German and disable it.
+" Maps to change spell language between English and German and disable spell
+" checking.
 if v:version >= 700
     map <Leader>sn :set nospell<CR>
     map <Leader>se :set spell spelllang=en_us<CR>
@@ -192,8 +195,9 @@ endif
 if has('syntax')
     syntax enable
 
-" Highlight text longer then 78 characters. Thanks to Tony Mechelynck
+" Highlight lines longer than 78 characters. Thanks to Tony Mechelynck
 " <antoine.mechelynck@gmail.com> from the Vim mailing list.
+" It can easily be disabled if necessary with :2match (in Vim >= 700).
     if v:version >= 700
         2match Todo /\%>78v./
     else
@@ -253,7 +257,7 @@ if has('autocmd')
 
 " FTDETECT AUTO COMMANDS
 
-" Recognize .md as markdown files.
+" Recognize .md as markdown files (Vim default is .mkd).
         autocmd BufRead,BufNewFile *.md set filetype=mkd
 " Recognize .test as Tcl files.
         autocmd BufRead,BufNewFile *.test set filetype=tcl