Correct JavaDoc.
Cleanup the formatting of the module.

We also add some tests to check it's formatted half sensibly.