make/Javadoc.gmk
changeset 27602 236555ddac42
parent 27560 adc258b13e2c
parent 27596 da40665398a4
child 28007 877ab0d032b8
equal deleted inserted replaced
27581:9fffb959eb41 27602:236555ddac42
    72 ATTACH_FIRST_COPYRIGHT_YEAR = 2005
    72 ATTACH_FIRST_COPYRIGHT_YEAR = 2005
    73 JCONSOLE_FIRST_COPYRIGHT_YEAR = 2006
    73 JCONSOLE_FIRST_COPYRIGHT_YEAR = 2006
    74 SCTPAPI_FIRST_COPYRIGHT_YEAR = 2009
    74 SCTPAPI_FIRST_COPYRIGHT_YEAR = 2009
    75 TRACING_FIRST_COPYRIGHT_YEAR = 2008
    75 TRACING_FIRST_COPYRIGHT_YEAR = 2008
    76 TREEAPI_FIRST_COPYRIGHT_YEAR = 2005
    76 TREEAPI_FIRST_COPYRIGHT_YEAR = 2005
       
    77 NASHORNAPI_FIRST_COPYRIGHT_YEAR = 2014
    77 JNLP_FIRST_COPYRIGHT_YEAR = 1998
    78 JNLP_FIRST_COPYRIGHT_YEAR = 1998
    78 PLUGIN2_FIRST_COPYRIGHT_YEAR = 2007
    79 PLUGIN2_FIRST_COPYRIGHT_YEAR = 2007
    79 JDKNET_FIRST_COPYRIGHT_YEAR = 2014
    80 JDKNET_FIRST_COPYRIGHT_YEAR = 2014
    80 
    81 
    81 # Oracle name
    82 # Oracle name
   135 # Otherwise, you get "No packages or classes specified." due
   136 # Otherwise, you get "No packages or classes specified." due
   136 # to $(PATH_SEP) being interpreted as an end of
   137 # to $(PATH_SEP) being interpreted as an end of
   137 # command (newline or shell ; character)
   138 # command (newline or shell ; character)
   138 ALL_SOURCE_DIRS := $(wildcard \
   139 ALL_SOURCE_DIRS := $(wildcard \
   139       $(JDK_TOPDIR)/src/*/share/classes \
   140       $(JDK_TOPDIR)/src/*/share/classes \
   140       $(JDK_TOPDIR)/src/*/$(OPENJDK_TARGET_OS_API_DIR)/classes \
   141       $(JDK_TOPDIR)/src/*/$(OPENJDK_TARGET_OS)/classes \
       
   142       $(JDK_TOPDIR)/src/*/$(OPENJDK_TARGET_OS_TYPE)/classes \
   141       $(LANGTOOLS_TOPDIR)/src/*/share/classes \
   143       $(LANGTOOLS_TOPDIR)/src/*/share/classes \
       
   144       $(NASHORN_TOPDIR)/src/*/share/classes \
   142       $(CORBA_TOPDIR)/src/*/share/classes \
   145       $(CORBA_TOPDIR)/src/*/share/classes \
   143       $(JAXP_TOPDIR)/src/*/share/classes \
   146       $(JAXP_TOPDIR)/src/*/share/classes \
   144       $(JAXWS_TOPDIR)/src/*/share/classes \
   147       $(JAXWS_TOPDIR)/src/*/share/classes \
   145       $(SUPPORT_OUTPUTDIR)/gensrc/j* \
   148       $(SUPPORT_OUTPUTDIR)/gensrc/j* \
   146       $(SUPPORT_OUTPUTDIR)/rmic/j* \
   149       $(SUPPORT_OUTPUTDIR)/rmic/j* \
   471 	  $(call OptionTrip,-group,$(DOCLETAPI_GROUPNAME),$(DOCLETAPI_REGEXP)); \
   474 	  $(call OptionTrip,-group,$(DOCLETAPI_GROUPNAME),$(DOCLETAPI_REGEXP)); \
   472 	  $(call OptionTrip,-linkoffline,$(DOCLETAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
   475 	  $(call OptionTrip,-linkoffline,$(DOCLETAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
   473 	) >> $@
   476 	) >> $@
   474 
   477 
   475 # Create a file with the package names in it
   478 # Create a file with the package names in it
   476 $(DOCLETAPI_PACKAGES_FILE): $(call PackageDependencies,$(DOCLETAPI_PKGS)) 
   479 $(DOCLETAPI_PACKAGES_FILE): $(call PackageDependencies,$(DOCLETAPI_PKGS))
   477 	$(prep-target)
   480 	$(prep-target)
   478 	$(call PackageFilter,$(DOCLETAPI_PKGS))
   481 	$(call PackageFilter,$(DOCLETAPI_PKGS))
   479 
   482 
   480 #############################################################
   483 #############################################################
   481 #
   484 #
  1119 	$(prep-target)
  1122 	$(prep-target)
  1120 	$(call PackageFilter,$(TREEAPI_PKGS))
  1123 	$(call PackageFilter,$(TREEAPI_PKGS))
  1121 
  1124 
  1122 #############################################################
  1125 #############################################################
  1123 #
  1126 #
       
  1127 # nashornapidocs
       
  1128 #
       
  1129 
       
  1130 ALL_OTHER_TARGETS += nashornapidocs
       
  1131 
       
  1132 NASHORNAPI_DOCDIR := $(JDK_API_DOCSDIR)/nashorn
       
  1133 NASHORNAPI2COREAPI := ../$(JDKJRE2COREAPI)
       
  1134 NASHORNAPI_DOCTITLE := Nashorn API
       
  1135 NASHORNAPI_WINDOWTITLE := Nashorn API
       
  1136 NASHORNAPI_HEADER := <strong>Nashorn API</strong>
       
  1137 NASHORNAPI_BOTTOM := $(call CommonBottom,$(NASHORNAPI_FIRST_COPYRIGHT_YEAR))
       
  1138 NASHORNAPI_GROUPNAME := Packages
       
  1139 NASHORNAPI_REGEXP := jdk.nashorn.api.scripting.*
       
  1140 # NASHORNAPI_PKGS is located in NON_CORE_PKGS.gmk
       
  1141 
       
  1142 NASHORNAPI_INDEX_HTML = $(NASHORNAPI_DOCDIR)/index.html
       
  1143 NASHORNAPI_OPTIONS_FILE = $(DOCSTMPDIR)/nashornapi.options
       
  1144 NASHORNAPI_PACKAGES_FILE = $(DOCSTMPDIR)/nashornapi.packages
       
  1145 
       
  1146 nashornapidocs: $(NASHORNAPI_INDEX_HTML)
       
  1147 
       
  1148 # Set relative location to core api document root
       
  1149 $(NASHORNAPI_INDEX_HTML): GET2DOCSDIR=$(NASHORNAPI2COREAPI)/..
       
  1150 
       
  1151 # Run javadoc if the index file is out of date or missing
       
  1152 $(NASHORNAPI_INDEX_HTML): $(NASHORNAPI_OPTIONS_FILE) $(NASHORNAPI_PACKAGES_FILE) $(COREAPI_INDEX_FILE)
       
  1153 	$(prep-javadoc)
       
  1154 	$(call JavadocSummary,$(NASHORNAPI_OPTIONS_FILE),$(NASHORNAPI_PACKAGES_FILE))
       
  1155 	$(JAVADOC_CMD) -d $(@D) \
       
  1156 	    @$(NASHORNAPI_OPTIONS_FILE) @$(NASHORNAPI_PACKAGES_FILE)
       
  1157 
       
  1158 # Create file with javadoc options in it
       
  1159 $(NASHORNAPI_OPTIONS_FILE):
       
  1160 	$(prep-target)
       
  1161 	@($(call COMMON_JAVADOCFLAGS) ; \
       
  1162           $(call COMMON_JAVADOCTAGS) ; \
       
  1163 	  $(call OptionOnly,-Xdoclint:all) ; \
       
  1164 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH)) ; \
       
  1165 	  $(call OptionPair,-encoding,ascii) ; \
       
  1166 	  $(call OptionPair,-doctitle,$(NASHORNAPI_DOCTITLE)) ; \
       
  1167 	  $(call OptionPair,-windowtitle,$(NASHORNAPI_WINDOWTITLE) $(DRAFT_WINTITLE)); \
       
  1168 	  $(call OptionPair,-header,$(NASHORNAPI_HEADER)$(DRAFT_HEADER)) ; \
       
  1169 	  $(call OptionPair,-bottom,$(NASHORNAPI_BOTTOM)$(DRAFT_BOTTOM)) ; \
       
  1170 	  $(call OptionTrip,-group,$(NASHORNAPI_GROUPNAME),$(NASHORNAPI_REGEXP)); \
       
  1171 	  $(call OptionTrip,-linkoffline,$(NASHORNAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
       
  1172 	) >> $@
       
  1173 
       
  1174 # Create a file with the package names in it
       
  1175 $(NASHORNAPI_PACKAGES_FILE): $(call PackageDependencies,$(NASHORNAPI_PKGS))
       
  1176 	$(prep-target)
       
  1177 	$(call PackageFilter,$(NASHORNAPI_PKGS))
       
  1178 
       
  1179 #############################################################
       
  1180 #
  1124 # sctpdocs
  1181 # sctpdocs
  1125 #
  1182 #
  1126 
  1183 
  1127 ALL_OTHER_TARGETS += sctpdocs
  1184 ALL_OTHER_TARGETS += sctpdocs
  1128 
  1185