doc: fix markups for reference manual