From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org 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.lore.kernel.org (Postfix) with ESMTPS id BDAE3C61DE4 for ; Mon, 31 Aug 2026 03:09:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Reply-To:Content-Type: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Owner; bh=NWvQJuqSPHF8KCZzanHrbmAUYIDC8tUyn91hJD3luIM=; b=jcRdTfJL0EgIKz5EmaSJeEKZZ/ j1y3X8cfiIOQ9bsn6KNEFPUGhDZ0tKWi7tMV3cpDaadYqqNjg9JCugAE++5WddWUZ8qHwNwHzpg8D SpJTQ0JLAsCZG8FjcMCVWNul1ixvBA+TTnh4vpPu3rhj6xsAB7ggHpXIu0NdaDpP0qui8Mi4MAYI+ TCEnt3dzEbrbKlYRFePyJ9lZwsaNftnuihHtAviLbBmXkBpeqvwJVdEmsW3ceVLqkxPkJqEYSErXC KHoveuEUAlKnb0lJnMqLCTIQ9nB0OMqjD1XRX4BienA54Ukkgj1pZ1KReAcU4et37EXyRArP21sQs Qow2bKRA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1x0sOZ-00000008O3P-0GxD; Mon, 31 Aug 2026 03:09:15 +0000 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 1x0sOX-00000008O3C-0TdK; Mon, 31 Aug 2026 03:09:13 +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, Andrew Morton Subject: [PATCH v4] coresight: coresight.h: add '*' to kernel-doc lines Date: Sun, 30 Aug 2026 20:09:12 -0700 Message-ID: <20260831030912.3399089-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.55.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org 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 --- v2: rebase & resend v3: rebase & resend v4: rebase & resend; add Andrew to Cc: list 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 Cc: Andrew Morton --- include/linux/coresight.h | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) --- linux-next-20260828.orig/include/linux/coresight.h +++ linux-next-20260828/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