Re: [PATCH 02/14] soundwire: Add SoundWire bus type

From: Srinivas Kandagatla
Date: Fri Nov 10 2017 - 05:50:12 EST




On 10/11/17 08:55, Vinod Koul wrote:
+
+/**
+ * sdw_get_device_id: find the matching SoundWire device id
+ *
function name should end with () - according to kernel doc.
ah thanks for pointing will add
I ran the kernel-doc script, seems to not complain about this.

Looking at it closely scripts/kernel-doc parenthesis is not expected

https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/doc-guide/kernel-doc.rst?h=v4.14-rc8#n204

Examples in the doc does suggest that we need (). Am not 100% sure if : is also a valid with functions.