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 3EAB03064A0 for ; Thu, 19 Feb 2026 21:55:38 +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=1771538139; cv=none; b=WS585n2VQPJv7f+byzWVGLK++c4qG/nRoSTDsR08MSoKhuNDS9aO5Kx73rNHCZWgeQrUAc2nPsJOB8OwH7k6bjcCNUiE0juDf+EEdr7BKpxeD6uof8fXVopLJs1yS/3BUJZfO/GnWQuLT8ywjtzqQsCc5nMxzG+XMzxZYNOSrW4= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771538139; c=relaxed/simple; bh=dQQbTiWg+Q+avemVoVRNGYCZwjZfE/A7Ya+FG4663fI=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=EqjSzuw17k1A7mIWMTFpUiaGoYxBHdlMiKrdS03fDJYS+sJFLSgThFkoKBkra5k4SQELJ+MPVh746EOR4lWoBDhb0MlQRkyfqt7W2AW6DAYjKlI0/WbYTM0aRbh+8mfeWKmcu3Wyedvof6bLrgysLkspNrTz/KSz5vz7Gix9Wtw= 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=EBKuNgLv; 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="EBKuNgLv" 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=lZv+df5NO0+5Xc5NCKKFtzaxnLR/jTbxBoMuKEZB77o=; b=EBKuNgLvoe8ZFAiOoz7ANGCQCA 8SNKNAn91iWzvXGEUp2tcv52gG/Jg/8lNRN/eXlKfG8KikLpWDqekTNhV843o9LfbWTiywNuEDOlF EVyn5J+tk0gB6y/0hIoXypy8Q2LXO//bHNoDeFDy3/2sSLHxlfR26NlKrub3zu0q1HuuRZTKLmi33 X7vTW+s99l2KZJGumxLBX2h3qJosixodJaO9WoQG6Sv9UAYXXI0rdQQrEzlsdsh1EUx6dLH2PcLtg Z1OjEzbOkwFeFcZms/fAJJ9l72A/Y/ooWoK+4XRXUNGaiTF7tys6o0ATJR23CT3HU9q4Kdg+O5WQj W7bOTY3g==; 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 1vtBzj-0000000C7DW-3C9h; Thu, 19 Feb 2026 21:55:36 +0000 From: Randy Dunlap To: dri-devel@lists.freedesktop.org Cc: Randy Dunlap , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Thierry Reding , Mikko Perttunen , linux-tegra@vger.kernel.org, Jonathan Hunter , David Airlie , Simona Vetter Subject: [PATCH RESEND] drm/tegra: dp: fix kernel-doc warnings in dp.h Date: Thu, 19 Feb 2026 13:55:35 -0800 Message-ID: <20260219215535.469520-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 Use correct kernel-doc format and add missing nested struct entries to eliminate kernel-doc warnings: Warning: drivers/gpu/drm/tegra/dp.h:28 Incorrect use of kernel-doc format: * tps3_supported: Warning: drivers/gpu/drm/tegra/dp.h:54 struct member 'tps3_supported' not described in 'drm_dp_link_caps' dp.h:73: warning: Function parameter or struct member 'apply_training' not described in 'drm_dp_link_ops' dp.h:73: warning: Function parameter or struct member 'configure' not described in 'drm_dp_link_ops' dp.h:160: warning: Excess struct member 'cr' description in 'drm_dp_link' Signed-off-by: Randy Dunlap --- Cc: Maarten Lankhorst Cc: Maxime Ripard Cc: Thomas Zimmermann Cc: Thierry Reding Cc: Mikko Perttunen Cc: linux-tegra@vger.kernel.org Cc: Jonathan Hunter Cc: David Airlie Cc: Simona Vetter --- drivers/gpu/drm/tegra/dp.h | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) --- linux-next-20260218.orig/drivers/gpu/drm/tegra/dp.h +++ linux-next-20260218/drivers/gpu/drm/tegra/dp.h @@ -26,7 +26,7 @@ struct drm_dp_link_caps { bool enhanced_framing; /** - * tps3_supported: + * @tps3_supported: * * training pattern sequence 3 supported for equalization */ @@ -62,12 +62,12 @@ void drm_dp_link_caps_copy(struct drm_dp */ struct drm_dp_link_ops { /** - * @apply_training: + * @apply_training: apply the link training */ int (*apply_training)(struct drm_dp_link *link); /** - * @configure: + * @configure: configure the DP link */ int (*configure)(struct drm_dp_link *link); }; @@ -113,6 +113,8 @@ struct drm_dp_link_train { * @max_lanes: maximum number of lanes supported on the link * @caps: capabilities supported on the link (see &drm_dp_link_caps) * @aux_rd_interval: AUX read interval to use for training (in microseconds) + * @aux_rd_interval.cr: clock recovery read interval + * @aux_rd_interval.ce: channel equalization read interval * @edp: eDP revision (0x11: eDP 1.1, 0x12: eDP 1.2, ...) * @rate: currently configured link rate * @lanes: currently configured number of lanes @@ -126,10 +128,6 @@ struct drm_dp_link { struct drm_dp_link_caps caps; - /** - * @cr: clock recovery read interval - * @ce: channel equalization read interval - */ struct { unsigned int cr; unsigned int ce;