This PR fixes some issues caused by the bad format in source code comments
that confuse the reference generator. Problems are related to the use of
`*` in comment text as literal string rather than emphasis.
There are some format problems in the generated reference. These
problems aren't easy to solve if not fixing the format of the upstream
source code comments. This PR fixes them manually.
Qiming Teng