Fix typo and ReST syntaxs.
re-format list and inline comments.
inline comment to code highlight.