Line breaks in argument lists

[harpolea]

We've been using breathe to generate documentation for our C++ code, Castro (which works great by the way - thank you!). However, we have a number of functions with fairly long, complex argument lists which are quite difficult to read (e.g. see this example).

We were wondering if there was a way we could tell breathe to e.g. split argument lists so that each argument was on a new line, or to tell it to not split individual arguments across lines? If not, then is this a feature that could be added?

Thanks!

[jakobandersen]

That is indeed difficult to read, and in the end there probably need to be some changes in Breathe as well, but the main issue is with the capabilities of Sphinx. See sphinx-doc/sphinx#1514 (and related linked issues) for discussions.

[leofang]

Q: Is there any update on this?

While the upstream added the maximum_signature_line_length option in v7.1, it doesn't work very well in our project and we had to resort to custom css as suggested here before the upstream fix landed. However, it only works for the cpp domain and not the c domain, for which sig-param items are not generated in the htmls. Any suggestion to move forward?