From nobody Mon Oct 6 22:51:10 2025 Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com [209.85.210.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B0CFB21D5A9 for ; Thu, 17 Jul 2025 06:58:17 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752735499; cv=none; b=sXCvAZTCA2FZfC3d28kvbyYgb48BSz0xQtaAXfMvRG07vsV/oy85XkL5uoqxc7zoMFIdS3EJXybLbbL+XBP3X/sUoByXgIzqUpxIt6m+ZFNHZ5r3Hl3uSZIdtIjeOZum1z/sjF2IMXYvAKbWmbaTxzDdDRS0y6HYeV3fvdQVZFI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752735499; c=relaxed/simple; bh=8gILEV2wshZruF7SjKc8/Her8leo7VCCobv+IxEo+ak=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=fXWVu6TJx7ImiCptjXZb3BFCf9dC1gdQ1TVpa7gPtqerwCVoe8hYgFgtWVRTDpVtq2l1pNZEiiO+Y8dNq1EOdAifAANO2NnKibYx+T3pWK0HOqDt0i08s2hRCYNiB2OqjSvqcELW/rv9Fg3LLs3it3W2EKJ7VLgixGAN9WJb88s= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=brighamcampbell.com; spf=pass smtp.mailfrom=brighamcampbell.com; dkim=pass (2048-bit key) header.d=brighamcampbell.com header.i=@brighamcampbell.com header.b=SMaSJhxe; arc=none smtp.client-ip=209.85.210.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=brighamcampbell.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=brighamcampbell.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=brighamcampbell.com header.i=@brighamcampbell.com header.b="SMaSJhxe" Received: by mail-pf1-f172.google.com with SMTP id d2e1a72fcca58-749248d06faso606231b3a.2 for ; Wed, 16 Jul 2025 23:58:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brighamcampbell.com; s=google; t=1752735497; x=1753340297; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=5D4Zj64qlLFOiqXv/wSX0OcGR87OOiTqr+HfIllhQOk=; b=SMaSJhxeldjocrMH6qUWGKj7vkdzFL7QvkT1+MtH7ZKBaTiztugLY3iCbUUjaNz3kl Vat4WVyZ9ZRihEmTQm99YzB3BO9ocr7SLOstUlOACt3HoOUOeVkfXjtYGE7Mik+rXAnq 0T1ppMpmX7pRLxaUv4peOiGsW9gIrQYSfqKYj0w9IVBr93/0+P9RqzEUTRK+LnXg78QT rysfBc3nQ0xF460Jqq2DTid1jdrz276SHYBfZJGnyC69IuzE69Wcos7q68IwZVLaaxja MlJIqvLlzu1uVUrCF0Ji26OEcUdXpaG0ARQXsoLAZCPnxGtxdfbSk+R46CsnTab/Xtn4 yx3A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1752735497; x=1753340297; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=5D4Zj64qlLFOiqXv/wSX0OcGR87OOiTqr+HfIllhQOk=; b=ZzNmBNJFKiSoh0DkfC2rEKl7bhoMWHrCCerkTyCTyJeNtEQdGE0lgGeDXKlh2SCCgD f6sdlFA0uAhs73wetF5JbKu26bf0iABg6PnuT8v9iAc0Uz49klYjmIYXiaMg1MgKPNAe Mvjg7lTriH/7kgIfYthV1lhwuMw02dBI0X6KhT2TWkcX/Ju5VYLB6wjjhbLvtHiIN5Tj JwNKVQdyR0tMbtnBN7REKFgmX+i4XeCyEg2cZkqVIMGqSkFk2cHMKag/uyYy17bc6CtR X2g+nha6sQE9jHtCirnCsnfeUvfsg3fzHVcfSWGWpSL2ObAv7HtxwixNG3mbbXjVxHbe a4AQ== X-Forwarded-Encrypted: i=1; AJvYcCV6tN1VCbhGCKKI/iPMTE5JwY5ejLybFTezB+mj/30mBuZEDUh6ul1Kfc+mdEDkU0HKreDU9yECJ39TSzw=@vger.kernel.org X-Gm-Message-State: AOJu0Yzt7yifALwD4Zp1rN5AiPm9huq/dn7XYwW6CIsHx1kzkqhPtZGi o/mqv3XHkyBggADNWCTm1q/Z+77IM5FA3G60uCzE7RN58YRa6SkweELyenhp7GLKAok= X-Gm-Gg: ASbGncujSIqWlCqco4iURdox4pCGUeUCYfuweGBxUrphYXL5Ho9eMLWR55Wlb2vL2xs Gg++C8SAGuh1B5YGFbxgoNirHacSaZeQ2Ynp0HKsTmCCrSzz9fPrzQCbB9laGOFbiRrSSod6i1i crDu7bVZtLYex87hZCIOCQ01f/uwO/jFKqqmWbzm9ZWB2WYbz97zONfEwnc8hYnGHi1t1u7Wuez 4M+KhTFKtEEaKhgF9UhDQ0QjeUNFFy4xpd5Xjuiai2NPWZ0gPWUC0iyoVDzYTyrWa4FTl4YILvs YGwZ9qSxTiYqPh80vK0bGb0t49ZqufEJY+7EaOc2Tl+wxq7gUQg9+F7S1vILezb1sihxbac8u4e tpNE8lN1bmp2hJV/X860pvtZ1D3+CcANLmn9ULiREAPinpNlkfl24MQ== X-Google-Smtp-Source: AGHT+IF4uL0UE6/IVMLL8a5IBc0w9BS0oX81DCNFSPt471frTtvJ5jahdDuVoKlFV7+0mFnbfKekmA== X-Received: by 2002:a05:6a20:6a10:b0:203:bb65:995a with SMTP id adf61e73a8af0-2390dc51b64mr2966437637.30.1752735496874; Wed, 16 Jul 2025 23:58:16 -0700 (PDT) Received: from mystery-machine.brighamcampbell.com ([64.71.154.6]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-74eb9f4bc51sm15157293b3a.116.2025.07.16.23.58.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Jul 2025 23:58:16 -0700 (PDT) From: Brigham Campbell To: dianders@chromium.org, tejasvipin76@gmail.com, diogo.ivo@tecnico.ulisboa.pt, skhan@linuxfoundation.org, linux-kernel-mentees@lists.linux.dev, dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , Jonathan Corbet Cc: Brigham Campbell Subject: [PATCH v3 4/4] drm: docs: Update task from drm TODO list Date: Thu, 17 Jul 2025 00:57:56 -0600 Message-ID: <20250717065757.246122-5-me@brighamcampbell.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250717065757.246122-1-me@brighamcampbell.com> References: <20250717065757.246122-1-me@brighamcampbell.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Update TODO item from drm documentation to contain more applicable information regarding the removal of deprecated MIPI DSI functions and no longer reference functions which have already been removed from the kernel. Reviewed-by: Douglas Anderson Signed-off-by: Brigham Campbell --- Documentation/gpu/todo.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst index be8637da3fe9..92db80793bba 100644 --- a/Documentation/gpu/todo.rst +++ b/Documentation/gpu/todo.rst @@ -497,19 +497,19 @@ Contact: Douglas Anderson =20 Level: Intermediate =20 -Transition away from using mipi_dsi_*_write_seq() -------------------------------------------------- +Transition away from using deprecated MIPI DSI functions +-------------------------------------------------------- =20 -The macros mipi_dsi_generic_write_seq() and mipi_dsi_dcs_write_seq() are -non-intuitive because, if there are errors, they return out of the *caller= 's* -function. We should move all callers to use mipi_dsi_generic_write_seq_mul= ti() -and mipi_dsi_dcs_write_seq_multi() macros instead. +There are many functions defined in ``drm_mipi_dsi.c`` which have been +deprecated. Each deprecated function was deprecated in favor of its `multi` +variant (e.g. `mipi_dsi_generic_write()` and `mipi_dsi_generic_write_multi= ()`). +The `multi` variant of a function includes improved error handling and log= ic +which makes it more convenient to make several calls in a row, as most MIPI +drivers do. =20 -Once all callers are transitioned, the macros and the functions that they = call, -mipi_dsi_generic_write_chatty() and mipi_dsi_dcs_write_buffer_chatty(), can -probably be removed. Alternatively, if people feel like the _multi() varia= nts -are overkill for some use cases, we could keep the mipi_dsi_*_write_seq() -variants but change them not to return out of the caller. +Drivers should be updated to use undeprecated functions. Once all usages o= f the +deprecated MIPI DSI functions have been removed, their definitions may be +removed from ``drm_mipi_dsi.c``. =20 Contact: Douglas Anderson =20 --=20 2.49.0