Received-SPF: pass (google.com: domain of linux-kernel+bounces-81233-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249;
Date: Mon, 26 Feb 2024 11:57:27 +0100
From: Christoph Hellwig <hch@lst.de>
To: Akira Yokosawa <akiyks@gmail.com>
Cc: hch@lst.de, chandanbabu@kernel.org, corbet@lwn.net, david@fromorbit.com,
	djwong@kernel.org, linux-kernel@vger.kernel.org,
	linux-next@vger.kernel.org, linux-xfs@vger.kernel.org,
	mchehab@kernel.org, sfr@canb.auug.org.au
Subject: Re: linux-next: build warning after merge of the xfs tree
Message-ID: <20240226105727.GA28770@lst.de>
References: <20240223140619.GA30519@lst.de> <22187737-e0ad-4cc4-98fd-5e43ebc5ecee@gmail.com>
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <22187737-e0ad-4cc4-98fd-5e43ebc5ecee@gmail.com>
User-Agent: Mutt/1.5.17 (2007-11-01)

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@lst.de>