Fix a typo in the CONTRIBUTING file
Depend on python 2.7 explicitely.

Otherwise this can install the virtualenv with python 3.X.
Add a "clean" makefile directive.
Add some code documentation and fix a few typos.
Merge pull request #300 from ametaireau/minor-fixes

Minor fixes