It appears that, when code includes a construct such
as the following the documentation generator fails to
recognise that one class is nested within another.
Consequence is that all documentation items from the
nested class on are treated as having come from a new
def a ( self ):
def b ( self, x ):
In this case 'b' will be documented as if it were a
method in class 'bar' (rather than 'foo').