Use doctest for testing the interface

[jwg4]

Make at least some doctest tests which provide an example of how the library should be used.
fn and calendars are ideal places for this to happen, and perhaps dates

[jwg4]

See https://docs.python.org/2/library/doctest.html#simple-usage-checking-examples-in-a-text-file