Fixes for warnings from doxygen
proper list layout
verbatim around xml examples
escape unknown tag
remove copy/pasted doc for non-existent parameter