fix some documentation issues (fixes #313)