Re: BASH_SUBSHELL documentation misleading

[Greg Wooledge]

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.