On Fri, Sep 04, 2020 at 10:29:25AM -0600, Jonathan Corbet wrote: > +# cdomain is badly broken in Sphinx 3+. Leaving it out generates *most* > +# of the docs correctly, but not all. Scream bloody murder but allow > +# the process to proceed; hopefully somebody will fix this properly soon. > +# > +if major >= 3: > + sys.stderr.write('''WARNING: The kernel documentation build process > + does not work correctly with Sphinx v3.0 and above. Expect errors > + in the generated output. Should we be converting the kernel-doc script to output 3.0-style markup for structs? https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#c-roles