Merge "Clarify docs for CharsetEncoder#flush."