some misc cleanup not affecting functionality
update README for API changes