updated doc; fixes #270