users/tdback: include commentary in modules

9 files changed, 46 insertions, 1 deletions

diff --git a/users/tdback/modules/alacritty/default.nix b/users/tdback/modules/alacritty/default.nix
index 477b696..de382e9 100644
--- a/users/tdback/modules/alacritty/default.nix
+++ b/users/tdback/modules/alacritty/default.nix
@@ -1,3 +1,7 @@
+# users/tdback/modules/alacritty/default.nix
+#
+# A terminal emulator when I'm not using emacs.
+
 {
   pkgs,
   ...
diff --git a/users/tdback/modules/dunst/default.nix b/users/tdback/modules/dunst/default.nix
index 4b8bd7d..349ffbf 100644
--- a/users/tdback/modules/dunst/default.nix
+++ b/users/tdback/modules/dunst/default.nix
@@ -1,3 +1,7 @@
+# users/tdback/modules/dunst/default.nix
+#
+# System-wide notifications daemon.
+
 {
   pkgs,
   ...
diff --git a/users/tdback/modules/email/default.nix b/users/tdback/modules/email/default.nix
index 5a2f915..96640b4 100644
--- a/users/tdback/modules/email/default.nix
+++ b/users/tdback/modules/email/default.nix
@@ -1,3 +1,7 @@
+# users/tdback/modules/email/default.nix
+#
+# Archaic communication in the modern age.
+
 {
   config,
   lib,
@@ -43,9 +47,11 @@ in
     };
   };
 
+  # Require these programs for fetching/sending mail.
   programs.mbsync.enable = true;
   programs.msmtp.enable = true;
 
+  # Make these packages available in the cli if we are using emacs.
   home.packages =
     with pkgs.unstable;
     lib.mkIf config.programs.emacs.enable [
diff --git a/users/tdback/modules/firefox/default.nix b/users/tdback/modules/firefox/default.nix
index a4e78e8..aadbb33 100644
--- a/users/tdback/modules/firefox/default.nix
+++ b/users/tdback/modules/firefox/default.nix
@@ -1,3 +1,9 @@
+# users/tdback/modules/firefox/default.nix
+#
+# Because google sucks.
+#
+# TODO: Replace firefox with librewolf?
+
 {
   config,
   lib,
diff --git a/users/tdback/modules/git/default.nix b/users/tdback/modules/git/default.nix
index c9b3b6f..8a3c8f5 100644
--- a/users/tdback/modules/git/default.nix
+++ b/users/tdback/modules/git/default.nix
@@ -1,3 +1,7 @@
+# users/tdback/modules/git/default.nix
+#
+# The de-facto version control system.
+
 {
   config,
   ...
diff --git a/users/tdback/modules/mpd/default.nix b/users/tdback/modules/mpd/default.nix
index 863c96a..f4c94b1 100644
--- a/users/tdback/modules/mpd/default.nix
+++ b/users/tdback/modules/mpd/default.nix
@@ -1,3 +1,7 @@
+# users/tdback/modules/mpd/default.nix
+#
+# A music player daemon.
+
 {
   pkgs,
   ...
diff --git a/users/tdback/modules/rofi/default.nix b/users/tdback/modules/rofi/default.nix
index 37247c6..cc8d604 100644
--- a/users/tdback/modules/rofi/default.nix
+++ b/users/tdback/modules/rofi/default.nix
@@ -1,3 +1,8 @@
+# users/tdback/modules/rofi/default.nix
+#
+# For launching applications and switching to active windows. While not
+# heavily used for scripting, the possibility is there.
+
 {
   config,
   pkgs,
diff --git a/users/tdback/modules/tmux/default.nix b/users/tdback/modules/tmux/default.nix
index ab74a1d..51c5220 100644
--- a/users/tdback/modules/tmux/default.nix
+++ b/users/tdback/modules/tmux/default.nix
@@ -1,3 +1,8 @@
+# users/tdback/modules/tmux/default.nix
+#
+# My multiplexer outside of emacs. Rarely used anymore unless I'm editing with
+# (neo)vim.
+
 {
   pkgs,
   ...
diff --git a/users/tdback/modules/xmonad/default.nix b/users/tdback/modules/xmonad/default.nix
index b11f82b..9ddb0c1 100644
--- a/users/tdback/modules/xmonad/default.nix
+++ b/users/tdback/modules/xmonad/default.nix
@@ -1,3 +1,9 @@
+# users/tdback/modules/xmonad/default.nix
+#
+# A purely functional window manager. While I've enjoyed using bspwm/sxhkd with
+# polybar in the past, I love the hackability of xmonad and its integration
+# with xmobar.
+
 {
   lib,
   pkgs,
@@ -11,6 +17,7 @@ in
   xsession.windowManager.xmonad = {
     enable = true;
     enableContribAndExtras = true;
+    # Use the latest version of xmonad available in nixpkgs.
     extraPackages = haskellPackages: [
       haskellPackages.xmonad_0_18_0
       haskellPackages.xmonad-contrib_0_18_1
@@ -48,7 +55,7 @@ in
       '';
   };
 
-  # Generate X11 init scripts.
+  # Generate X11 init scripts to launch xmonad on login.
   home.file = with pkgs.unstable; {
     ".xinitrc".text = ''
       [ -f ~/.xprofile ] && . ~/.xprofile