From 2c271e9693617605035ca302ed28039cac845222 Mon Sep 17 00:00:00 2001 From: Noah765 Date: Tue, 16 Jun 2026 17:33:52 +0200 Subject: [PATCH] docs(wrapperModules.nushell): add notes about the differences to normal config file placement --- wrapperModules/n/nushell/module.nix | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/wrapperModules/n/nushell/module.nix b/wrapperModules/n/nushell/module.nix index 1a22597e..4505170a 100644 --- a/wrapperModules/n/nushell/module.nix +++ b/wrapperModules/n/nushell/module.nix @@ -19,6 +19,11 @@ Provide either `.content` to inline the file contents or `.path` to reference an existing file. This file is passed to Nushell using `--env-config`, and is typically used to define environment variables or startup commands that apply to all shells. + + Note that Nushell also reads this file in non-interactive environments unless + `--no-config-file` is specified. This is a subtle yet significant difference from + placing the config file at $XDG_CONFIG_HOME/nushell/env.nu. For more details, see + https://www.nushell.sh/book/configuration.html#flag-behavior. ''; }; "config.nu" = lib.mkOption { @@ -32,6 +37,11 @@ Provide either `.content` to inline the file contents or `.path` to reference an existing file. This file is passed to Nushell using `--config`, and controls general shell behavior, key bindings, and built-in command settings. + + Note that Nushell also reads this file in non-interactive environments unless + `--no-config-file` is specified. This is a subtle yet significant difference from + placing the config file at $XDG_CONFIG_HOME/nushell/config.nu. For more details, see + https://www.nushell.sh/book/configuration.html#flag-behavior. ''; }; };