Extensionality Improvement in Main.gmk & Docs.gmk to generate docs (original) (raw)

Erik Joelsson erik.joelsson at oracle.com
Mon Apr 30 15:14:11 UTC 2018


Hello,

On 2018-04-30 04:14, Archana Nogriya wrote:

However the patch for the second partis related to locating jvmti.html, VM's like openj9 has it's own html specs file in different location hence we need extension to set it appropriately. Yes, I see the reason for the change, but my concern was that the patch below looks like it's changing 6 lines, but in reality, I can only see a difference in one of them. That difference is also the only difference needed as far as I can see. I just want confirmation that that is the case.

/Erik

#  Get jvmti.html from the main jvm variant (all variants' jvmti.html are identical). -JVMTIHTML := $(HOTSPOTOUTPUTDIR)/variant-$(JVMVARIANTMAIN)/gensrc/jvmtifiles/jvmti.html _-$(eval $(call SetupCopyFiles, COPYJVMTIHTML, _ _-    FILES := $(JVMTIHTML), _ _-    DEST := $(DOCSOUTPUTDIR)/specs, _ -)) -JDKSPECSTARGETS += $(COPYJVMTIHTML) +JVMTIHTML ?= $(HOTSPOTOUTPUTDIR)/variant-$(JVMVARIANTMAIN)/gensrc/jvmtifiles/jvmti.html _+$(eval $(call SetupCopyFiles, COPYJVMTIHTML, _ _+    FILES := $(JVMTIHTML), _ _+    DEST := $(DOCSOUTPUTDIR)/specs, _ +)) +JDKSPECSTARGETS += $(COPYJVMTIHTML)

Thanks and Regards Archana Nogriya

From: Erik Joelsson <erik.joelsson at oracle.com> To: Archana Nogriya <archana.nogriya at uk.ibm.com> Cc: build-dev at openjdk.java.net, David Holmes <david.holmes at oracle.com> Date: 27/04/2018 18:05 Subject: Re: Extensionality Improvement in Main.gmk & Docs.gmk to generate docs ------------------------------------------------------------------------ Looking at this again, the first part, in Main.gmk, has already been addressed in https://bugs.openjdk.java.net/browse/JDK-8198425 <https://urldefense.proofpoint.com/v2/url?u=https-3A_bugs.openjdk.java.netbrowseJDK-2D8198425&d=DwMD-g&c=jfiaSHvJObTbx-siA1ZOg&r=-MGd855q-LKvODp9rnOf8dEjvpiN59orrOxhf9virII&m=3vzRAU-D2yC7wKbEcUUaW00BZqwtnO0QE2mLK2bedww&s=MTZyeZsgQdHGdxjTKHpcljddxJiFvJBfxSsSxchz8k&e=>. The patch for the second part looks weird. The only real change I can see is the ?= for the jvmti.html file. The rest looks like there is no difference (and I cannot think of any change needed there either). /Erik On 2018-04-27 02:12, Archana Nogriya wrote: Thanks Erik, It will be great if you can sponsor for this contribution please. Thanks and Regards Archana Nogriya IBM Java Runtime, Open Java Developer IBM Hursley Tel: Internal - 247073, External - +44 (0) 1962 81 7073 Office Mobile: 07500095480 Email: archana.nogriya at uk.ibm.com <mailto:archana.nogriya at uk.ibm.com> From: Erik Joelsson <erik.joelsson at oracle.com> <mailto:erik.joelsson at oracle.com> To: Archana Nogriya <archana.nogriya at uk.ibm.com> <mailto:archana.nogriya at uk.ibm.com>, build-dev at openjdk.java.net <mailto:build-dev at openjdk.java.net> Cc: David Holmes <david.holmes at oracle.com> <mailto:david.holmes at oracle.com> Date: 26/04/2018 17:15 Subject: Re: Extensionality Improvement in Main.gmk & Docs.gmk to generate docs ------------------------------------------------------------------------ Looks reasonable. /Erik On 2018-04-26 04:00, Archana Nogriya wrote: If we have a conditional variable to set "hotspot-$(JVMVARIANTMAIN)-gensrc" target then this can give way to alternate VMs like eclipse openj9 to extend that to set it appropriately. diff --git a/make/Main.gmk b/make/Main.gmk index 731e9c9934..444a835cb4 100644 --- a/make/Main.gmk +++ b/make/Main.gmk @@ -830,7 +830,8 @@ else  docs-reference-api-modulegraph: exploded-image buildtools-modules  # The gensrc steps for hotspot and jdk.jdi create html spec files. _-  docs-jdk-specs: jdk.jdi-gensrc _ +  JVMDOCSSPECTARGET ?= hotspot-$(JVMVARIANTMAIN)-gensrc _+  docs-jdk-specs: $(JVMDOCSSPECTARGET) jdk.jdi-gensrc _  docs-jdk-index ###################################################################################### diff --git a/make/Docs.gmk b/make/Docs.gmk index 644ffbf74a..73ffb8ebd2 100644 --- a/make/Docs.gmk +++ b/make/Docs.gmk _@@ -561,12 +561,12 @@ (eval(eval (eval(call SetupCopyFiles, COPYJDWPPROTOCOL, _  JDKSPECSTARGETS += $(COPYJDWPPROTOCOL) #  Get jvmti.html from the main jvm variant (all variants' jvmti.html are identical). -JVMTIHTML := $(HOTSPOTOUTPUTDIR)/variant-$(JVMVARIANTMAIN)/gensrc/jvmtifiles/jvmti.html _-$(eval $(call SetupCopyFiles, COPYJVMTIHTML, _ _-    FILES := $(JVMTIHTML), _ _-    DEST := $(DOCSOUTPUTDIR)/specs, _ -)) -JDKSPECSTARGETS += $(COPYJVMTIHTML) +JVMTIHTML ?= $(HOTSPOTOUTPUTDIR)/variant-$(JVMVARIANTMAIN)/gensrc/jvmtifiles/jvmti.html _+$(eval $(call SetupCopyFiles, COPYJVMTIHTML, _ _+    FILES := $(JVMTIHTML), _ _+    DEST := $(DOCSOUTPUTDIR)/specs, _ +)) +JDKSPECSTARGETS += $(COPYJVMTIHTML) Note: This proposal has been tested in local. Thanks and Regards Archana Nogriya IBM Java Runtime, Open Java Developer IBM Hursley Tel: Internal - 247073, External - +44 (0) 1962 81 7073 Office Mobile: 07500095480 Email: archana.nogriya at uk.ibm.com <mailto:archana.nogriya at uk.ibm.com> Unless stated otherwise above: IBM United Kingdom Limited - Registered in England and Wales with number 741598. Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU Unless stated otherwise above: IBM United Kingdom Limited - Registered in England and Wales with number 741598. Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU Unless stated otherwise above: IBM United Kingdom Limited - Registered in England and Wales with number 741598. Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU



More information about the build-dev mailing list