RFR: JDK-8178038, JDK-8178039, JDK-8178316 Javadoc specs directory

[Mandy Chung]

> On Apr 20, 2017, at 9:55 AM, Alan Bateman <Alan.Bateman at oracle.com> wrote:
> 
> On 20/04/2017 17:47, Mandy Chung wrote:
> 
>> In this case, which module should jdwp-protocol.html spec belong to?  Not jdk.jdwp.agent then.
>> The suggestion of the modular specs layout in the docs bundle may not apply.
>> 
> jdwp-protocol.html is the JDWP protocol so it's implemented by both the debugger and debugee. Typically the debugger sends a command and the debuggee responds with a reply. There are also event messages that the target VM/debuggee sends to the debugger. If there is place for Java SE documentation then it might be best to put it there rather than trying to put it in jdk.jdi or jdk.jdwp.agent.

Agree.

Magnus’s proposed patch to put jdwp-protocol.html in the spec/jdwp directory is fine.

Mandy