make/Javadoc.gmk
changeset 43285 223c3eea12e4
parent 43171 61b58ba86188
child 43781 a36b72c53986
equal deleted inserted replaced
43282:45b751afd11e 43285:223c3eea12e4
    24 
    24 
    25 default: all
    25 default: all
    26 
    26 
    27 include $(SPEC)
    27 include $(SPEC)
    28 include MakeBase.gmk
    28 include MakeBase.gmk
       
    29 include $(JDK_TOPDIR)/make/Tools.gmk
    29 
    30 
    30 ################################################################################
    31 ################################################################################
    31 
    32 
    32 # List of all possible directories for javadoc to look for sources
    33 # List of all possible directories for javadoc to look for sources
    33 # Allow custom to overwrite.
    34 # Allow custom to overwrite.
   178     -tag serialData \
   179     -tag serialData \
   179     -tag factory \
   180     -tag factory \
   180     -tag see \
   181     -tag see \
   181     -tag 'jvms:a:See <cite>The Java&trade; Virtual Machine Specification</cite>:' \
   182     -tag 'jvms:a:See <cite>The Java&trade; Virtual Machine Specification</cite>:' \
   182     -tag 'jls:a:See <cite>The Java&trade; Language Specification</cite>:' \
   183     -tag 'jls:a:See <cite>The Java&trade; Language Specification</cite>:' \
       
   184     -taglet build.tools.taglet.Incubating \
       
   185     -tagletpath $(BUILDTOOLS_OUTPUTDIR)/jdk_tools_classes \
   183     #
   186     #
   184 
   187 
   185 DEFAULT_JAVADOC_OPTIONS := -XDignore.symbol.file=true -use -keywords -notimestamp \
   188 DEFAULT_JAVADOC_OPTIONS := -XDignore.symbol.file=true -use -keywords -notimestamp \
   186     -serialwarn -encoding ISO-8859-1 -breakiterator --system none
   189     -serialwarn -encoding ISO-8859-1 -breakiterator --system none
   187 
   190 
   309 
   312 
   310   # The index.html which is a marker for all the output from javadoc.
   313   # The index.html which is a marker for all the output from javadoc.
   311   $1_INDEX_FILE := $$(JAVADOC_OUTPUTDIR)/$$($1_OUTPUT_DIRNAME)/index.html
   314   $1_INDEX_FILE := $$(JAVADOC_OUTPUTDIR)/$$($1_OUTPUT_DIRNAME)/index.html
   312 
   315 
   313   # Rule for actually running javadoc
   316   # Rule for actually running javadoc
   314   $$($1_INDEX_FILE): $$($1_VARDEPS_FILE) $$($1_PACKAGE_DEPS) $$($1_DEPS)
   317   $$($1_INDEX_FILE): $(BUILD_TOOLS_JDK) $$($1_VARDEPS_FILE) $$($1_PACKAGE_DEPS) $$($1_DEPS)
   315 	$$(call LogWarn, Generating Javadoc from $$(words $$($1_PACKAGES)) package(s) for $$($1_OUTPUT_DIRNAME))
   318 	$$(call LogWarn, Generating Javadoc from $$(words $$($1_PACKAGES)) package(s) for $$($1_OUTPUT_DIRNAME))
   316 	$$(call MakeDir, $$(@D))
   319 	$$(call MakeDir, $$(@D))
   317         ifneq ($$($1_PACKAGES_FILE), )
   320         ifneq ($$($1_PACKAGES_FILE), )
   318 	  $$(eval $$(call ListPathsSafely, $1_PACKAGES, $$($1_PACKAGES_FILE)))
   321 	  $$(eval $$(call ListPathsSafely, $1_PACKAGES, $$($1_PACKAGES_FILE)))
   319         endif
   322         endif
   738 # Hook to include the corresponding custom file, if present.
   741 # Hook to include the corresponding custom file, if present.
   739 $(eval $(call IncludeCustomExtension, , Javadoc.gmk))
   742 $(eval $(call IncludeCustomExtension, , Javadoc.gmk))
   740 
   743 
   741 ################################################################################
   744 ################################################################################
   742 
   745 
   743 docs-javadoc: $(TARGETS)
   746 docs-javadoc: $(BUILD_TOOLS_JDK) $(TARGETS)
   744 
   747 
   745 docs-copy: $(COPY_TARGETS)
   748 docs-copy: $(COPY_TARGETS)
   746 
   749 
   747 docs-zip: $(ZIP_TARGETS)
   750 docs-zip: $(ZIP_TARGETS)
   748 
   751