tests for new interface. updated doc.