draft: add comments to process-compose settings issues

src/modules/process-managers/process-compose.nix

@@ -19,6 +19,7 @@ in
     settings = lib.mkOption {
       type = settingsFormat.type;
       default = { };
+      # TODO: the description and example are incorrect. AFAIKT this is the top-level config.
       description = ''
         process-compose.yaml specific process attributes.
 
@@ -37,6 +38,7 @@ in
     };
   };
   config = lib.mkIf cfg.enable {
+    # TODO: PC_TUI_ENABLED doesn't exist? PC_DISABLE_TUI does
     processManagerCommand = ''
       ${cfg.package}/bin/process-compose --config ${cfg.configFile} \
         --unix-socket ''${PC_SOCKET_PATH:-${toString config.process.process-compose.unix-socket}} \
@@ -51,7 +53,11 @@ in
       settings = {
         version = "0.5";
         is_strict = true;
+        # TODO: not a process-compose setting
+        # TODO: never used in command
         port = lib.mkDefault 9999;
+        # TODO: not a process-compose setting
+        # TODO: never used in command. process.process-compose.tui is.
         tui = lib.mkDefault true;
         environment = lib.mapAttrsToList
           (name: value: "${name}=${toString value}")

src/modules/processes.nix

@@ -70,7 +70,7 @@ in
               default = true;
             };
             unix-socket = lib.mkOption {
-              type = types.str;
+              type = types.str; # TODO: should be path?
               description = "The path to the Unix socket.";
               default = "${config.devenv.runtime}/pc.sock";
               defaultText = lib.literalExpression "\${config.devenv.runtime}/pc.sock";