ROS Resources: Documentation | Support | Discussion Forum | Index | Service Status | ros @ Robotics Stack Exchange
Ask Your Question

Revision history [back]

click to hide/show revision 1
initial version

answered 2014-04-18 05:53:18 -0500

joq gravatar image

The rosdoc_lite script does not attempt to provide all the features of every documentation builder. It merely provides a useful subset that can be run automatically on the ROS build farm.

The usual recommendation for those with complex documentation schemes is to use Doxygen (or Sphinx or Epydoc) directly, generating the docs yourself.

The Doxygen builder does provide a set of tags that you can modify. I don't see PREDEFINED in that list, but perhaps it could be added.

If you want to try doing that, please open an enhancement issue with a link to this question, and provide a pull request, if possible.

The rosdoc_lite script does not attempt to provide all the features of every documentation builder. It merely provides a useful subset that can be run automatically on the ROS build farm.

The usual recommendation for those with complex documentation schemes is to use Doxygen (or Sphinx or Epydoc) directly, generating the docs yourself.

The Doxygen builder does provide a set of tags that you can modify. I don't see PREDEFINED in that list, but perhaps it could be added.

If you want to try doing that, please open an enhancement issue with a link to this question, and provide a pull request, if possible.

Update: Fabien provided his requested enhancement. It is now released to Groovy, Hydro and Indigo. See: ros-infrastructure/rosdoc_lite#47.

Thanks for contributing!