mild clean ups.  documentation.  removed usage of some deprecated methods.