On Thu, Mar 24, 2011 at 06:07:33PM +0000, Marc Herbert wrote: > Not every feature is complicated enough that it requires special > documentation care and that it raises a discussion here.
BASH_SUBSHELL isn't complicated at all. It's just documented in a confusing way. It doesn't require an example to say that it reports the current subshell depth. It's just that the existing documentation can be interpreted to make someone think that it tracks a running total of how many subshells were created as children of the current shell in the past. That's where Sam got mixed up.
