Em Sat, 25 Jun 2022 08:12:00 -0700 Randy Dunlap rdunlap@infradead.org escreveu:
So which version of Sphinx are you using? The language argument became optional in 2.0, so you'd need to be running something pretty ancient to see this.
Ah, I see 1.8.5 in your later message...how wedded are you to that version?
It's what ships with OpenSuse Leap 15.3, which I have been using for quite a long time.
I see that there is now OpenSuse Leap 15.4, so I could upgrade to that, but I don't know what version on Sphinx it uses.
It seems that there are two versions on it, packaged with different names:
2.3.1: https://download.opensuse.org/distribution/leap/15.4/repo/oss/noarch/python3... 4.2.0: https://download.opensuse.org/distribution/leap/15.4/repo/oss/noarch/python3...
It should be noticed that, while we don't decide to remove support for Sphinx < 3, kernel-doc has two different outputs, depending on Sphinx C domain support. The legacy support is enabled with version < 3 [1].
As we're currently discussing dropping support for Sphinx version < 3, I would recommend you to use the 4.2 package.
Regards, Mauro
[1] Version 3.0 is a bad choice, as the C domain is partially broken.