Fix invalid doc comment

The invalid doc comments were exposed by 24b39ce5.
The fix is to properly escaped the `{-` and `-}` in the doc comments.
Some other miscallaneous markup issues are also fixed.