RFR: JDK-8268831: Improve javadoc tool handling of streams.

[Jonathan Gibbons]

On Fri, 14 Jan 2022 16:12:22 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

> Looks good to me.
> 
> Am I right in the assumption that the writer for `WriterKind.NOTICE` in javadoc is always stdout? I couldn't figure out where the writers are set (I guess it is somewhere in jdk.compiler code).

This was changed a short while back.   All diagnostics (ERROR, WARNING, NOTICE) go to `stderr` or its equivalent.  `stdout` is only used for output that is "requested" by the user, where the output is the result of the requested action, like command-line help from `--help`.  Although it's not a defining specification, there's a good wikipedia article on [Standard Streams](https://en.wikipedia.org/wiki/Standard_streams).

-------------

PR: https://git.openjdk.java.net/jdk/pull/6950