]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
docs: kdoc: remove support for an external kernel-doc from sphinx
authorJonathan Corbet <corbet@lwn.net>
Mon, 19 Jan 2026 12:05:00 +0000 (13:05 +0100)
committerJonathan Corbet <corbet@lwn.net>
Tue, 20 Jan 2026 22:31:06 +0000 (15:31 -0700)
commit24f984aa117f376b237e7b78a760dbda20383a0d
tree0083f7621e67719d5d0d958b0b25d8333ed83c0e
parent6cc45ee5df3bd89c8fa62aa2be91f747938686a1
docs: kdoc: remove support for an external kernel-doc from sphinx

The ability to build the docs with an external kernel-doc program involves
some truly confusing logic and complicates the task of moving kernel-doc
out of scripts/.  But this feature is not useful for normal documentation
builds, and the external kernel-doc can always be run by hand when it needs
debugging.  So just remove that feature and make life easier.

There is still a bunch of logic to build a command line that we never use;
the idea is to be able to output it, but I'm not sure if that is worth
keeping.

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <a97a8361546648906344457a7e92e4db533048a9.1768823489.git.mchehab+huawei@kernel.org>
Documentation/sphinx/kerneldoc.py