Adds informations in the readme and plugin file

Author: inside

README.md

@@ -1,4 +1,37 @@
-vim-grep-operator
-=================
+# The vim grep operator
 
-The vim grep operator inspired by Steve Losh
+## Description
+
+The vim grep operator plugin, inspired by Steve Losh and
+his book: http://learnvimscriptthehardway.stevelosh.com/
+
+This plugin's has 2 goals:
+
+* bring motion and visual selection to the :grep command
+* open the quickfix window on the fly for easy file match navigation
+
+## Installation
+
+Use pathogen or a pathogen compatible plugin manager.
+
+## Suggested ~/.vimrc mappings
+
+    nmap <leader>g <Plug>GrepOperatorOnCurrentDirectory
+    vmap <leader>g <Plug>GrepOperatorOnCurrentDirectory
+    nmap <leader><leader>g <Plug>GrepOperatorWithFilenamePrompt
+    vmap <leader><leader>g <Plug>GrepOperatorWithFilenamePrompt
+
+## Examples
+
+`<leader>giw` will grep the current directory for the word under the cursor and
+open the quickfix window.
+
+`<leader>ga(` will grep for what's inside the parenthesis including the
+parenthesis.
+
+`<leader>gi'` will grep for what's inside the quotes.
+
+Visually select some characters and type `<leader>g`. This will grep for the
+selected text.
+
+You can also be prompted for files to grep by using the `<leader><leader>g` mapping.

plugin/grep-operator.vim

@@ -1,10 +1,7 @@
-" The Grep Operator plugin, inspired by Steve Losh and
-" his book: http://learnvimscriptthehardway.stevelosh.com/
-" Here are example mappings you should put in your .vimrc:
-" nmap <leader>g <Plug>GrepOperatorOnCurrentDirectory
-" vmap <leader>g <Plug>GrepOperatorOnCurrentDirectory
-" nmap <leader><leader>g <Plug>GrepOperatorWithFilenamePrompt
-" vmap <leader><leader>g <Plug>GrepOperatorWithFilenamePrompt
+" File:        grep-operator.vim
+" Maintainer:  Yann Thomas-Gérard <inside at gmail dot com>
+" Version:     0.0.1
+" License:     This file is placed in the public domain.
 
 " Mappings for the current directory grep
 nnoremap