Add doctest tests for the haddock documentation

Created by: lwm

I already notice that the haddock documentation strings are out of date. They should also be tests. Integration with doctest would be best.