Re: linux-next: build warning after merge of the xfs tree

From: Christoph Hellwig
Date: Mon Feb 26 2024 - 05:58:56 EST


On Sat, Feb 24, 2024 at 06:07:28PM +0900, Akira Yokosawa wrote:
> How about teaching kernel-doc unary "*" on param?

That would be great!

>
> Substitution would look like:
>
> (kernel-doc) (RST)
> *@param -> ***param**
>
> Sphinx detects double asterisk, starts strong emphasis, waits for
> another double asterisk to appear, and stops strong emphasis.
> Hence you would get boldface "*param" in pretty printed docs.
>
> Diff below (against docs-next) should add a rule for param_deref
> (only for RST).

I'd love to go with this instead of working around the issue:

Acked-by: Christoph Hellwig <hch@xxxxxx>