Add documentation about flushing and flags.