RFR: JDK-8267204: Expose access to underlying streams in DocletEnvironment

[Pavel Rappo]

On Tue, 18 May 2021 23:41:47 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> 1. Reporter says nothing about streams.  javadoc is inconsistent with javac and when run with two streams, it sends warnings and errors to one stream and notes to the other.  javac now sends all diagnostics to the error stream, leaving stdout for command-line help etc.   This PR is part 1 of 2; having made both streams explicitly available here, part 2 will align javadoc with javac.   Also, DocletEnvironment seemed a more appropriate place to expose the streams.

I can see that Reporter does not mention streams. But should it mention them given that Reporter is a higher-level abstraction? If a particular mapping between diagnostic kinds and standard streams is desired can it be achieved by configuring Reporter out of band?

What would be the best code locations to look at to get familiar with how javac works with standard streams, diagnostic output, and the like?

Don't get me wrong, by asking these questions I'm trying to better understand the intent and the design.

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

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