P4 Description
While working on JDK-8236435 it was found that `com.sun.tools.javap.DisassemblerTool` shares a lot of its documentation with `javax.tools.JavaCompiler`. While the common bits are relevant to `JavaCompiler`, they are irrelevant to `DisassemblerTool`. This suggests copy-paste from the `JavaCompiler` to `DisassemblerTool`.
`DisassemblerTool` does not belong to public API the same way `javax.tools.JavaCompiler` and `javax.tools.DocumentationTool` do. It doesn't seem to be implemented either (note that `com.sun.tools.javap.DisassemblerTool.DisassemblerTask` is implemented by `com.sun.tools.javap.JavapTask`).
That said, the proposal is to investigate the possibility of removing that interface altogether. If removing proves impossible, we should at least fix the documentation.
`DisassemblerTool` does not belong to public API the same way `javax.tools.JavaCompiler` and `javax.tools.DocumentationTool` do. It doesn't seem to be implemented either (note that `com.sun.tools.javap.DisassemblerTool.DisassemblerTask` is implemented by `com.sun.tools.javap.JavapTask`).
That said, the proposal is to investigate the possibility of removing that interface altogether. If removing proves impossible, we should at least fix the documentation.