doc/examples: misc Doxygen markup improvements

Add properly formatted @example tag and fix Doxygen syntax.