testmark-bash

testmarktest_rule_basic: document that BASH_ENV doesn't reach the case.

commit e2e23564a8fa64eacfdd6e4bb0107c01c2c9e184 · parent b5670a2707 · browse this tree
Ximianth, 2026-10-24 15:46:56 UTC

diff --git a/lib/testmark.bash b/lib/testmark.bash
index 7b0a1ba..4d62194 100644
--- a/lib/testmark.bash
+++ b/lib/testmark.bash
@@ -104,7 +104,7 @@ testmark_check() { _testmark_call _testmark_check "$@"; }
 ## and checks what FN prints, stdout and stderr together, against the case's `output` hunk, using testmark_check.
 ## If FN exits nonzero, a line `exit status: N` is added to its output before the check.
 ##
-## FN runs under `set -euo pipefail`.  It sees exported variables, but no other variables, and no functions but itself and those given to testmarktest_provide.
+## FN runs under `set -euo pipefail`.  It sees exported variables (except BASH_ENV, so its bash starts clean), but no other variables, and no functions but itself and those given to testmarktest_provide.
 ##
 ## - @param $1 GLOB: a bash pattern, matched against whole hunk names; `*` matches `/` too.
 ## - @param $2 FN: the name of a defined function.