Various documentation markup fixes

Signed-off-by: Michal Čihař <michal@cihar.com>