Add package documentation using doctest.

So that the doc is validated using good old

python setup.py test