Say that a config file's env: section overrides the environment (closes #128)

A variable named in the config file's env: section is set while the file loads, so it overrides both the environment the process was started with and the file's own key. README.md and the config.example.yml header said only that a variable wins over the file; they now state this exception where the precedence is given. Model: opus-5-5
2026-09-28 10:32:05 +00:00
parent 2005143e3d
commit b1dc65761b
2 changed files with 11 additions and 5 deletions
@@ -4,7 +4,10 @@
 # this file: PIXA_ plus the key in upper case, with "." written as "_"
 # (state_dir is PIXA_STATE_DIR, metrics.username is
 # PIXA_METRICS_USERNAME). The one exception is port, which is set by
-# PORT. In a variable, a list is comma-separated.
+# PORT. In a variable, a list is comma-separated. A variable named in
+# this file's env: section is set while the file loads, so it overrides
+# both the environment the process was started with and this file's own
+# key.

 # Server settings
 port: 8080