Added README and more help texts

mbrochh · mbrochh · commit e5426620bae2 · 2012-06-09T22:51:40.000+08:00
diff --git a/.vimrc b/.vimrc
@@ -1,6 +1,5 @@
 " Sample .vimrc file by Martin Brochhaus
 " Presented at PyCon APAC 2012
-" Slides: TODO
 
 
 " ============================================
@@ -14,6 +13,9 @@
 
 
 " Better copy & paste
+" When you want to paste large blocks of code into vim, press F2 before you
+" paste. At the bottom you should see ``-- INSERT (paste) --``.
+
 "" set pastetoggle=<F2>
 "" set clipboard=unnamed
 
@@ -24,11 +26,14 @@
 
 
 " Rebind <Leader> key
+" I like to have it here becuase it is easier to reach than the default and
+" it is next to ``m`` and ``n`` which I use for navigating between tabs.
 "" let mapleader = ","
 
 
 " Bind nohl
 " Removes highlight of your last search
+" ``<C>`` stands for ``CTRL`` and therefore ``<C-n>`` stands for ``CTRL+n``
 "" noremap <C-n> :nohl<CR>
 "" vnoremap <C-n> :nohl<CR>
 "" inoremap <C-n> :nohl<CR>
@@ -46,6 +51,7 @@
 
 
 " bind Ctrl+<movement> keys to move around the windows, instead of using Ctrl+w + <movement>
+" Every unnecessary keystroke that can be saved is good for your health :)
 "" map <c-j> <c-w>j
 "" map <c-k> <c-w>k
 "" map <c-l> <c-w>l
@@ -62,6 +68,8 @@
 
 
 " easier moving of code blocks
+" Try to go into visual mode (v), thenselect several lines of code here and
+" then press ``>`` several times.
 "" vnoremap < <gv  " better indentation
 "" vnoremap > >gv  " better indentation
 
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 This is the code for my PyCon APAC 2012 talk about Vim as Python IDE.
 
-You can find the slides here: TODO
+You can find the slides as a PDF in this repository.
 
 If you want to start using Vim for the first time, have a look at the
 ``.vimrc`` file in this repository and gradually uncomment everything.
