docs: improve the HTML formatting of kerneldoc comments
authorJonathan Corbet <corbet@lwn.net>
Fri, 30 Sep 2022 17:52:09 +0000 (11:52 -0600)
committerJonathan Corbet <corbet@lwn.net>
Tue, 18 Oct 2022 22:29:29 +0000 (16:29 -0600)
commiteaf710ceb5ae284778a87c0d0f2348c19e3e4751
tree1629c8c63da18b4bd5260c6b4e5ab530078b5eaf
parentdf19817f3ff3de28e87139b6d172c0094402e1f2
docs: improve the HTML formatting of kerneldoc comments

Make a few changes to cause functions documented by kerneldoc to stand out
better in the rendered documentation.  Specifically, change kernel-doc to
put the description section into a ".. container::" section, then add a bit
of CSS to indent that section relative to the function prototype (or struct
or enum definition).  Tweak a few other CSS parameters while in the
neighborhood to improve the formatting.

Acked-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/sphinx-static/custom.css
scripts/kernel-doc