some installation info in README
some api cleanup