more updated doc
clean up in misc