Release preparation

In the run up to releasing this thing to a world of unsuspecting victims
I have begun documenting and reviewing the API. Can it be more, should
it be more than the Java API it sits atop?

Anyway docstrings ahoy for the client module