From 6de935a0126efde78feefbbe3bddfaa6be2bda6a Mon Sep 17 00:00:00 2001
From: Adam Joseph <adam@westernsemico.com>
Date: Tue, 8 Mar 2022 18:27:49 -0800
Subject: [PATCH] This commit adds only comments to platforms.nix.

---
 lib/systems/platforms.nix | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/lib/systems/platforms.nix b/lib/systems/platforms.nix
index fb515f67eee7..e7d61b24b059 100644
--- a/lib/systems/platforms.nix
+++ b/lib/systems/platforms.nix
@@ -1,3 +1,10 @@
+# Note: lib/systems/default.nix takes care of producing valid,
+# fully-formed "platform" values (e.g. hostPlatform, buildPlatform,
+# targetPlatform, etc) containing at least the minimal set of attrs
+# required (see types.parsedPlatform in lib/systems/parse.nix).  This
+# file takes an already-valid platform and further elaborates it with
+# optional fields such as linux-kernel, gcc, etc.
+
 { lib }:
 rec {
   pc = {
@@ -548,6 +555,9 @@ rec {
     };
   };
 
+  # This function takes a minimally-valid "platform" and returns an
+  # attrset containing zero or more additional attrs which should be
+  # included in the platform in order to further elaborate it.
   select = platform:
     # x86
     /**/ if platform.isx86 then pc