From f83867d2d443a254b44223b1fa2b043f5e1b3b2f Mon Sep 17 00:00:00 2001
From: Yueh-Shun Li <shamrocklee@posteo.net>
Date: Tue, 20 Jan 2026 23:17:19 +0800
Subject: [PATCH] buildPythonPackage: comment on passthru.__stdenvPythonCompat

---
 pkgs/development/interpreters/python/mk-python-derivation.nix | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/pkgs/development/interpreters/python/mk-python-derivation.nix b/pkgs/development/interpreters/python/mk-python-derivation.nix
index 0fb0a1326025..771d0050bc84 100644
--- a/pkgs/development/interpreters/python/mk-python-derivation.nix
+++ b/pkgs/development/interpreters/python/mk-python-derivation.nix
@@ -418,6 +418,9 @@ lib.extendMkDerivation {
           optional-dependencies
           ;
         updateScript = nix-update-script { };
+        # __stdenvPythonCompat attribute is here for overrideStdenvCompat in `python-packages-base.nix` to work.
+        # It is internal and subject to changes.
+        # TODO(@ShamrockLee): Remove when overrideStdenvCompat gets removed.
         ${if attrs ? stdenv then "__stdenvPythonCompat" else null} = attrs.stdenv;
       }
       // attrs.passthru or { };