updated doc for transitive option