Re: [PATCH v3 0/1] Compactly make code examples into literal blocks

[Jonathan Corbet]

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