On Mon, 30 Mar 2020 23:29:24 +0100 Peter Lister <peter@xxxxxxxxxxxxxxxxxxxxxxxx> wrote: One quick thing caught my eye... > One head-on approachis to literalise *all* kerneldoc comments for > functions and structures. The kerneldoc keywords then serve only to > generate links; the ReST output is minimal but guaranteed validand > warning free. Would any readers of API docs be inconvenienced? The > target readership are presumably programmers, and the searchability of > the sphinx RTD is more useful to me than the formatting. The ability to put formatting directive into kerneldoc comments was one of the driving forces that pushed the RST switch in the first place. There are subsystems that make use of this capability and would not be pleased to see it go away. jon
