clarified docs for path()