From 84c1056053307a912d0ff7254ef894b731f94c10 Mon Sep 17 00:00:00 2001
From: Grey Jones <grey@greyweather.dev>
Date: Tue, 28 Jul 2026 03:11:05 +0100
Subject: [PATCH] improve packages overlay + add comments explaining

---
 global-default.nix | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/global-default.nix b/global-default.nix
index 74f8a0b..337fa25 100644
--- a/global-default.nix
+++ b/global-default.nix
@@ -5,9 +5,8 @@
   specialArgs,
   ...
 }: let
-packageFileNames = builtins.attrNames (builtins.readDir ./packages);
-packageNames = map (x: lib.removeSuffix ".nix" x) packageFileNames;
-packagesOverlay = (final: prev: lib.genAttrs packageNames (name: (prev.pkgs.callPackage ./packages/${name}.nix { })));
+packageNames = map (name: lib.removeSuffix ".nix" name) (builtins.attrNames (builtins.readDir ./packages)); # creates a list of files in ./packages, with their '.nix' extensions removed
+packagesOverlay = (final: prev: lib.genAttrs packageNames (name: (prev.pkgs.callPackage ./packages/${name}.nix { }))); # creates a function (overlay) that returns an attrset of names paired to 'callPackage' calls
 in {
   imports = [
     ./hosts/${specialArgs.hostname}/hardware-configuration.nix