linux-kernel - [PATCH] coresight: coresight.h: add '*' to kernel-doc lines

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <20251031054211.1411151-1-rdunlap@infradead.org>
Date: Thu, 30 Oct 2025 22:42:11 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: linux-kernel@...r.kernel.org
Cc: Randy Dunlap <rdunlap@...radead.org>,
	James Clark <james.clark@....com>,
	Tao Zhang <quic_taozha@...cinc.com>,
	Suzuki K Poulose <suzuki.poulose@....com>,
	coresight@...ts.linaro.org
Subject: [PATCH] coresight: coresight.h: add '*' to kernel-doc lines

kernel-doc reports 2 (kernel-doc) lines in coresight.h that don't have
a beginning '*' in them, so fix these lines.

Warning: include/linux/coresight.h:173 bad line:
   connected to @src_port. NULL until the device is created
Warning: include/linux/coresight.h:177 bad line:
   needs to be filtered.

Fixes: ec9903d6cc34 ("coresight: Add support for trace filtering by source")
Fixes: d49c9cf15f89 ("coresight: Rename connection members to make the direction explicit")
Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
---
Cc: James Clark <james.clark@....com>
Cc: Tao Zhang <quic_taozha@...cinc.com>
Cc: Suzuki K Poulose <suzuki.poulose@....com>
Cc: coresight@...ts.linaro.org
---
 include/linux/coresight.h |    4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

--- linux-next-20251016.orig/include/linux/coresight.h
+++ linux-next-20251016/include/linux/coresight.h
@@ -171,11 +171,11 @@ struct coresight_desc {
  * @dest_port:	destination's input port number @src_port is connected to.
  * @dest_fwnode: destination component's fwnode handle.
  * @dest_dev:	a @coresight_device representation of the component
-		connected to @src_port. NULL until the device is created
+ *		connected to @src_port. NULL until the device is created
  * @link: Representation of the connection as a sysfs link.
  * @filter_src_fwnode: filter source component's fwnode handle.
  * @filter_src_dev: a @coresight_device representation of the component that
-		needs to be filtered.
+ *		needs to be filtered.
  *
  * The full connection structure looks like this, where in_conns store
  * references to same connection as the source device's out_conns.