make/Javadoc.gmk
changeset 39935 6016bd47edc9
parent 39932 a0794ee00a5b
parent 39930 c35da27e81c2
child 40241 59abac94e4f2
equal deleted inserted replaced
39934:9c84ee88dd3a 39935:6016bd47edc9
   574 #
   574 #
   575 
   575 
   576 ALL_OTHER_TARGETS += tagletapidocs
   576 ALL_OTHER_TARGETS += tagletapidocs
   577 TAGLETAPI_DOCDIR := $(OLD_DOCLET_DIR)/taglet
   577 TAGLETAPI_DOCDIR := $(OLD_DOCLET_DIR)/taglet
   578 TAGLETAPI2COREAPI := ../../../$(JDKJRE2COREAPI)
   578 TAGLETAPI2COREAPI := ../../../$(JDKJRE2COREAPI)
       
   579 TAGLETAPI_DOCTITLE := Taglet API
       
   580 TAGLETAPI_WINDOWTITLE := Taglet API
       
   581 TAGLETAPI_HEADER := <strong>Taglet API</strong>
   579 TAGLETAPI_BOTTOM := $(call CommonTrademarkBottom,$(TAGLETAPI_FIRST_COPYRIGHT_YEAR))
   582 TAGLETAPI_BOTTOM := $(call CommonTrademarkBottom,$(TAGLETAPI_FIRST_COPYRIGHT_YEAR))
   580 # TAGLETAPI_FILE is located in NON_CORE_PKGS.gmk
   583 # TAGLETAPI_FILE is located in NON_CORE_PKGS.gmk
   581 
   584 
   582 # Temporary directory (special generation rules)
       
   583 TAGLETAPI_TEMPDIR = $(DOCSTMPDIR)/taglets_temp
       
   584 
       
   585 # The index.html, options, and packages files
   585 # The index.html, options, and packages files
   586 TAGLETAPI_INDEX_FILE = $(TAGLETAPI_DOCDIR)/com/sun/tools/doclets/Taglet.html
   586 TAGLETAPI_INDEX_FILE = $(TAGLETAPI_DOCDIR)/index.html
   587 TAGLETAPI_OPTIONS_FILE = $(DOCSTMPDIR)/tagletapi.options
   587 TAGLETAPI_OPTIONS_FILE = $(DOCSTMPDIR)/tagletapi.options
   588 TAGLETAPI_PACKAGES_FILE = $(DOCSTMPDIR)/tagletapi.packages
   588 TAGLETAPI_PACKAGES_FILE = $(DOCSTMPDIR)/tagletapi.packages
   589 
   589 
   590 # The modules required to be documented
   590 # The modules required to be documented
   591 TAGLETAPI_MODULES = jdk.javadoc
   591 TAGLETAPI_MODULES = jdk.javadoc
   592 
   592 
   593 tagletapidocs: $(TAGLETAPI_INDEX_FILE)
   593 tagletapidocs: $(TAGLETAPI_INDEX_FILE)
   594 
   594 
   595 # Set relative location to core api document root
       
   596 $(TAGLETAPI_INDEX_FILE): GET2DOCSDIR=$(TAGLETAPI2COREAPI)/..
       
   597 
       
   598 # Run javadoc if the index file is out of date or missing
   595 # Run javadoc if the index file is out of date or missing
   599 $(TAGLETAPI_INDEX_FILE): $(TAGLETAPI_OPTIONS_FILE) $(TAGLETAPI_PACKAGES_FILE) $(COREAPI_INDEX_FILE)
   596 $(TAGLETAPI_INDEX_FILE): $(TAGLETAPI_OPTIONS_FILE) $(TAGLETAPI_PACKAGES_FILE) $(COREAPI_INDEX_FILE)
   600 	$(prep-javadoc)
   597 	$(prep-javadoc)
   601 	$(RM) -r $(TAGLETAPI_TEMPDIR)
       
   602 	$(MKDIR) -p $(TAGLETAPI_TEMPDIR)
       
   603 	$(call JavadocSummary,$(TAGLETAPI_OPTIONS_FILE),$(TAGLETAPI_PACKAGES_FILE))
   598 	$(call JavadocSummary,$(TAGLETAPI_OPTIONS_FILE),$(TAGLETAPI_PACKAGES_FILE))
   604 	$(JAVADOC_CMD_SMALL) -d $(TAGLETAPI_TEMPDIR) \
   599 	$(JAVADOC_CMD_SMALL) -d $(@D) \
   605 	    @$(TAGLETAPI_OPTIONS_FILE) @$(TAGLETAPI_PACKAGES_FILE)
   600 	    @$(TAGLETAPI_OPTIONS_FILE) @$(TAGLETAPI_PACKAGES_FILE)
   606 	cp -r $(TAGLETAPI_TEMPDIR)/com $(TAGLETAPI_DOCDIR)
       
   607 	cp $(TAGLETAPI_TEMPDIR)/stylesheet.css $(TAGLETAPI_DOCDIR)
       
   608 	$(RM) -r $(TAGLETAPI_TEMPDIR)
       
   609 
   601 
   610 # Create file with javadoc options in it
   602 # Create file with javadoc options in it
   611 $(TAGLETAPI_OPTIONS_FILE):
   603 $(TAGLETAPI_OPTIONS_FILE):
   612 	$(prep-target)
   604 	$(prep-target)
   613 	@($(call COMMON_JAVADOCFLAGS) ; \
   605 	@($(call COMMON_JAVADOCFLAGS) ; \
   615 	  $(call OptionOnly,-Xdoclint:all) ; \
   607 	  $(call OptionOnly,-Xdoclint:all) ; \
   616           $(call OptionPair,-system,none) ; \
   608           $(call OptionPair,-system,none) ; \
   617 	  $(call OptionPair,-modulesourcepath,$(RELEASEDOCS_MODULESOURCEPATH)) ; \
   609 	  $(call OptionPair,-modulesourcepath,$(RELEASEDOCS_MODULESOURCEPATH)) ; \
   618 	  $(call OptionPair,-addmods,$(TAGLETAPI_MODULES)) ; \
   610 	  $(call OptionPair,-addmods,$(TAGLETAPI_MODULES)) ; \
   619 	  $(call OptionPair,-encoding,ascii) ; \
   611 	  $(call OptionPair,-encoding,ascii) ; \
       
   612 	  $(call OptionOnly,-breakiterator) ; \
       
   613 	  $(call OptionPair,-doctitle,$(TAGLETAPI_DOCTITLE)) ; \
       
   614 	  $(call OptionPair,-windowtitle,$(TAGLETAPI_WINDOWTITLE) $(DRAFT_WINTITLE)); \
       
   615 	  $(call OptionPair,-header,$(TAGLETAPI_HEADER)$(DRAFT_HEADER)) ; \
   620 	  $(call OptionOnly,-nonavbar) ; \
   616 	  $(call OptionOnly,-nonavbar) ; \
   621 	  $(call OptionOnly,-noindex) ; \
   617 	  $(call OptionOnly,-noindex) ; \
   622 	  $(call OptionPair,-bottom,$(TAGLETAPI_BOTTOM)$(DRAFT_BOTTOM)) ; \
   618 	  $(call OptionPair,-bottom,$(TAGLETAPI_BOTTOM)$(DRAFT_BOTTOM)) ; \
   623 	  $(call OptionTrip,-linkoffline,$(TAGLETAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
   619 	  $(call OptionTrip,-linkoffline,$(TAGLETAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
   624 	) >> $@
   620 	) >> $@