documented an alias and vectorized the root function
debug option