updated description and API for recent changes