Math formulas are not correctly displayed in Doxygen documentation

[traversaro]

Describe the bug
Math documentation in http://www.yarp.it/git-master/classyarp_1_1dev_1_1IOrientationSensors.html#adb2a40d03c747aa9c8b7fc542f193fd9 is not correctly render, probably due to some missing option passed to doxygen during the generation process.

To Reproduce
Visit http://www.yarp.it/git-master/classyarp_1_1dev_1_1IOrientationSensors.html#adb2a40d03c747aa9c8b7fc542f193fd9 and see raw latex formulas .

Expected behavior
The math formula rendered, see http://mathb.in/48272 .

Configuration (please complete the following information):

• OS: Windows
• yarp version: Not Relevant
• compiler: Not Relevant

[traversaro]

cc @Nicogene

[PeterBowman]

One way to handle this is through Doxygen's CITE_BIB_FILES property: inline comment, HTML+LaTeX render. I'd suggest to take advantage of the modern FindDoxygen module which takes care of generating a Doxyfile from CMake configuration and creating a new target that calls doxygen to parse it: example. That is, no more Doxyfile.in.

Edit: ouch, sorry, CITE_BIB_FILES is obviously meant for citations... Anyway, I wanted to point out that this configuration produces correct LaTeX output in one way or another, I just had to increase the font size to make formulae more readable.

[traversaro]

Thanks for chiming in @PeterBowman !

[drdanz]

I believe this could be due to some missing latex package in the documentation build environment, I'll move this to the robotology/yarp-documentation repository...