Thread (19 messages) 19 messages, 2 authors, 2020-06-25

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

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.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help