BASH_SUBSHELL documentation misleading

[Sam Liddicott]

Configuration Information [Automatically generated, do not change]:
Machine: i686
OS: linux-gnu
Compiler: gcc
Compilation CFLAGS:  -DPROGRAM='bash' -DCONF_HOSTTYPE='i686' 
-DCONF_OSTYPE='linux-gnu' -DCONF_MACHTYPE='i686-pc-linux-gnu' 
-DCONF_VENDOR='pc' -DLOCALEDIR='/usr/share/locale' -DP$ uname output: 
Linux sojo 2.6.35-28-generic-pae #49-Ubuntu SMP Tue Mar 1 14:58:06 UTC 
2011 i686 GNU/Linux
Machine Type: i686-pc-linux-gnu

Bash Version: 4.1
Patch Level: 5
Release Status: release

Description:
        man page says:

        BASH_SUBSHELL
              Incremented by one each time a subshell or subshell  
environment
              is spawned.  The initial value is 0.

        This suggests that:

        echo $BASH_SUBSHELL ; ( echo ) ; echo $BASH_SUBSHELL

        would not give the same answer for BASH_SUBSHELL

Fix:
        As it behaves more like a depth counter than a serial number
        maybe it should say

        BASH_SUBSHELL
              Incremented by one in each nested subshell or subshell 
evironment.
              It is always 0 when $BASH_PID=$$