[jdk17] RFR: JDK-8268774: Residual logging output written to STDOUT, not STDERR [v2]

Jonathan Gibbons jjg at openjdk.java.net
Wed Jun 16 17:52:22 UTC 2021


> Please review an interim minimal fix to write logging messages from the javadoc tool to STDERR, not STDOUT.
> 
> Recent work focussed on the use of the `Reporter` API in doclets, including the standard doclet. This patch aligns the tool code with the same policies as used in the doclet (and indirectly, in javac.)
> 
> Given we're in RDP1, the fix is intentionally minimal. The direct use of JavadocLog.printRawLines is a definite code-smell, and the `notice` methods in `ToolEnvironment` are seemingly obsolete and could be replaced by more appropriate API in `JavadocLog`. JDK-8268831 is a follow-up issue to address these issues.

Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:

  update copyright years

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

Changes:
  - all: https://git.openjdk.java.net/jdk17/pull/68/files
  - new: https://git.openjdk.java.net/jdk17/pull/68/files/cb28d35f..b48f3033

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk17&pr=68&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk17&pr=68&range=00-01

  Stats: 2 lines in 2 files changed: 0 ins; 0 del; 2 mod
  Patch: https://git.openjdk.java.net/jdk17/pull/68.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk17 pull/68/head:pull/68

PR: https://git.openjdk.java.net/jdk17/pull/68


More information about the javadoc-dev mailing list