Documentation for stdout does not mention flushing

[Lonami]

From rust-dc/fish-manpage-completions#96 (comment).

The documentation for std::io::stdout() does not mention "flush" anywhere, neither does Stdout or StdoutLock. I think it would be helpful for the documentation to indicate the behaviour, i.e. if it should be flushed manually or it's flushed once it goes out of scope.

The same would apply for stderr. I'm not sure if the behaviour of #23205 has changed since, or whether not documenting flushing was an oversight or intended to allow breakage in that regard.

[hkBst]

A buffered output stream collects output into a buffer before sending it on to the real output, which ultimately happens via a call to the kernel. It prevents the inefficiency of a kernel call for each character, but has the added complexity of needing to output the contents of its buffer to the real output. This is called flushing the buffer. Output that gets added to the buffer but not flushed will not really be output and will not be seen on the screen or written to disk as the case may be.

No other knowledge seems necessary, so

@rustbot label E-easy

[pcorwin]

@rustbot claim