From mboxrd@z Thu Jan 1 00:00:00 1970 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 D31FF332909 for ; Thu, 26 Feb 2026 21:58:35 +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=1772143118; cv=none; b=cEhcyUoCTOtqg8/Gzq1flqOo/krb0G2Z7HyJjMc/XiD9Frs6aYGUf6/cqyZCztPUGHKThXgyRsiYu2UeKHeBaBrijjWoKPSQ+6H8TXj6gNqJ92yhRHN3NPtP6ich0yzjpytPw+9RG4NNqg6dy9UR/+nkjoiXBj21vRqm9oz2jDk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772143118; c=relaxed/simple; bh=qZJLjjBAD7plWq9M1o4qPhf0LWqJOLrZBKxxiqMW5dE=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=EhKJn3sky3BIVvAkumur3hTtW0D1P1vPGd5nYOaC8PrdxxSt/Gyu6ooQTchtxuK5uo1J2QFWqLmf5qkBmbAURY93QkeBH4py5jV22Lygd+/yKD8zCYNhmRTHgLf7YDOGtbk8xST+t0iusYedGEiouV3yeJ5Yt5xhX5XLCxcnTDc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=TLOugngg; 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=none 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="TLOugngg" 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=YWXdveS3W5uaJq5mYGYCeLHABpearsvRw8je8B2ojz8=; b=TLOugngg9sHXvUxXfwmpy0Ua72 EkCFQJgd9kDFZoujO/ulKE4j5ydMppGQHAkmKObbUEWFxPwRVSkCDbuzpy6sdFW7h4az04dWf4c2K qPd+wP2tMMU3iv/Tyyyj/QzAA+VgmOFNgK+mfiPPO/COdBzJhG2jcHwgd9+6W3NgqiaaZlE+r6ZpZ brkLk5jdHMz0hl7kvzDqvpn5OZrgHckzZUbvXHNc0mBxc5V7OqHJxj4w8iRtzy2XECXASSCCxrOFb PGCgMmKGwUuJCatOCVPAT3P988PIpgGdYOafV2Wn/5AO9OZ5vjOjvFl5bFeg/6VuRcZJfNPEaeFVy PRLpV5sg==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vvjNT-00000007HHz-0MGG; Thu, 26 Feb 2026 21:58:35 +0000 From: Randy Dunlap To: dri-devel@lists.freedesktop.org Cc: Randy Dunlap , Thierry Reding , Mikko Perttunen , linux-tegra@vger.kernel.org, Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter Subject: [PATCH] drm/tegra: tegra_drm.h: fix all uapi kernel-doc warnings Date: Thu, 26 Feb 2026 13:58:33 -0800 Message-ID: <20260226215833.989397-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-tegra@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add 2 struct member descriptions and demote several comments from "/**" kernel-doc comments to plain C "/*" comments to eliminate all kernel-doc warnings: Warning: include/uapi/drm/tegra_drm.h:353 struct member 'cmdbuf' not described in 'drm_tegra_reloc' Warning: include/uapi/drm/tegra_drm.h:353 struct member 'target' not described in 'drm_tegra_reloc' Warning: include/uapi/drm/tegra_drm.h:780 This comment starts with '/**', but isn't a kernel-doc comment. * Specify that bit 39 of the patched-in address should be set to switch Warning: include/uapi/drm/tegra_drm.h:832 This comment starts with '/**', but isn't a kernel-doc comment. * Execute `words` words of Host1x opcodes specified in the `gather_data_ptr` Warning: include/uapi/drm/tegra_drm.h:837 This comment starts with '/**', but isn't a kernel-doc comment. * Wait for a syncpoint to reach a value before continuing with further Warning: include/uapi/drm/tegra_drm.h:842 This comment starts with '/**', but isn't a kernel-doc comment. * Wait for a syncpoint to reach a value before continuing with further Signed-off-by: Randy Dunlap --- Cc: Thierry Reding Cc: Mikko Perttunen Cc: linux-tegra@vger.kernel.org Cc: Maarten Lankhorst Cc: Maxime Ripard Cc: Thomas Zimmermann Cc: David Airlie Cc: Simona Vetter include/uapi/drm/tegra_drm.h | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) --- linux-next-20260226.orig/include/uapi/drm/tegra_drm.h +++ linux-next-20260226/include/uapi/drm/tegra_drm.h @@ -304,6 +304,7 @@ struct drm_tegra_cmdbuf { * struct drm_tegra_reloc - GEM object relocation structure */ struct drm_tegra_reloc { + /** @cmdbuf: cmd information */ struct { /** * @cmdbuf.handle: @@ -321,6 +322,7 @@ struct drm_tegra_reloc { */ __u32 offset; } cmdbuf; + /** @target: relocate target information */ struct { /** * @target.handle: @@ -777,7 +779,7 @@ struct drm_tegra_channel_unmap { /* Submission */ -/** +/* * Specify that bit 39 of the patched-in address should be set to switch * swizzling between Tegra and non-Tegra sector layout on systems that store * surfaces in system memory in non-Tegra sector layout. @@ -829,17 +831,17 @@ struct drm_tegra_submit_buf { } reloc; }; -/** +/* * Execute `words` words of Host1x opcodes specified in the `gather_data_ptr` * buffer. Each GATHER_UPTR command uses successive words from the buffer. */ #define DRM_TEGRA_SUBMIT_CMD_GATHER_UPTR 0 -/** +/* * Wait for a syncpoint to reach a value before continuing with further * commands. */ #define DRM_TEGRA_SUBMIT_CMD_WAIT_SYNCPT 1 -/** +/* * Wait for a syncpoint to reach a value before continuing with further * commands. The threshold is calculated relative to the start of the job. */