From nobody Sun Feb 8 16:30:56 2026 Received: from relay6-d.mail.gandi.net (relay6-d.mail.gandi.net [217.70.183.198]) (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 359937D3E8 for ; Tue, 9 Apr 2024 10:04:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.70.183.198 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712657083; cv=none; b=GKnYGDTlKm+dKXrLx/sZY0JddAUg8XJsPjAIWDm+3iLfVITqKx5JScfvtuiqBVUPJShfAZ3ZmUOoLGB7OwQo2zvu7q3TTtdXAPxPloFDLB9L2AnszDmAjdMIZ2dGtaG0McpMmnKSH+FwHN5RSaNkVpluYQ/+Y5P6hWfICdnVVMg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712657083; c=relaxed/simple; bh=GnEAU3vkYSsIbjMvOqh2HX/HLaX5yQhIo1CxMvrQ8M8=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=MJkFOKdQ/0f7ikTif85YkJdRNmAf8W07I5W6GVT5eGnwCQpYqa5xkEjB824ew6+cCrgfHqNYQE1zCBlS80YiCfuV9Bnpd3PWZoSaS9GRRx63/LHNuZphdMxK+1EzpV8hj4DUQ5aDr+GbVKM6Rkr59aYLArbRC49896PpDaFsonI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com; spf=pass smtp.mailfrom=bootlin.com; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b=TTF9k+Cq; arc=none smtp.client-ip=217.70.183.198 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=bootlin.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="TTF9k+Cq" Received: by mail.gandi.net (Postfix) with ESMTPSA id 1F9BCC000A; Tue, 9 Apr 2024 10:04:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1712657079; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=KeTCbI41YllG2juL/zynve9f30ih0GcjJDj1DkPkKmI=; b=TTF9k+CqN6Ksz6VxHxTbdOKvgJf5L0YdBPnhe6wIzd7Q4XuP/W/S991M4aMsLkFvgjquRf xChLrPFym6WV+JiMhfGdSnjY0wLl8XpXiJZSo0P5gXb5OgTflnSWxwUuwZA4Oj1GpMk/65 mDwNBrIjbkg8YlWZpTzMMByLLPYqi6nLSve0AuKH6IC80zQyQadEYAI2yxhY++pX+Qv+SG K4fd8KAiqNOaPrj6EqNHFlu5cerJzTDEDI+GqqDeRxsHfhOYy+5PUTL7lB41PzeEd+Bseu 19WUY6Zter37MgVAu8nrXwboKwgVZONxffiaTPOGK/4xUJxWA/2Z3VlhUOgXFA== From: Louis Chauvet Date: Tue, 09 Apr 2024 12:04:05 +0200 Subject: [PATCH 1/3] drm: drm_blend.c: Add precision in drm_rotation_simplify kernel doc Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20240409-google-drm-doc-v1-1-033d55cc8250@bootlin.com> References: <20240409-google-drm-doc-v1-0-033d55cc8250@bootlin.com> In-Reply-To: <20240409-google-drm-doc-v1-0-033d55cc8250@bootlin.com> To: Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Daniel Vetter Cc: dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, seanpaul@google.com, marcheu@google.com, nicolejadeyee@google.com, pekka.paalanen@collabora.com, thomas.petazzoni@bootlin.com, Louis Chauvet X-Mailer: b4 0.14-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1106; i=louis.chauvet@bootlin.com; h=from:subject:message-id; bh=GnEAU3vkYSsIbjMvOqh2HX/HLaX5yQhIo1CxMvrQ8M8=; b=owEBbQKS/ZANAwAIASCtLsZbECziAcsmYgBmFRK0T5sJ/qV58pufJn0nYKqJDIF72xUObkmnx 5IR9gxtloiJAjMEAAEIAB0WIQRPj7g/vng8MQxQWQQgrS7GWxAs4gUCZhUStAAKCRAgrS7GWxAs 4gbwEACFy6mN8LWaWNWfdR8fwy8cEvq+0zsS5jMExYL3bX2x+ZmAeyeGZ7XgiKzsyfqW9I+prA/ SxCwXidtl0btXPXW9rjBAoIUgCG6pGEn/5PDMXe1ThdrGvhYUiKVcFfP+GoZwqmGm2TdUlfqt5+ vOjGi4D+4mK9KmHXECS8gpl3KCP8zvdlr5WV0kRuWaXKWnNEO2hz31X+rp0c0XXxdd12gsAqocm k1m6kgxr3YWv4Utvyw2aKRftQBi16DEiaiAeO2qQ2ALqBRsOvQvcq/9preliWBbLx9RbOIxoL1P dzW+KLOunArMPjHq7W1AGHsrSjjMeaPL4TYr8UtPYNMAH4lKRH5MmwuxHsh0+bLonWBwe6IX92L V0ipY/5MjeRlcQfKCtLyVNfWblEeqAMs+9H5k2uwORjMnYOuOWa08kvtApV5hQ17DfrKBYHGOSb P8WML+UbgtF8RBRqd53HgSj+gD6uZoCDtYpZsRKcpTbcAiYDZOfYurNw8TRdWR51fmM+gheTfaL ePSitse5QkWlodA+6XFpsNCJymekxkYR6gCvwRILVhUv8Xpi4h95yGsWyzkKWfPTsehcr/sfsze Crzn0TmG526BDYUTpJe394pJg8ponoPrsoO/p1MTm706m1fK8ZB/1u5GWpDnPipa2nMsx5SE+CY r+xhRl/TZjAFH2w== X-Developer-Key: i=louis.chauvet@bootlin.com; a=openpgp; fpr=8B7104AE9A272D6693F527F2EC1883F55E0B40A5 X-GND-Sasl: louis.chauvet@bootlin.com As the function uses non-trivial bit operations, add a little paragraph to describe what is the expected behavior. Signed-off-by: Louis Chauvet Reviewed-by: Bagas Sanjaya --- drivers/gpu/drm/drm_blend.c | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/drivers/gpu/drm/drm_blend.c b/drivers/gpu/drm/drm_blend.c index 6e74de833466..8d4b317eb9d7 100644 --- a/drivers/gpu/drm/drm_blend.c +++ b/drivers/gpu/drm/drm_blend.c @@ -321,6 +321,11 @@ EXPORT_SYMBOL(drm_plane_create_rotation_property); * transforms the hardware supports, this function may not * be able to produce a supported transform, so the caller should * check the result afterwards. + * + * If the rotation is not fully supported, this function will add a rotati= on of 180 + * (ROTATE_90 would become ROTATE_270) and add a reflection on X and Y. + * The resulting transformation is the same (REFLECT_X | REFLECT_Y | ROTAT= E_180 + * is a no-op), but some unsupported flags are removed. */ unsigned int drm_rotation_simplify(unsigned int rotation, unsigned int supported_rotations) --=20 2.43.0