producer: clarify documentation around Flush*