api cleanup. See #13
Document reversion
misc fixes