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
