From nobody Sat Jul 25 03:20:57 2026 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8E398233953 for ; Sun, 19 Jul 2026 22:24:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784499901; cv=none; b=usULuPF75e8YEla7j2w/cAa6f3J/34LPYInQeMg33DIYDyD4YVxThU7wSztl16fKSI5e2IfSG59Aedvh6Vq2Mn+EjfR6wfS21ul9Tnq7xUAsMogXqF15agGULCYSSZFfr+Id3LK0hDTz13jM3x7WhawXX6/mrDmUR+VCvjkrGVI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784499901; c=relaxed/simple; bh=7FJBboQXw2tTckFJ6NWRwofmdGeCjRxz0KfEZrNL5VQ=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=ZBcQk8kRtA9iiSUJMlGIk084Gk85Awk79HxVAVvlexf7qlZahQ4N9RCMuzXYhGf0KuLcCqYgDY/qjjk8jtJ/Go3xJc7/6jOtYVCes2i+Wiwk3t+nWzEVcJiaqMZ7ADT5jVuc2JCetZWpK6jGfRNJuiISdW8t/5LeCllK3d4U768= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=pass smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=VB+ZMje0; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="VB+ZMje0" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=aWG2GSHye2ApE4ss7A7HC0jNVgX57Is7cEoAO4KnhzU=; b=VB+ZMje0cH39Wz5xWD5Z9pxMIB x/ULJASq+EDM2ezXLVxbcc9fEdXHXJp6tx5S6mYeT8T/NVOWpB+0AH/RmdFPcmuhYmd/o4c5KhUyS jULym20b6u48z1Rd+MTjvXe7xsHTl4pYD0roKkwQXr2DTgFwm50H+trNhPkjEsAH/w+P0G1VdFggd fgNaJ2XtXe0TjMzN190VMubiWqsNirrcSjbRtJ2WCEClOMz6I+EQCIIx9O4cfjTvSzclVfAU2UJV6 Q1RKaEV2nLji3lCGi5zaDJqsZscMtYFGdwPOZ8xvIJf7QZDwa4WjL5n+4NdS4dNoJNGtBXSheM/0X KRdgx50Q==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.99.1 #2 (Red Hat Linux)) id 1wlZwP-00000005R4T-0T70; Sun, 19 Jul 2026 22:24:57 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , James Clark , Tao Zhang , Suzuki K Poulose , coresight@lists.linaro.org, Danilo Krummrich , Mike Leach , Leo Yan , linux-arm-kernel@lists.infradead.org Subject: [PATCH v3] coresight: coresight.h: add '*' to kernel-doc lines Date: Sun, 19 Jul 2026 15:24:56 -0700 Message-ID: <20260719222456.2831456-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.55.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" 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 dire= ction explicit") Signed-off-by: Randy Dunlap --- v2: rebase & resend v3: rebase & resend Cc: James Clark Cc: Tao Zhang Cc: Suzuki K Poulose Cc: coresight@lists.linaro.org Cc: Danilo Krummrich Cc: Mike Leach Cc: Leo Yan Cc: linux-arm-kernel@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 th= at - 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 =20 /** - * Trace ID map. + * struct coresight_trace_id_map - Trace ID map. * * @used_ids: Bitmap to register available (bit =3D 0) and in use (bit =3D= 1) IDs. * Initialised so that the reserved IDs are permanently marked as