Add comment that the return value is the number of bytes written.