PERL-322 change and document return value of recv

Previously, MongoDB::MongoClient::recv had a void return and its
documentation was completely wrong.

This commit passes through the result of mongo_link_hear, addressing a
coverity complaint about an ignored return value.  It also changes the
documentation to minimally reflect what the function actually does.