remove obsolete comments
api docs
make methods private where appropriate