RFR: JDK-8178037 Move information from jdi-overview.html into jdk.jdi module-info.java

[Alan Bateman]

On 19/04/2017 13:54, Magnus Ihse Bursie wrote:

> With JDK-8172312, the file src/jdk.jdi/share/classes/jdi-overview.html 
> is no longer included in the generated documentation. The information 
> provided by that file should move to 
> src/jdk.jdi/share/classes/module-info.java instead.
>
> I also took the liberty of removing a bunch of other overview.html 
> files that are not included in the Javadoc anymore. They provided no 
> real informational value, and what text they contained is already 
> expressed similarly or better in the corresponding module-info.java 
> files instead.
>
> Bug: https://bugs.openjdk.java.net/browse/JDK-8178037
> WebRev: 
> http://cr.openjdk.java.net/~ihse/JDK-8178037-fix-obsolete-overview-files/webrev.01
The serviceability-dev mailing list is the best place to discuss the 
debugger API.

However, what you have looks okay. I think I would use the opportunity 
to replace "The JDI" with just "JDI" in the second and third paragraphs.

-Alan