Clarify the git_remote_ls() documentation

Provide a better error message in case there's no transport and describe more clearly which list of references we mean and how long it remains alive.