Clean up some documentation

clang's docparser highlighted these.
remote: fix git_remote_download() documentation

The description of what the function does hasn't been true for quite a
while. Change it to reflect the way it currently works.

While here, remove an even older comment about missing features that
have been implemented.
Merge pull request #1745 from libgit2/doc-fixes

Doc fixes