On 2017-04-20 00:54, Mandy Chung wrote:
On Apr 19, 2017, at 5:36 AM, Magnus Ihse Bursie wrote:

WebRev: http://cr.openjdk.java.net/~ihse/JDK-8178038-javadoc-specs/webrev.01
  368 JDWP_PROTOCOL := $(SUPPORT_OUTPUTDIR)/gensrc/jdk.jdi/jdwp-protocol.html
  369 $(eval $(call SetupCopyFiles, COPY_JDWP_PROTOCOL, \
  370     FILES := $(JDWP_PROTOCOL), \
  371     DEST := $(JAVADOC_OUTPUTDIR)/specs/jdwp, \
  372 ))

Is there any reason why jdwp-protocol.html is not copied to the “specs” 
directory?
Yes, there is. This document is only part of the jdwp specification. This is dynamically generated. The rest of the jdwp specification is static. I have a prototype that, in light of JEP 299, copies the rest of the specification to "specs/jdwp", but at the moment it's unclear if that's going to get into JDK 9. Nevertheless, I think it is prudent to prepare for this structure.

docs-docs-specs copies specs to jdk docs.  I would expect there will be 
docs-javase-specs to copy specs from Java SE modules to javase-docs/specs but 
missing.
You mean docs-jdk-specs?

While there is a superficial similarity between "docs-jdk" and "docs-javase", there's a difference in purpose. The latter is only created for a special-purpose formal API verification, and is not supposed to be shipped. This means that it's not built by e.g. "docs-image". I assumed that only the API would be needed for that.

/Magnus


Mandy

Reply via email to