* Fix \file references in doxygen markup

* Fix various "end of ..." warnings from doxygen.

This addresses warnings like:

- end of comment block while expecting command </b>
- end of comment block while expecting command </em>
- end of comment block while expecting command </pre>
- end of comment block while expecting command </s>
- end of comment block while expecting command </sup>
- end of comment block while expecting command </tt>
- end of comment block while expecting command </u>
- end of list marker found without any preceding list items
- found </em> tag without matching <em>
- found </li> tag without matching <li>
- found </pre> tag without matching <pre>
- found </sub> tag while expecting </sup>
- found </sup> tag without matching <sup>
- found </tt> tag without matching <tt>
- found </ul> tag without matching <ul>
- illegal </br> tag found
- reached end of file while inside a 'code' block!
- reached end of file while still inside a (nested) comment.
- unexpected end of comment while inside <a href=...> tag
- unexpected end of comment while inside <ul> block
- unexpected html tag <blockquote> found within <h1> context
- unexpected tag </h2> found
- unexpected tag </h3> found
- unsupported xml/html tag <it> found
- unsupported xml/html tag </it> found

* Adjust parameter names in doxygen markup so they match the code

Addresses warnings:

argument '<name>' of command @param is not found in the argument list
of <function>.

* Add missing underscore

* Make the name of macro match the filename

Fixes:

warning: Failed to call `rs302_JeffreysPriorDemo()` to execute the macro.
Add this function or rename the macro. Falling back to `.L`.

* Remove random control character in documentation file

* Remove /** comments */ from md files

* Fix a shadow warning.

Co-authored-by: Stephan Hageboeck <stephan.hageboeck@cern.ch>