Merge branch 'add-more-comments' into 'master'

Add some more comments and update README

See merge request !17

README.md

@@ -7,7 +7,7 @@
 
 ## Install packages we need...
 
-	pacman -S vim-airline vim-fugitive vim-gitgutter vim-neocomplete vim-securemodelines vim-syntastic
+	pacman -S powerline-fonts vim-airline vim-fugitive vim-gitgutter vim-neocomplete vim-securemodelines vim-syntastic
 
 
 ## Set your terminal font to...

vimrc

@@ -30,26 +30,38 @@ set tabstop=4                           " number of visual spaces per TAB
 set title                               " set the window's title, reflecting the file currently being edited
 set ttimeoutlen=500                     " wait up to 500ms for key sequences to complete
 
+"
+" Highlight colors
+" https://vim.fandom.com/wiki/Xterm256_color_names_for_console_Vim
+"
+
 " Set autocomplete menu colors
+" grey89 / grey7
 highlight Pmenu ctermfg=254 ctermbg=233
+" grey7 / grey89
 highlight PmenuSel cterm=bold ctermfg=233 ctermbg=254
 
 " Set search background
+" lightgoldenrod2 / red3
 highlight search cterm=bold ctermbg=222 ctermfg=160
 
 " Set color of cursor column
+" grey27
 highlight CursorColumn ctermbg=238
 
 " Set color of end of line for programming
+" grey27
 highlight ColorColumn ctermbg=238
 
 " Highlight line we're on
+" grey15
 highlight CursorLine cterm=none ctermbg=235
 
 " Highlight messed up tab/spaces
+" orangered1
 highlight ExtraWhitespaces ctermbg=202
 
-" Switch whitespace handling based on file type
+" Switch whitespace handling based on file type {
 function! WhitespaceHighlight()
   if &filetype == 'python'
     call matchadd('ExtraWhitespaces','^\t')
@@ -66,13 +78,15 @@ function! WhitespaceHighlight()
   endif
   call matchadd('ExtraWhitespaces','\s\+$')
 endfunction
+" }
 
-" Autocmd
+" Set file type detection
 au BufNewFile,BufRead * call WhitespaceHighlight()
-au BufNewFile,BufRead *.sls set filetype=python | set expandtab softtabstop=4 | call WhitespaceHighlight()
-au BufNewFile,BufRead *.md set filetype=markdown | call WhitespaceHighlight()
 au BufNewFile,BufRead *.html.ep set filetype=php | call WhitespaceHighlight()
+au BufNewFile,BufRead *.md set filetype=markdown | call WhitespaceHighlight()
+" Convert tabs to spaces, a tab is converted to 4 spaces
 au BufNewFile,BufRead *.py set filetype=python | set expandtab softtabstop=4 | call WhitespaceHighlight()
+au BufNewFile,BufRead *.sls set filetype=python | set expandtab softtabstop=4 | call WhitespaceHighlight()
 
 "
 " Plugin configuration