more code cleanup and apidoc enhancements.
minor fixes.
One more class documented.