The doxygen configuration should include more file types that can be used by the `\snippet` command

[azeey]

Desired behavior

The EXAMPLE_PATTERN (

gz-cmake/doc/doxygen/api.in

Line 904 in 200de1b

EXAMPLE_PATTERNS = *.cc \

) in the doxygen configuration is limited to C++ and CMake files. It would be great if other types (eg. .proto, .py, .rb, .sdf, CMakeList.txt) were supported. This would allow us to use the \include or \snippet commands in our documentation instead of duplicating code from examples.

[peci1]

Is there something non-trivial to be done for this to work?

I tried adding *.sdf to EXAMPLE_PATTERNS and referenced a file with:

    <!-- [render_engine_def] -->
    <plugin
      filename="gz-sim-sensors-system"
      name="gz::sim::systems::Sensors">
      <render_engine>ogre2</render_engine>
    </plugin>
    <!-- [render_engine_def] -->

But the snippet generated in docs is empty.