fixed doc markup (closes #1106)