From d4e55d835ee3e7f62c4c670128e9eaa574c141cc Mon Sep 17 00:00:00 2001
From: byteforge38 <stormcraft318@gmail.com>
Date: Fri, 16 Jan 2026 06:38:19 -0800
Subject: [PATCH] stdenv: add comment explaining replaceStdenv fallback

---
 pkgs/stdenv/default.nix | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pkgs/stdenv/default.nix b/pkgs/stdenv/default.nix
index 53f63245c919..3cbe274a2f0e 100644
--- a/pkgs/stdenv/default.nix
+++ b/pkgs/stdenv/default.nix
@@ -43,6 +43,7 @@ in
 # Select the appropriate stages for the platform `system'.
 if crossSystem != localSystem || crossOverlays != [ ] then
   stagesCross
+# The `or null` fallback is needed for contexts that don't use the module system (e.g. tarball builds).
 else if (config.replaceStdenv or null) != null then
   stagesCustom
 else if localSystem.isLinux then