Cleanup

vimrc

@@ -16,6 +16,8 @@
 "###################################################################################################
 
 scriptencoding utf-8
+" @note If the file contains a BOM then vim will automatically set `bomb` for
+" the buffer so that the BOM is written out again.
 set encoding=utf-8 fileencoding=utf-8 fileencodings=ucs-bom,utf8,prc
 set nocompatible
 filetype off
@@ -647,6 +649,8 @@ function! DoSingleWriteThenQuit()
     quit
 endfunction
 
+" @fixme Sometimes a :wa that saves multiple files causes vim to hang and use
+" a lot of CPU.
 function! DoMultiWrite()
     let l:current_buffer = bufnr("%")
     bufdo wa