Re: [RFC PATCH 1/2] scripts/kernel-doc: Auto-detect common code-blocks

From: Jonathan Corbet
Date: Thu May 10 2018 - 12:51:15 EST


On Thu, 10 May 2018 09:34:56 -0700
Matthew Wilcox <willy@xxxxxxxxxxxxx> wrote:

> I think this is a bit fragile. Why not just search for ':\n'? Is
> there ever a case where we want to write:
>
> /**
> * foo is a bar:
> * wibble
> */
> and have wibble not be a code-block?

Yeah, we might want to write something like:

- Leading off a bulleted list

1) or a numbered list

for example. That's why I was thinking of looking for explicit markers
for such lists.

It'll take some playing around with to have a hope of getting right,
methinks.

jon