updated doc with new function. fixed example using inplace division