A special doxygen command was made to be able to embed restructured text in Doxygen comments.
* @rst
* write your rst code here such as references: `link to chapter introduction <C_intro>`_
* @rst
Note that the leading asterisk is mandatory for this command to work. See aoclda-handle.h for an example.