make/Docs.gmk
changeset 52714 2e52aa822c57
parent 52318 124af9276e44
child 52940 26e2cfebcfba
child 57049 d13c49f43710
equal deleted inserted replaced
52713:8586613959f0 52714:2e52aa822c57
   330 
   330 
   331   ifeq ($$($1_JAVADOC_CMD), )
   331   ifeq ($$($1_JAVADOC_CMD), )
   332     $1_JAVADOC_CMD := $$(JAVA) -Djava.awt.headless=true $$($1_JAVA_ARGS) \
   332     $1_JAVADOC_CMD := $$(JAVA) -Djava.awt.headless=true $$($1_JAVA_ARGS) \
   333         $$(NEW_JAVADOC)
   333         $$(NEW_JAVADOC)
   334   else
   334   else
   335     $1_OPTIONS += $$(addprefix -J, $$($1_JAVA_ARGS)) 
   335     $1_OPTIONS += $$(addprefix -J, $$($1_JAVA_ARGS))
   336   endif
   336   endif
   337 
   337 
   338   $1_VARDEPS := $$($1_JAVA_ARGS) $$($1_OPTIONS) $$(MODULES_SOURCE_PATH) \
   338   $1_VARDEPS := $$($1_JAVA_ARGS) $$($1_OPTIONS) $$(MODULES_SOURCE_PATH) \
   339       $$($1_ALL_MODULES) $$($1_JAVADOC_CMD)
   339       $$($1_ALL_MODULES) $$($1_JAVADOC_CMD)
   340   $1_VARDEPS_FILE := $$(call DependOnVariable, $1_VARDEPS, \
   340   $1_VARDEPS_FILE := $$(call DependOnVariable, $1_VARDEPS, \
   464 
   464 
   465 ################################################################################
   465 ################################################################################
   466 # Setup generation of the reference Java SE API documentation (javadoc + modulegraph)
   466 # Setup generation of the reference Java SE API documentation (javadoc + modulegraph)
   467 
   467 
   468 # The reference javadoc is just the same as javase, but using the BootJDK javadoc
   468 # The reference javadoc is just the same as javase, but using the BootJDK javadoc
   469 # and a stable set of javadoc options.  Typically it is used for generating 
   469 # and a stable set of javadoc options.  Typically it is used for generating
   470 # diffs between the reference javadoc and a javadoc bundle of a specific build
   470 # diffs between the reference javadoc and a javadoc bundle of a specific build
   471 # generated in the same way.
   471 # generated in the same way.
   472 
   472 
   473 $(eval $(call SetupApiDocsGeneration, REFERENCE_API, \
   473 $(eval $(call SetupApiDocsGeneration, REFERENCE_API, \
   474     MODULES := $(JAVASE_MODULES), \
   474     MODULES := $(JAVASE_MODULES), \
   540 
   540 
   541   $(foreach m, $(ALL_MODULES), \
   541   $(foreach m, $(ALL_MODULES), \
   542     $(eval SPECS_$m := $(call FindModuleSpecsDirs, $m)) \
   542     $(eval SPECS_$m := $(call FindModuleSpecsDirs, $m)) \
   543     $(foreach d, $(SPECS_$m), \
   543     $(foreach d, $(SPECS_$m), \
   544       $(if $(filter %.md, $(call CacheFind, $d)), \
   544       $(if $(filter %.md, $(call CacheFind, $d)), \
   545         $(eval $m_$d_NAME := CONVERT_MARKDOWN_$m_$(strip $(call RelativePath, $d, $(TOPDIR)))) \
   545         $(eval $m_$d_NAME := SPECS_TO_HTML_$m_$(strip $(call RelativePath, $d, $(TOPDIR)))) \
   546         $(eval $(call SetupProcessMarkdown, $($m_$d_NAME), \
   546         $(eval $(call SetupProcessMarkdown, $($m_$d_NAME), \
   547             SRC := $d, \
   547             SRC := $d, \
   548             FILES := $(filter %.md, $(call CacheFind, $d)), \
   548             FILES := $(filter %.md, $(call CacheFind, $d)), \
   549             DEST := $(DOCS_OUTPUTDIR)/specs/, \
   549             DEST := $(DOCS_OUTPUTDIR)/specs/, \
   550             CSS := $(GLOBAL_SPECS_DEFAULT_CSS_FILE), \
   550             CSS := $(GLOBAL_SPECS_DEFAULT_CSS_FILE), \
   551         )) \
   551         )) \
   552         $(eval JDK_SPECS_TARGETS += $($($m_$d_NAME))) \
   552         $(eval JDK_SPECS_TARGETS += $($($m_$d_NAME))) \
   553       ) \
   553       ) \
   554     ) \
   554     ) \
   555   )
   555   )
       
   556 
       
   557   # For all markdown files in $module/share/man directories, convert them to
       
   558   # html.
       
   559   $(foreach m, $(ALL_MODULES), \
       
   560     $(eval MAN_$m := $(call FindModuleManDirs, $m)) \
       
   561     $(foreach d, $(MAN_$m), \
       
   562       $(if $(filter %.md, $(call CacheFind, $d)), \
       
   563         $(eval $m_$d_NAME := MAN_TO_HTML_$m_$(strip $(call RelativePath, $d, $(TOPDIR)))) \
       
   564         $(eval $(call SetupProcessMarkdown, $($m_$d_NAME), \
       
   565             SRC := $d, \
       
   566             FILES := $(filter %.md, $(call CacheFind, $d)), \
       
   567             DEST := $(DOCS_OUTPUTDIR)/specs/man, \
       
   568             CSS := $(GLOBAL_SPECS_DEFAULT_CSS_FILE), \
       
   569             REPLACEMENTS := @@VERSION_SHORT@@ => $(VERSION_SHORT), \
       
   570         )) \
       
   571         $(eval JDK_SPECS_TARGETS += $($($m_$d_NAME))) \
       
   572       ) \
       
   573     ) \
       
   574   )
       
   575 
       
   576   # The html generated from markdown also needs the css file
       
   577   JDK_SPECS_TARGETS += $(COPY_GLOBAL_RESOURCES)
   556 endif
   578 endif
   557 
   579 
   558 # Special treatment for generated documentation
   580 # Special treatment for generated documentation
   559 
   581 
   560 JDWP_PROTOCOL := $(SUPPORT_OUTPUTDIR)/gensrc/jdk.jdi/jdwp-protocol.html
   582 JDWP_PROTOCOL := $(SUPPORT_OUTPUTDIR)/gensrc/jdk.jdi/jdwp-protocol.html