#103 Keep or remove doctests?

[Nicolas Hainaux]

Doctests are nice, but the tests are then scattered between source files and test files;
Keep them or remove them? (Then don't mention them anymore in the documentation)