Fix docstrings so that the build with the chosen tool runs without errors or warnings.

[CSchoel]

Although I haven't tried it, I'm pretty sure that the docs are currently broken after merging #67.

• Run docs build.
• Fix errors.
• Fix warnings.