More documentation, add doctests
Add documentation about pip
Remove whitespace from setup.py
Add py.test invocation to setup.py

As suggested at http://pytest.org/latest/goodpractises.html