ENH: minor code refactoring to support sub-classes better

     added generic docstrings for sub-classes
     update/keys methods corrected for sub-classess
     more tests

Author: jreback