updated doc/comments