Improve the docstring of elpy-project-root.

In particular, mention that lisp programs should not use the variable,
but instead call the same-named function.

Fixes #378.