Received: by 2002:ab2:3350:0:b0:1f4:6588:b3a7 with SMTP id o16csp1874168lqe; Tue, 9 Apr 2024 03:05:36 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCU2JRH8xoK4ti+q+Y2Ijg+5cevpErpNJMhJ1UQaToSsfxcakxB/0cBtZux6viRUhFmI9bEv0YIfm+WHe1Cx8oB9oAwV2ulkT6m90N6ubg== X-Google-Smtp-Source: AGHT+IFo+eIjTxMF2f27uE+nCBKWjvKnvXAnZYe4we68ZWiv+tq/GlwBi3LGTED+uvVo1Zg4YpcF X-Received: by 2002:a05:6a00:2285:b0:6ed:9493:bc6d with SMTP id f5-20020a056a00228500b006ed9493bc6dmr584679pfe.12.1712657136327; Tue, 09 Apr 2024 03:05:36 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1712657136; cv=pass; d=google.com; s=arc-20160816; b=vOBZy05UYF8HMDoClaiWgliSaM7R/kt9DoTGlR8DzL/HP3mb0+2lN5CbJcvNKA7Miw jbKYwZV3kzn4etSeHm8o4i6JHHvpJ2C4Hk6XH/3/BcgNY9xHNPwnjKjAFhMfDs4Jngse V2aVD0Q3L5T5h8NjpcGylPI2zWrvxFOyzRg1dTRssXkPeLSv+tqpp7AWq189mVqetDPj +eV6A1PNbG3cofBkc4ERL5Q0Df+seWjVXVXXIVtU0K1ZvnWGvBTLpUy1Bgf7MuUr+VAP wvVdiXzgvOOMWy07ABLVxZjEinskW80mUEpB83qeNZVgneSvLIOImQ+8zL6xC3Kj4v6O OdcQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=cc:to:content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:from :dkim-signature; bh=P5KyQ86XhO4c/3+mfHw2niwhZfwjRkHxeV4U9txDECY=; fh=U5auLWKyrMr/J7ji5Vo7Z8k3AlJYUDgvFyt59O6Kkm8=; b=e0LcI7E+/tn/8ViipIL9oBZaRttzfw24dksfOVrF5lJeOL6rAmowY0NBo6MgrGtJPv T473dt72TvJa+bjHW4r7zWWQhdYhLloQdjg3sWG8UNr8CU7mceAz+i6HEcSkSEzV8BB5 G2U/04Q8La23fX+SwSZJjbDs3WwHwkvQUUmd95D5DqT/B9hC/E7UnYp5buaWs9+A25MT efh/E3pJtCDtRinHGnxI8eKBFGIcdXDhExuH7Dwb2cakdcZpBsglVsM7xC5oD2+Lgr/n lR4RoeRRgpNzQtyxwImWVUssPcfgr3b4vNpQ22a+V+kVg1Bm4ljP3Kpvczhe7QPojRET Z79w==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=l5kE49th; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-136616-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-136616-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id z32-20020a634c20000000b005f057f3746asi8054851pga.449.2024.04.09.03.05.36 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Apr 2024 03:05:36 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-136616-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=l5kE49th; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-136616-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-136616-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 3047828430D for ; Tue, 9 Apr 2024 10:04:49 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id CE89D80C11; Tue, 9 Apr 2024 10:04:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="l5kE49th" 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 BF9267F482 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=LEHwxG68kFzXeg4t4O9vDBifE+bhvhWTCStKRt+sZ1cg2RTS//kozDShYpYtXsZQe6yDTkS8rMtr/zGhOBzAVr33zP8kJ6OeICJHWIJDt1sfVEYixIwtBFn7Wo2b5Gy4AVLA25Ehmxuqt5z6swFJlIxBqzHt67s24ep2Y9q6XQk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712657083; c=relaxed/simple; bh=A9Ti38Ukw9P6xGFh6Uafw+LqnapiDQLHjycZFMYCGjA=; h=From:Subject:Date:Message-Id:MIME-Version:Content-Type:To:Cc; b=QMvM/eUl/hIjLcUUv8lMAA6mszETaMakQu8gZ/WIY0Ogc9uP4ayk7wJR8r9WyWX9u2Gg+0KwCLi9uT3G6TLZn4aCKIt28ps/O/7krWAq5+uGpMVZlApVVgo6TJfMA+tFsLwTTdG0MbzxL5pZB9RePdUWaFBHsBBIAU32ZNSuReo= 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=l5kE49th; 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 Received: by mail.gandi.net (Postfix) with ESMTPSA id D1ABDC0004; Tue, 9 Apr 2024 10:04:37 +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; bh=P5KyQ86XhO4c/3+mfHw2niwhZfwjRkHxeV4U9txDECY=; b=l5kE49thnJ8IPQ9eWvCMMsRjMF9ggPVbo6CBNh53YyJnE4ecYuDpWb5yyF99Ym0dB81bwL YSpnD5hID1Xau2EC3Fus4/nK9U297/2DBbeP3kvNh2W5uJjA3cr6qAcUsYdc4XZaraHVD6 A1q0H/42dGCyyjaA93fHCEZVEbYi+U4tRIsblYjAYqG/SxfEXuyqtOi2/tu2D+a7ld+FSh hndlFXKRruIDuyGFux31Ro4R+dOZQgWt2jjeeKaMxt61bNYcFs6zfX4003+PcdanUHj2w8 RXzPOT/kHHObPlPdXSFGp0F98JfLCW0U2DfcCDQWx+1No5W/Trot5WPQP+4XoA== From: Louis Chauvet Subject: [PATCH 0/3] drm: Multiple documentation update Date: Tue, 09 Apr 2024 12:04:04 +0200 Message-Id: <20240409-google-drm-doc-v1-0-033d55cc8250@bootlin.com> 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: 7bit X-B4-Tracking: v=1; b=H4sIAJQSFWYC/x3MQQqAIBBA0avErBvIqZC6SrQIHW2gNBQikO6et HyL/wtkTsIZ5qZA4luyxFCh2gbMvgXPKLYaqKOh60mjj9EfjDadaKNBY0mPNCk9kYMaXYmdPP9 wWd/3A+ZwsedgAAAA 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=1518; i=louis.chauvet@bootlin.com; h=from:subject:message-id; bh=A9Ti38Ukw9P6xGFh6Uafw+LqnapiDQLHjycZFMYCGjA=; b=owEBbQKS/ZANAwAIASCtLsZbECziAcsmYgBmFRK0BYQm4E+T5uIr0+BUqoaEiKB4cnuyp07Zw lslOHYVuLyJAjMEAAEIAB0WIQRPj7g/vng8MQxQWQQgrS7GWxAs4gUCZhUStAAKCRAgrS7GWxAs 4h+QEADAbw1aGPIH/ZJAe6VyK24l2kQqCVjGqekjvcqxAGDaoI+Wum4ONRdb4VJ/94X8qdDGlCn GZmHFLpNBSVsgsNAI+5BYLjJI6I3u72OZAPGWN7X+H6ND7PrjHmGhN8+RRmG6oTelIxlv6CjhZz jP6a0zIyuMK44VKHDL4x/6dxSpboEwjtTqAEhz5VZ9awic7yf2L6maFgZZHfLnaz5ECwfyX9cy0 tQmHIsA1+5yJbJzB7UVM9NXJzL0aLMxLtkC/Ya7u1urAp8uWOTtn6sD9rYWn0UtcM5I1STQLaiX hB5TnOaN5YYXA0VGW+/zSIDHdmG3qWvh3VtgU7+DKlEarKkxBH+IDKWDgJre6gcLWOqoppskW4V TRnDKXGcnwB7FW9H+m1OcZ0MIqt9GJeGc0AtB58IQCoyxj2720BFalKyzzVY0UX2X2B0vcPjXnT QrNCjfGCKtvpu8NSGpTYNiFjgQ3l37KHxvIL7SnZiPvFWO9d9oqy8ZP8E24h5VmbtMuNtR+F+5A StQXcdhzywdoHy2cq1Wj/4mvGWrxRUPjLFKsis6/a8+ktx7FRncFRxQ3AZxrb5irDTJszU2Y7F7 ea4YR1UDUZbBm/sNvkTmpME0kl00fGX5WLnzpAdkkY84zrE2nQzeVP2X0us9WXZTEHju7JUZsY1 WDtLWbeAys9vHBw== X-Developer-Key: i=louis.chauvet@bootlin.com; a=openpgp; fpr=8B7104AE9A272D6693F527F2EC1883F55E0B40A5 X-GND-Sasl: louis.chauvet@bootlin.com PATCH 1 and PATCH 2 focus on the rotation property. The rotation property can be challenging to understand, especially when it is combined with reflections. These patches aim to provide clearer explanations and examples to aid in comprehension. Patch 3 relates to the fourcc property. It includes additional details about block and char_per_block to provide a more comprehensive understanding of this feature. Regarding PATCH 1, I would appreciate some feedback on the expected behavior. During a recent VKMS refactor, I used drm_rect_rotate as a reference for the rotation. However, during my testing phase, I noticed that the original VKMS implementation interpreted the rotation differently. Therefore, I kindly request that someone validate or invalidate my interpretation before proceeding with the merge. Signed-off-by: Louis Chauvet --- Louis Chauvet (3): drm: drm_blend.c: Add precision in drm_rotation_simplify kernel doc drm: drm_blend.c: Improve drm_plane_create_rotation_property kernel doc drm/fourcc: Add documentation around drm_format_info drivers/gpu/drm/drm_blend.c | 57 ++++++++++++++++++++++++++++++++++----------- include/drm/drm_fourcc.h | 45 +++++++++++++++++++++++++++++------ 2 files changed, 81 insertions(+), 21 deletions(-) --- base-commit: e495e523b888a6155f82c767d34c8d712a41ee54 change-id: 20240327-google-drm-doc-cd275291792f Best regards, -- Louis Chauvet