Custom Doxyfile options with rosdoc_lite

edit

The rosdoc_lite package aims to provide a simple, generic interface that can automatically generate documentation for the ROS wiki. As such, it does not support full customization, which would be hard for the build farm to handle, because it does not know what additional documentation packages might be needed.

There has been some discussion of adding a <doc_depend> tag to a future package.xml format, which might help with this eventually.

The usual recommendation for those with specialized documentation requirements is to use Doxygen directly and generate their documentation manually.

If you have specific options you would like to add for the Doxygen builder, you can submit a pull request. But, please avoid adding additional documentation package dependencies and breaking the build farm. I suppose we could add another package dependency to all the doc build jobs, but would need to anticipate reasonably widespread use to justify doing that.

I have never used doxypy. Most ROS Python packages use sphinx or epydoc, which are supported by rosdoc_lite. For most Python documentation tasks, my personal preference is sphinx.