Customize the order of sections

[tomghuang]

When I use breath with Sphinx, Read the Doc Theme, and Doxygen, I can successfully insert a function API description in my Sphinx-based documentation. However, the sections are in the following order:

• Return
• See
• Note
• Warning
• Parameters

However, I want to organize the sections in the order similar to MSDN documents:

• Parameters
• Return
• Note
• Warning
• See

I tried to find a way to customize the section order, but couldn't find anything. May I know how specify the order of the sections? Thanks.

[vermeeren]

Support for section selecting and section order was recently added for doxygenfile and autodoxygenfile directives in #501 and #509. Documentation for that can be found at https://github.com/michaeljones/breathe/blob/master/documentation/source/file.rst, the RTD docs are currently not up-to-date due to #475.

Something else that may be of use, from https://github.com/michaeljones/breathe/blob/master/documentation/source/directives.rst#config-values, is breathe_order_parameters_first. Full support for section ordering for non-*file directives is not implemented I believe, you could submit a patch for this feature to get it into Breathe.