API-doc formatting.
Fix a few typos in the documentation.
Merge pull request #198 from jomue/doc-improvements

Fix a few typos in the documentation.
API docs for code example improved.
Fix API docs.