vimrc: update comments

diff --git a/vimrc b/vimrc
index 64a622595dc9da1bc5bdd76f813e044423b05735..63741d7899f8f1fded8744a21c0d05125a29b570 100644 (file)
--- a/vimrc
+++ b/vimrc
@@ -164,7 +164,8 @@ endif
 " existing files.
 set fileencodings=utf-8,latin1
 
-" Always use unix line-endings for new files.
+" Always use unix line-endings for new files. DOS line endings in existing
+" files are recognized.
 set fileformats=unix,dos
 
 " Wrap text after 78 characters.
@@ -263,7 +264,7 @@ set number
 if exists('+numberwidth')
     set numberwidth=1
 endif
-" Display the ruler with current line/file position. If 'statusline' is used
+" Display the ruler with current line/file position. If 'statusline' is used,
 " then this only affects <C-G>.
 set ruler
 " Display partial commands in the status line.
@@ -824,7 +825,7 @@ if has('syntax')
 " Highlight some important keywords in all documents.
             let l:todos = ['TODO', 'XXX', 'FIXME', 'NOTE',
                          \ 'CHANGED', 'REMOVED', 'DELETED']
-            " Compatibility fix for Vim 6.4 which can't handle for in function
+            " Compatibility fix for Vim 6.4 which can't parse for in functions
             " (without function it's ignored).
             execute '  for l:x in l:todos'
                   \ '|     call matchadd("Todo", l:x)'
@@ -861,32 +862,32 @@ if has('syntax')
 
     " C
     let g:c_no_if0_fold = 1 " fix weird double fold in #if0 in recent versions
-    " Haskell.
+    " Haskell
     let g:hs_highlight_delimiters = 1
     let g:hs_highlight_boolean = 1
     let g:hs_highlight_types = 1
     let g:hs_highlight_more_types = 1
-    " Java.
+    " Java
     let g:java_highlight_java_lang_ids = 1 " color java.lang.* identifiers
-    " Perl.
+    " Perl
     let g:perl_fold = 1
     let g:perl_fold_blocks = 1
     let g:perl_nofold_packages = 1
     let g:perl_include_pod = 1 " syntax coloring for PODs
-    " PHP.
+    " PHP
     let g:php_folding = 3    " fold functions
     let g:php_short_tags = 0 " no short tags (<? .. ?>), not always usable
     let g:php_sql_query = 1  " highlight SQL queries in strings
-    " Python.
+    " Python
     let g:python_highlight_all = 1
-    " Shell.
+    " Shell
     let g:sh_noisk = 1        " don't add . to 'iskeyword'
     let g:sh_is_posix = 1     " POSIX shell (e.g. dash) is compatible enough
     let g:sh_fold_enabled = 7 " functions (1), heredoc (2) and if/do/for (4)
-    " Vim.
+    " Vim
     let g:vimsyn_embed = 0      " don't highlight embedded languages
     let g:vimsyn_folding = 'af' " folding for autogroups (a) and functions (f)
-    " XML.
+    " XML
     let g:xml_syntax_folding = 1
 endif
 
@@ -961,7 +962,7 @@ endif
 " AUTO COMMANDS
 
 " Use a custom auto group to prevent problems when the vimrc files is sourced
-" twice.
+" multiple times.
 if has('autocmd')
     augroup vimrc
 
@@ -1044,8 +1045,7 @@ if has('autocmd')
         autocmd FileType gitcommit let g:secure_modelines_allowed_items = [] |
                                  \ setlocal textwidth=72
 " Fix 'include' setting for shell files to recognize '.' and 'source'
-" commands. Use &l:include instead of setlocal which requires excessive
-" escaping of \.
+" commands.
         autocmd FileType sh let &l:include = '^\s*\(\.\|source\)\s\+'
 " Use the same comment string as for Vim files in Vimperator files.
         autocmd FileType vimperator setlocal commentstring=\"%s