Fix errors in docs.

Errors in processing special characters and one missing file ref.
Docs build cleanly now with no errors.
Merge pull request #808 from hagberg/doc-fixes

Fix errors in docs.