From fcda12c8b162537c763f3467c0a96ff3d2e53296 Mon Sep 17 00:00:00 2001 From: Ethan Montgomery Date: Sun, 2 Jul 2023 13:59:22 -0400 Subject: [PATCH] Add informative note to the README.md Ref: https://www.gnu.org/software/bash/manual/html_node/The-Set-Builtin.html --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 38313b3..91a00ad 100644 --- a/README.md +++ b/README.md @@ -74,6 +74,11 @@ If the command fails, the error message will show the precise command that failed, and when `DEBUG=1` will then present you with a debug shell from which you can choose to continue or to exit your script. +Note that DEBUG traps are not normally inherited by shell functions, +command substitutions, and commands executed in a subshell environment +unless the shell option `functrace` is set +(`set -T` or `set -o functrace` will accomplish this). + #### Advanced Debugging This library contains an alternate debug trap that can be uncommented