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

[Randy Dunlap]

ping?

On 7/19/26 3:24 PM, Randy Dunlap wrote:
> kernel-doc reports 2 (kernel-doc) lines in coresight.h that don't have
> a beginning '*' in them, so fix these lines.
> 
> Also convert struct coresight_trace_id_map to kernel-doc format to
> remove another warning.
> 
> 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.
> Warning: include/linux/coresight.h:236 This comment starts with '/**',
>   but isn't a kernel-doc comment.
> 
> 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 at infradead.org>
> ---
> v2: rebase & resend
> v3: rebase & resend
> 
> Cc: James Clark <james.clark at arm.com>
> Cc: Tao Zhang <quic_taozha at quicinc.com>
> Cc: Suzuki K Poulose <suzuki.poulose at arm.com>
> Cc: coresight at lists.linaro.org
> Cc: Danilo Krummrich <dakr at kernel.org>
> Cc: Mike Leach <mike.leach at arm.com>
> Cc: Leo Yan <leo.yan at arm.com>
> Cc: linux-arm-kernel at lists.infradead.org
> ---
>  include/linux/coresight.h |    6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> --- linux-next-20260717.orig/include/linux/coresight.h
> +++ linux-next-20260717/include/linux/coresight.h
> @@ -177,11 +177,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.
> @@ -234,7 +234,7 @@ struct coresight_sysfs_link {
>  #define CORESIGHT_TRACE_IDS_MAX 128
>  
>  /**
> - * Trace ID map.
> + * struct coresight_trace_id_map - Trace ID map.
>   *
>   * @used_ids:	Bitmap to register available (bit = 0) and in use (bit = 1) IDs.
>   *		Initialised so that the reserved IDs are permanently marked as

-- 
~Randy