Documented return codes of mg_read()

The used scheme itself is all traditional, and documenting it was trivial, but having such things documented makes me feel better as API user.