Re: [PATCH 03/10] regulator: of_regulator: Add missing colon for rdev kerneldoc argument
From: Mark Brown <broonie@kernel.org>
Date: 2020-06-25 17:29:47
Also in:
lkml
From: Mark Brown <broonie@kernel.org>
Date: 2020-06-25 17:29:47
Also in:
lkml
On Thu, Jun 25, 2020 at 05:36:07PM +0100, Lee Jones wrote:
Kerneldoc validation gets confused if syntax isn't "@.*: ". Adding the missing colons squashes the following W=1 warnings:
* of_check_coupling_data - Parse rdev's coupling properties and check data * consistency - * @rdev - pointer to regulator_dev whose data is checked + * @rdev: - pointer to regulator_dev whose data is checked
It shuts up the warning but are you sure this is going to get formatted well by the tools? We now have a - as the first character in the description which I'm guessing the tools are going to render which won't look great.