Document librados's rados_write's behaviour in reguards to return value.
Merge pull request #937 from christian-marie/master

Document librados's rados_write's behaviour in reguards to return value.