jdk/makefiles/docs/Makefile
changeset 14231 a0c23c1c010f
parent 14104 8d9d430b4244
child 14232 cc37c509b56d
equal deleted inserted replaced
14104:8d9d430b4244 14231:a0c23c1c010f
     1 # Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
       
     2 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
       
     3 #
       
     4 # This code is free software; you can redistribute it and/or modify it
       
     5 # under the terms of the GNU General Public License version 2 only, as
       
     6 # published by the Free Software Foundation.  Oracle designates this
       
     7 # particular file as subject to the "Classpath" exception as provided
       
     8 # by Oracle in the LICENSE file that accompanied this code.
       
     9 #
       
    10 # This code is distributed in the hope that it will be useful, but WITHOUT
       
    11 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
       
    12 # FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
       
    13 # version 2 for more details (a copy is included in the LICENSE file that
       
    14 # accompanied this code).
       
    15 #
       
    16 # You should have received a copy of the GNU General Public License version
       
    17 # 2 along with this work; if not, write to the Free Software Foundation,
       
    18 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
       
    19 #
       
    20 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
       
    21 # or visit www.oracle.com if you need additional information or have any
       
    22 # questions.
       
    23 #
       
    24 
       
    25 #
       
    26 # Definitions for $(DOCSDIR), $(MKDIR), $(BINDIR), etc.
       
    27 #
       
    28 BUILDDIR=..
       
    29 PRODUCT=docs
       
    30 include $(BUILDDIR)/common/Defs.gmk
       
    31 
       
    32 # Get CopyrightLine macro and other shared variables
       
    33 include $(BUILDDIR)/common/shared/Defs-javadoc.gmk
       
    34 
       
    35 # Url to root of documents
       
    36 DOCSDIR_URL = {@docroot}/$(GET2DOCSDIR)
       
    37 
       
    38 # Url to copyright html file
       
    39 COPYRIGHT_URL-7 = $(DOCSDIR_URL)/legal/cpyr.html
       
    40 COPYRIGHT_URL = $(COPYRIGHT_URL-$(JDK_MINOR_VERSION))
       
    41 
       
    42 # Url to bug filing site
       
    43 BUG_SUBMIT_URL = http://bugreport.sun.com/bugreport/
       
    44 
       
    45 # Common line for how to submit a bug or rfe
       
    46 BUG_SUBMIT_LINE = <a href="$(BUG_SUBMIT_URL)">Submit a bug or feature</a>
       
    47 
       
    48 # Url to devdocs page
       
    49 #   Was: http://java.sun.com/javase/6/webnotes/devdocs-vs-specs.html
       
    50 DEV_DOCS_URL-5 = http://java.sun.com/j2se/1.5.0/docs/index.html
       
    51 DEV_DOCS_URL-6 = http://download.oracle.com/javase/6/docs/index.html
       
    52 DEV_DOCS_URL-7 = http://download.oracle.com/javase/7/docs/index.html
       
    53 DEV_DOCS_URL = $(DEV_DOCS_URL-$(JDK_MINOR_VERSION))
       
    54 DOCS_BASE_URL = http://download.oracle.com/javase/7/docs
       
    55 
       
    56 # Url to Java Language Spec
       
    57 #JLS3_URL = http://java.sun.com/docs/books/jls/
       
    58 
       
    59 # Common Java trademark line
       
    60 JAVA_TRADEMARK_LINE = Java is a trademark or registered trademark of \
       
    61 $(FULL_COMPANY_NAME) in the US and other countries.
       
    62 
       
    63 #
       
    64 # Definitions for imported components
       
    65 #
       
    66 include $(BUILDDIR)/common/internal/ImportComponents.gmk
       
    67 
       
    68 # We override whatever the max VM memory setting is here.
       
    69 #    NOTE: javadoc will not complete without these larger settings.
       
    70 #    WARNING: This could cause thrashing on low memory machines.
       
    71 ifeq ($(ARCH_DATA_MODEL),64)
       
    72   MAX_VM_MEMORY = 1024
       
    73 else ifeq ($(ARCH),universal)
       
    74   MAX_VM_MEMORY = 1024
       
    75 else
       
    76   MAX_VM_MEMORY = 612
       
    77 endif
       
    78 
       
    79 # List of all possible directories for javadoc to look for sources
       
    80 #    NOTE: Quotes are required around sourcepath argument only on Windows.
       
    81 #          Otherwise, you get "No packages or classes specified." due 
       
    82 #          to $(CLASSPATH_SEPARATOR) being interpreted as an end of 
       
    83 #          command (newline or shell ; character)
       
    84 ALL_SOURCE_DIRS = $(SHARE_SRC)/classes \
       
    85                   $(IMPORTSRCDIR) \
       
    86                   $(GENSRCDIR) \
       
    87                   $(SHARE_SRC)/../solaris/classes \
       
    88 	          $(SHARE_SRC)/../windows/classes \
       
    89 		  $(SHARE_SRC)/doc/stub
       
    90 
       
    91 # List of directories that actually exist
       
    92 ALL_EXISTING_SOURCE_DIRS := $(wildcard $(ALL_SOURCE_DIRS))
       
    93 
       
    94 # List with classpath separator between them
       
    95 EMPTY:=
       
    96 SPACE:= $(EMPTY) $(EMPTY)
       
    97 RELEASEDOCS_SOURCEPATH = \
       
    98     $(subst $(SPACE),$(CLASSPATH_SEPARATOR),$(strip $(ALL_SOURCE_DIRS)))
       
    99 
       
   100 # Prep for javadoc creation, assumes $@ is an index.html file
       
   101 define prep-javadoc
       
   102 @if [ -f "$@" -a "$?" != "" ] ; then \
       
   103   $(ECHO) "# Dependencies have changed: $?"; \
       
   104 fi
       
   105 $(RM) -r $(@D)
       
   106 $(MKDIR) -p $(@D)
       
   107 endef
       
   108 
       
   109 # A cache of the directories in ALL_SOURCE_DIRS
       
   110 DIRECTORY_CACHE = $(DOCSTMPDIR)/directory.cache
       
   111 
       
   112 # Given a list of packages, return a list of files or dirs to be dependent on
       
   113 #   (Currently only returning a list of directories)
       
   114 define PackageDependencies # packages
       
   115 $(shell							\
       
   116   if [ "$1" != "" -a -f $(DIRECTORY_CACHE) ] ; then	\
       
   117     for p in $1 ; do 					\
       
   118       pd=`$(ECHO) $${p} | $(SED) -e 's@[.]@/@g'`;	\
       
   119       $(CAT) $(DIRECTORY_CACHE) | $(GREP) "/$${pd}/" ; 	\
       
   120     done; 						\
       
   121   fi							\
       
   122 )
       
   123 endef
       
   124 
       
   125 # Given a list of packages, add packages that exist to $@, print summary
       
   126 define PackageFilter # packages
       
   127 @if [ "$1" != "" ] ; then 				\
       
   128   for p in $1 ; do 					\
       
   129     pd=`$(ECHO) $${p} | $(SED) -e 's@[.]@/@g'`; 	\
       
   130     found="false"; 					\
       
   131     for cp in $(ALL_SOURCE_DIRS) ; do 			\
       
   132       if [ -d $${cp}/$${pd} ] ; then 			\
       
   133         $(ECHO) "$${p}" >> $@; 				\
       
   134 	found="true";					\
       
   135 	break; 						\
       
   136       fi; 						\
       
   137     done; 						\
       
   138     if [ "$${found}" = "false" ] ; then 		\
       
   139       $(ECHO) "WARNING: Package not found: $${p}"; 	\
       
   140     fi; 						\
       
   141   done; 						\
       
   142 fi
       
   143 endef
       
   144 
       
   145 # Print out a summary of the javadoc command about to be run
       
   146 define JavadocSummary # optionsfile packagesfile
       
   147 @$(ECHO) "# Summary for $@";\
       
   148  $(ECHO) "# Options (`$(BASENAME) $1`):"; $(SED) -e 's@^@#   @' $1; \
       
   149  $(ECHO) "# Packages (`$(BASENAME) $2`):";$(SED) -e 's@^@#   @' $2
       
   150 endef
       
   151 
       
   152 #
       
   153 # Temporary directory for javadoc creation
       
   154 #
       
   155 DOCSTMPDIR = $(TEMPDIR)/doctmp
       
   156 
       
   157 #
       
   158 # Different api directories created from root directory
       
   159 #
       
   160 COREAPI_DOCSDIR   = $(DOCSDIR)/api
       
   161 JDK_API_DOCSDIR   = $(DOCSDIR)/jdk/api
       
   162 JRE_API_DOCSDIR   = $(DOCSDIR)/jre/api
       
   163 PLATFORM_DOCSDIR  = $(DOCSDIR)/platform
       
   164 
       
   165 # The non-core api javadocs need to be able to access the root of the core
       
   166 #   api directory, so for jdk/api or jre/api to get to the core api/
       
   167 #   directory we would use this:
       
   168 JDKJRE2COREAPI    = ../../api
       
   169 
       
   170 # Common bottom argument
       
   171 define CommonBottom # year
       
   172 <font size="-1"><br> $(call CopyrightLine,,$1,)</font>
       
   173 endef
       
   174 
       
   175 # Common trademark bottom argument (Not sure why this is used sometimes)
       
   176 define CommonTrademarkBottom # year
       
   177 <font size="-1">\
       
   178 $(BUG_SUBMIT_LINE)<br>$(JAVA_TRADEMARK_LINE)<br>\
       
   179 $(call CopyrightLine,,$1,$(COMPANY_ADDRESS))\
       
   180 </font>
       
   181 endef
       
   182 
       
   183 # Common echo of option
       
   184 define OptionOnly # opt
       
   185 $(PRINTF) "%s\n" "$1"
       
   186 endef
       
   187 define OptionPair # opt arg
       
   188 $(PRINTF) "%s '%s'\n" "$1" '$2'
       
   189 endef
       
   190 define OptionTrip # opt arg arg
       
   191 $(PRINTF) "%s '%s' '%s'\n" "$1" '$2' '$3'
       
   192 endef
       
   193 
       
   194 # Core api bottom argument (with special sauce)
       
   195 COREAPI_BOTTOM = <font size="-1"> $(BUG_SUBMIT_LINE)\
       
   196 <br>For further API reference and developer documentation, \
       
   197 see <a href="$(DEV_DOCS_URL)" target="_blank">Java SE Documentation</a>. \
       
   198 That documentation contains more detailed, developer-targeted descriptions, \
       
   199 with conceptual overviews, definitions of terms, workarounds, \
       
   200 and working code examples.<br>\
       
   201 $(call CopyrightLine,$(COPYRIGHT_URL),$(FIRST_COPYRIGHT_YEAR),)\
       
   202 </font>
       
   203 
       
   204 # Common javadoc options used by all
       
   205 COMMON_JAVADOCFLAGS =					\
       
   206                 $(NO_PROPRIETARY_API_WARNINGS)          \
       
   207 		-quiet					\
       
   208                 -use					\
       
   209                 -keywords				\
       
   210 		$(ADDITIONAL_JAVADOCFLAGS)
       
   211 
       
   212 ifdef OPENJDK
       
   213   ADDITIONAL_JAVADOCFLAGS =				\
       
   214                 -Xdocrootparent $(DOCS_BASE_URL)
       
   215 else
       
   216   ADDITIONAL_JAVADOCFLAGS =
       
   217 endif
       
   218 
       
   219 # Draft used for non-fcs documents
       
   220 JDK_IS_FCS = false
       
   221 DRAFT_HEADER =
       
   222 ifeq ($(JDK_MINOR_VERSION),5)
       
   223   JDK_IS_FCS = true
       
   224 endif
       
   225 ifeq ($(JDK_MINOR_VERSION),6)
       
   226   JDK_IS_FCS = true
       
   227 endif
       
   228 ifeq ($(JDK_MINOR_VERSION),7)
       
   229   JDK_IS_FCS = true
       
   230 endif
       
   231 ifeq ($(JDK_IS_FCS),false)
       
   232   ifneq ($(MILESTONE), fcs)
       
   233     DRAFT_HEADER = <br><strong>DRAFT&nbsp;$(MILESTONE)-$(BUILD_NUMBER)</strong>
       
   234     DRAFT_BOTTOM = <br><strong>DRAFT&nbsp;$(MILESTONE)-$(BUILD_NUMBER)</strong>
       
   235     DRAFT_WINTITLE = $(BUILD_NUMBER)
       
   236     # Early access top text (not used in FCS releases)
       
   237     COREAPI_TOP_EARLYACCESS = \
       
   238 <div style="background-color: \#EEEEEE"> \
       
   239 <div style="padding: 6px; margin-top: 2px; margin-bottom: 6px; \
       
   240 margin-left: 6px; margin-right: 6px; text-align: justify; \
       
   241 font-size: 80%; font-family: Helvetica, Arial, sans-serif; \
       
   242 font-weight: normal;"> \
       
   243 Please note that the specifications and other information \
       
   244 contained herein are not final and are subject to change. \
       
   245 The information is being made available to you solely for purpose of \
       
   246 evaluation. \
       
   247 </div> </div>
       
   248   endif
       
   249 endif
       
   250 
       
   251 #################################################################
       
   252 
       
   253 #
       
   254 # CORE_PKGS environment variable has been moved to the following file
       
   255 #
       
   256 include CORE_PKGS.gmk
       
   257 
       
   258 #
       
   259 # Load environment variables for API package names that are not part of
       
   260 # the Java SE platform
       
   261 #
       
   262 include NON_CORE_PKGS.gmk
       
   263 
       
   264 #################################################################
       
   265 
       
   266 #
       
   267 # Default target is same as docs target, create core api and all others it can
       
   268 #
       
   269 
       
   270 all: docs
       
   271 docs: coredocs otherdocs
       
   272 
       
   273 #################################################################
       
   274 # Production Targets -- USE THESE TARGETS WHEN:
       
   275 #    a) You're generating docs outside of release engineering's
       
   276 #       standard control build.
       
   277 #    b) The docs will be pushed to the web and/or included in
       
   278 #       the downloaded doc bundle.
       
   279 #
       
   280 # See:  Notes.html#releaseTargets
       
   281 # Note: Spaces precede ifdef/ifndef indents. Tabs precede target commands (!)
       
   282 #
       
   283 
       
   284 sanitycheckcoredocs:
       
   285 	@$(ECHO) ""
       
   286 	@$(ECHO) "Building core api docs with these values:"
       
   287 	@$(ECHO) "    BUILD_NUMBER = $(BUILD_NUMBER)"
       
   288 	@$(ECHO) "    MILESTONE = $(MILESTONE)"
       
   289 	@$(ECHO) ""
       
   290   ifeq ($(BUILD_NUMBER), b00)
       
   291 	@$(ECHO) "ERROR: Build number must be defined"
       
   292 	@$(ECHO) "MILESTONE is set to $(MILESTONE)"
       
   293 	@$(ECHO) ""
       
   294 	exit 1
       
   295   endif
       
   296 
       
   297 #############################################################
       
   298 #
       
   299 # coredocs
       
   300 #
       
   301 COREAPI_DOCTITLE  = Java$(TRADEMARK) Platform, Standard Edition \
       
   302 $(JDK_MINOR_VERSION)<br>API Specification
       
   303 COREAPI_WINDOWTITLE  = Java Platform SE $(JDK_MINOR_VERSION)
       
   304 COREAPI_HEADER = \
       
   305 <strong>Java$(TRADEMARK)&nbsp;Platform<br>Standard&nbsp;Ed.&nbsp;$(JDK_MINOR_VERSION)</strong>
       
   306 
       
   307 # Java language specification cite
       
   308 TAG_JLS = jls:a:See <cite> \
       
   309 The Java&trade; Language Specification</cite>:
       
   310 
       
   311 # Overview file for core apis
       
   312 COREAPI_OVERVIEW = $(SHARE_SRC)/classes/overview-core.html
       
   313 
       
   314 # The index.html, options, and packages files
       
   315 COREAPI_INDEX_FILE    = $(COREAPI_DOCSDIR)/index.html
       
   316 COREAPI_OPTIONS_FILE  = $(DOCSTMPDIR)/coredocs.options
       
   317 COREAPI_PACKAGES_FILE = $(DOCSTMPDIR)/coredocs.packages
       
   318 
       
   319 coredocs: $(COREAPI_INDEX_FILE)
       
   320 
       
   321 # Set relative location to core api document root
       
   322 $(COREAPI_INDEX_FILE): GET2DOCSDIR=..
       
   323 
       
   324 # Run javadoc if the index file is out of date or missing
       
   325 $(COREAPI_INDEX_FILE): $(COREAPI_OPTIONS_FILE) $(COREAPI_PACKAGES_FILE)
       
   326 	$(prep-javadoc)
       
   327 	$(call JavadocSummary,$(COREAPI_OPTIONS_FILE),$(COREAPI_PACKAGES_FILE))
       
   328 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   329 	  @$(COREAPI_OPTIONS_FILE) @$(COREAPI_PACKAGES_FILE)
       
   330 
       
   331 # Create file with javadoc options in it
       
   332 $(COREAPI_OPTIONS_FILE): $(COREAPI_OVERVIEW)
       
   333 	$(prep-target)
       
   334 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   335 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   336 	  $(call OptionPair,-encoding,ISO-8859-1)			; \
       
   337 	  $(call OptionPair,-tag,beaninfo:X)				; \
       
   338 	  $(call OptionPair,-tag,revised:X)				; \
       
   339 	  $(call OptionPair,-tag,since.unbundled:X)			; \
       
   340 	  $(call OptionPair,-tag,spec:X)				; \
       
   341 	  $(call OptionPair,-tag,specdefault:X)				; \
       
   342 	  $(call OptionPair,-tag,Note:X)				; \
       
   343 	  $(call OptionPair,-tag,ToDo:X)				; \
       
   344           $(call OptionPair,-tag,$(TAG_JLS)) 				; \
       
   345 	  $(call OptionOnly,-splitIndex)				; \
       
   346 	  $(call OptionPair,-overview,$(COREAPI_OVERVIEW))		; \
       
   347 	  $(call OptionPair,-doctitle,$(COREAPI_DOCTITLE))		; \
       
   348 	  $(call OptionPair,-windowtitle,$(COREAPI_WINDOWTITLE) $(DRAFT_WINTITLE)) ;\
       
   349 	  $(call OptionPair,-header,$(COREAPI_HEADER)$(DRAFT_HEADER))	; \
       
   350 	  $(call OptionPair,-bottom,$(COREAPI_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   351         ) >> $@
       
   352 ifdef COREAPI_TOP_EARLYACCESS
       
   353 	@$(call OptionPair,-top,$(COREAPI_TOP_EARLYACCESS)) >> $@
       
   354 endif
       
   355 
       
   356 # Create a file with the package names in it
       
   357 $(COREAPI_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(CORE_PKGS))
       
   358 	$(prep-target)
       
   359 	$(call PackageFilter,$(CORE_PKGS))
       
   360 
       
   361 #############################################################
       
   362 #
       
   363 # docletapidocs
       
   364 #
       
   365 
       
   366 # Part of langtools
       
   367 ifdef LANGTOOLS_DIST
       
   368   ALL_OTHER_TARGETS += docletapidocs
       
   369 endif
       
   370 
       
   371 DOCLETAPI_DOCDIR       := $(JDK_API_DOCSDIR)/javadoc/doclet
       
   372 DOCLETAPI2COREAPI      := ../../$(JDKJRE2COREAPI)
       
   373 DOCLETAPI_DOCTITLE     := Doclet API
       
   374 DOCLETAPI_WINDOWTITLE  := Doclet API
       
   375 DOCLETAPI_HEADER       := <strong>Doclet API</strong>
       
   376 DOCLETAPI_BOTTOM       := $(call CommonTrademarkBottom,$(DOCLETAPI_FIRST_COPYRIGHT_YEAR))
       
   377 DOCLETAPI_GROUPNAME    := Packages
       
   378 DOCLETAPI_REGEXP       := com.sun.javadoc
       
   379 # DOCLETAPI_PKGS is located in NON_CORE_PKGS.gmk
       
   380 
       
   381 # The index.html, options, and packages files
       
   382 DOCLETAPI_INDEX_FILE    = $(DOCLETAPI_DOCDIR)/index.html
       
   383 DOCLETAPI_OPTIONS_FILE  = $(DOCSTMPDIR)/docletapi.options
       
   384 DOCLETAPI_PACKAGES_FILE = $(DOCSTMPDIR)/docletapi.packages
       
   385 
       
   386 docletapidocs: $(DOCLETAPI_INDEX_FILE)
       
   387 
       
   388 # Set relative location to core api document root
       
   389 $(DOCLETAPI_INDEX_FILE): GET2DOCSDIR=$(DOCLETAPI2COREAPI)/..
       
   390 
       
   391 # Run javadoc if the index file is out of date or missing
       
   392 $(DOCLETAPI_INDEX_FILE): $(DOCLETAPI_OPTIONS_FILE) $(DOCLETAPI_PACKAGES_FILE)
       
   393 	$(prep-javadoc)
       
   394 	$(call JavadocSummary,$(DOCLETAPI_OPTIONS_FILE),$(DOCLETAPI_PACKAGES_FILE))
       
   395 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   396 	  @$(DOCLETAPI_OPTIONS_FILE) @$(DOCLETAPI_PACKAGES_FILE)
       
   397 
       
   398 # Create file with javadoc options in it
       
   399 $(DOCLETAPI_OPTIONS_FILE):
       
   400 	$(prep-target)
       
   401 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   402 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   403 	  $(call OptionPair,-encoding,ascii)				; \
       
   404 	  $(call OptionOnly,-breakiterator)				; \
       
   405 	  $(call OptionPair,-doctitle,$(DOCLETAPI_DOCTITLE))		; \
       
   406 	  $(call OptionPair,-windowtitle,$(DOCLETAPI_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
   407 	  $(call OptionPair,-header,$(DOCLETAPI_HEADER)$(DRAFT_HEADER))	; \
       
   408 	  $(call OptionPair,-bottom,$(DOCLETAPI_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   409 	  $(call OptionTrip,-group,$(DOCLETAPI_GROUPNAME),$(DOCLETAPI_REGEXP)); \
       
   410 	  $(call OptionTrip,-linkoffline,$(DOCLETAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   411         ) >> $@
       
   412 
       
   413 # Create a file with the package names in it
       
   414 $(DOCLETAPI_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(DOCLETAPI_PKGS))
       
   415 	$(prep-target)
       
   416 	$(call PackageFilter,$(DOCLETAPI_PKGS))
       
   417 
       
   418 #############################################################
       
   419 #
       
   420 # tagletapidocs
       
   421 #
       
   422 
       
   423 # Part of langtools
       
   424 ifdef LANGTOOLS_DIST
       
   425   ALL_OTHER_TARGETS += tagletapidocs
       
   426 endif
       
   427 
       
   428 TAGLETAPI_DOCDIR   := $(JDK_API_DOCSDIR)/javadoc/taglet
       
   429 TAGLETAPI2COREAPI  := ../../$(JDKJRE2COREAPI)
       
   430 TAGLETAPI_BOTTOM   := $(call CommonTrademarkBottom,$(TAGLETAPI_FIRST_COPYRIGHT_YEAR))
       
   431 # TAGLETAPI_FILE is located in NON_CORE_PKGS.gmk
       
   432 
       
   433 # Temporary directory (special generation rules)
       
   434 TAGLETAPI_TEMPDIR       = $(DOCSTMPDIR)/taglets_temp
       
   435 
       
   436 # The index.html, options, and packages files
       
   437 TAGLETAPI_INDEX_FILE    = $(TAGLETAPI_DOCDIR)/index.html
       
   438 TAGLETAPI_OPTIONS_FILE  = $(DOCSTMPDIR)/tagletapi.options
       
   439 TAGLETAPI_PACKAGES_FILE = $(DOCSTMPDIR)/tagletapi.packages
       
   440 
       
   441 tagletapidocs: $(TAGLETAPI_INDEX_FILE)
       
   442 
       
   443 # Set relative location to core api document root
       
   444 $(TAGLETAPI_INDEX_FILE): GET2DOCSDIR=$(TAGLETAPI2COREAPI)/..
       
   445 
       
   446 # Run javadoc if the index file is out of date or missing
       
   447 $(TAGLETAPI_INDEX_FILE): $(TAGLETAPI_OPTIONS_FILE) $(TAGLETAPI_PACKAGES_FILE)
       
   448 	$(prep-javadoc)
       
   449 	$(RM) -r $(TAGLETAPI_TEMPDIR)
       
   450 	$(MKDIR) -p $(TAGLETAPI_TEMPDIR)
       
   451 	$(call JavadocSummary,$(TAGLETAPI_OPTIONS_FILE),$(TAGLETAPI_PACKAGES_FILE))
       
   452 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(TAGLETAPI_TEMPDIR) \
       
   453 	  @$(TAGLETAPI_OPTIONS_FILE) @$(TAGLETAPI_PACKAGES_FILE)
       
   454 	cp -r $(TAGLETAPI_TEMPDIR)/com $(@D)
       
   455 	cp $(TAGLETAPI_TEMPDIR)/stylesheet.css $(@D)
       
   456 	$(RM) -r $(TAGLETAPI_TEMPDIR)
       
   457 
       
   458 # Create file with javadoc options in it
       
   459 $(TAGLETAPI_OPTIONS_FILE):
       
   460 	$(prep-target)
       
   461 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   462 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   463 	  $(call OptionPair,-encoding,ascii)				; \
       
   464 	  $(call OptionOnly,-nonavbar)					; \
       
   465 	  $(call OptionOnly,-noindex)					; \
       
   466 	  $(call OptionPair,-bottom,$(TAGLETAPI_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   467 	  $(call OptionTrip,-linkoffline,$(TAGLETAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   468         ) >> $@
       
   469 
       
   470 # Create a file with the package names in it
       
   471 $(TAGLETAPI_PACKAGES_FILE): $(IMPORTSRCDIR)/$(TAGLETAPI_FILE)
       
   472 	$(prep-target)
       
   473 	@($(ECHO) "$(IMPORTSRCDIR)/$(TAGLETAPI_FILE)" ) > $@
       
   474 
       
   475 #############################################################
       
   476 #
       
   477 # domapidocs
       
   478 #
       
   479 
       
   480 ALL_OTHER_TARGETS += domapidocs
       
   481 
       
   482 DOMAPI_DOCDIR       := $(JRE_API_DOCSDIR)/plugin/dom
       
   483 DOMAPI2COREAPI      := ../../$(JDKJRE2COREAPI)
       
   484 DOMAPI_DOCTITLE     := Common DOM API
       
   485 DOMAPI_WINDOWTITLE  := Common DOM API
       
   486 DOMAPI_HEADER       := <strong>Common DOM API</strong>
       
   487 DOMAPI_BOTTOM       := $(call CommonTrademarkBottom,$(DOMAPI_FIRST_COPYRIGHT_YEAR))
       
   488 DOMAPI_GROUPNAME    := Packages
       
   489 DOMAPI_REGEXP       := com.sun.java.browser.dom:org.w3c.dom*
       
   490 # DOMAPI_PKGS is located in NON_CORE_PKGS.gmk
       
   491 
       
   492 # The index.html, options, and packages files
       
   493 DOMAPI_INDEX_FILE    = $(DOMAPI_DOCDIR)/index.html
       
   494 DOMAPI_OPTIONS_FILE  = $(DOCSTMPDIR)/domapi.options
       
   495 DOMAPI_PACKAGES_FILE = $(DOCSTMPDIR)/domapi.packages
       
   496 
       
   497 domapidocs: $(DOMAPI_INDEX_FILE)
       
   498 
       
   499 # Set relative location to core api document root
       
   500 $(DOMAPI_INDEX_FILE): GET2DOCSDIR=$(DOMAPI2COREAPI)/..
       
   501 
       
   502 # Run javadoc if the index file is out of date or missing
       
   503 $(DOMAPI_INDEX_FILE): $(DOMAPI_OPTIONS_FILE) $(DOMAPI_PACKAGES_FILE)
       
   504 	$(prep-javadoc)
       
   505 	$(call JavadocSummary,$(DOMAPI_OPTIONS_FILE),$(DOMAPI_PACKAGES_FILE))
       
   506 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   507 	  @$(DOMAPI_OPTIONS_FILE) @$(DOMAPI_PACKAGES_FILE)
       
   508 
       
   509 # Create file with javadoc options in it
       
   510 $(DOMAPI_OPTIONS_FILE):
       
   511 	$(prep-target)
       
   512 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   513 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   514 	  $(call OptionPair,-encoding,ascii)				; \
       
   515 	  $(call OptionOnly,-splitIndex)				; \
       
   516 	  $(call OptionPair,-doctitle,$(DOMAPI_DOCTITLE))		; \
       
   517 	  $(call OptionPair,-windowtitle,$(DOMAPI_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
   518 	  $(call OptionPair,-header,$(DOMAPI_HEADER)$(DRAFT_HEADER))	; \
       
   519 	  $(call OptionPair,-bottom,$(DOMAPI_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   520 	  $(call OptionTrip,-group,$(DOMAPI_GROUPNAME),$(DOMAPI_REGEXP)); \
       
   521 	  $(call OptionTrip,-linkoffline,$(DOMAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   522         ) >> $@
       
   523 
       
   524 # Create a file with the package names in it
       
   525 $(DOMAPI_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(DOMAPI_PKGS))
       
   526 	$(prep-target)
       
   527 	$(call PackageFilter,$(DOMAPI_PKGS))
       
   528 
       
   529 #############################################################
       
   530 #
       
   531 # jpdadocs
       
   532 #
       
   533 
       
   534 ALL_OTHER_TARGETS += jpdadocs
       
   535 
       
   536 jpdadocs: jdidocs jdwpdocs jvmtidocs
       
   537 
       
   538 #############################################################
       
   539 #
       
   540 # jdidocs
       
   541 #
       
   542 
       
   543 ALL_OTHER_TARGETS += jdidocs
       
   544 
       
   545 JDI_DOCDIR      := $(JDK_API_DOCSDIR)/jpda/jdi
       
   546 JDI2COREAPI     := ../../$(JDKJRE2COREAPI)
       
   547 JDI_DOCTITLE    := Java$(TRADEMARK) Debug Interface
       
   548 JDI_WINDOWTITLE := Java Debug Interface
       
   549 JDI_HEADER      := <strong>Java Debug Interface</strong>
       
   550 JDI_BOTTOM      := $(call CommonBottom,$(JDI_FIRST_COPYRIGHT_YEAR))
       
   551 JDI_OVERVIEW    := $(SHARE_SRC)/classes/jdi-overview.html
       
   552 # JDI_PKGS is located in NON_CORE_PKGS.gmk
       
   553 
       
   554 # The index.html, options, and packages files
       
   555 JDI_INDEX_FILE    = $(JDI_DOCDIR)/index.html
       
   556 JDI_OPTIONS_FILE  = $(DOCSTMPDIR)/jdi.options
       
   557 JDI_PACKAGES_FILE = $(DOCSTMPDIR)/jdi.packages
       
   558 
       
   559 jdidocs: $(JDI_INDEX_FILE)
       
   560 
       
   561 # Set relative location to core api document root
       
   562 $(JDI_INDEX_FILE): GET2DOCSDIR=$(JDI2COREAPI)/..
       
   563 
       
   564 # Run javadoc if the index file is out of date or missing
       
   565 $(JDI_INDEX_FILE): $(JDI_OPTIONS_FILE) $(JDI_PACKAGES_FILE)
       
   566 	$(prep-javadoc)
       
   567 	$(call JavadocSummary,$(JDI_OPTIONS_FILE),$(JDI_PACKAGES_FILE))
       
   568 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   569 	  @$(JDI_OPTIONS_FILE) @$(JDI_PACKAGES_FILE)
       
   570 
       
   571 # Create file with javadoc options in it
       
   572 $(JDI_OPTIONS_FILE): $(JDI_OVERVIEW)
       
   573 	$(prep-target)
       
   574 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   575 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   576 	  $(call OptionPair,-encoding,ascii)				; \
       
   577 	  $(call OptionPair,-overview,$(JDI_OVERVIEW))			; \
       
   578 	  $(call OptionPair,-doctitle,$(JDI_DOCTITLE))			; \
       
   579 	  $(call OptionPair,-windowtitle,$(JDI_WINDOWTITLE) $(DRAFT_WINTITLE)); \
       
   580 	  $(call OptionPair,-header,$(JDI_HEADER)$(DRAFT_HEADER))	; \
       
   581 	  $(call OptionPair,-bottom,$(JDI_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   582 	  $(call OptionTrip,-linkoffline,$(JDI2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   583         ) >> $@
       
   584 
       
   585 # Create a file with the package names in it
       
   586 $(JDI_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(JDI_PKGS))
       
   587 	$(prep-target)
       
   588 	$(call PackageFilter,$(JDI_PKGS))
       
   589 
       
   590 #############################################################
       
   591 #
       
   592 # jdwpdocs
       
   593 #
       
   594 
       
   595 ALL_OTHER_TARGETS += jdwpdocs
       
   596 
       
   597 JDWP_DOCDIR     = $(PLATFORM_DOCSDIR)/jpda/jdwp
       
   598 JDWP_SPEC       = $(BUILDDIR)/jpda/jdwp/jdwp.spec
       
   599 
       
   600 jdwpdocs: $(JDWP_DOCDIR)/jdwp-protocol.html
       
   601 $(JDWP_DOCDIR)/jdwp-protocol.html: $(BUILD_TOOLS) $(JDWP_SPEC)
       
   602 	$(prep-javadoc)
       
   603 	$(TOOL_JDWPGEN) $(JDWP_SPEC) -doc $@
       
   604 
       
   605 #############################################################
       
   606 #
       
   607 # jvmtidocs
       
   608 #
       
   609 
       
   610 ALL_OTHER_TARGETS += jvmtidocs
       
   611 
       
   612 JVMTI_DOCDIR      = $(PLATFORM_DOCSDIR)/jvmti
       
   613 JVMTI_HTML        = $(HOTSPOT_DOCS_IMPORT_PATH)/platform/jvmti/jvmti.html
       
   614 
       
   615 jvmtidocs:  $(JVMTI_DOCDIR)/jvmti.html
       
   616 $(JVMTI_DOCDIR)/jvmti.html:
       
   617 	@$(prep-javadoc)
       
   618 	@if [ -f $(JVMTI_HTML) ] ; then		                           \
       
   619 	  $(ECHO) "$(CP) $(JVMTI_HTML) $@";                 	           \
       
   620 	  $(CP) $(JVMTI_HTML) $@; 	                 	           \
       
   621 	else 						                   \
       
   622 	  $(ECHO) "WARNING: Generated file does not exist: $(JVMTI_HTML)"; \
       
   623 	fi
       
   624 
       
   625 #############################################################
       
   626 #
       
   627 # jaasdocs
       
   628 #
       
   629 
       
   630 ALL_OTHER_TARGETS += jaasdocs
       
   631 
       
   632 JAAS_DOCDIR	 := $(JRE_API_DOCSDIR)/security/jaas/spec
       
   633 JAAS2COREAPI     := ../../../$(JDKJRE2COREAPI)
       
   634 JAAS_DOCTITLE    := Java$(TRADEMARK) Authentication and Authorization Service
       
   635 JAAS_WINDOWTITLE := Java Authentication and Authorization Service
       
   636 JAAS_HEADER      := <strong>Java Authentication and Authorization Service</strong>
       
   637 JAAS_BOTTOM      := $(call CommonBottom,$(JAAS_FIRST_COPYRIGHT_YEAR))
       
   638 # JAAS_PKGS is located in NON_CORE_PKGS.gmk
       
   639 JAAS_OVERVIEW    := $(SHARE_SRC)/classes/com/sun/security/auth/jaas-overview.html
       
   640 
       
   641 # The index.html, options, and packages files
       
   642 JAAS_INDEX_FILE    = $(JAAS_DOCDIR)/index.html
       
   643 JAAS_OPTIONS_FILE  = $(DOCSTMPDIR)/jaas.options
       
   644 JAAS_PACKAGES_FILE = $(DOCSTMPDIR)/jaas.packages
       
   645 
       
   646 jaasdocs: $(JAAS_INDEX_FILE)
       
   647 
       
   648 # Set relative location to core api document root
       
   649 $(JAAS_INDEX_FILE): GET2DOCSDIR=$(JAAS2COREAPI)/..
       
   650 
       
   651 # Run javadoc if the index file is out of date or missing
       
   652 $(JAAS_INDEX_FILE): $(JAAS_OPTIONS_FILE) $(JAAS_PACKAGES_FILE)
       
   653 	$(prep-javadoc)
       
   654 	$(call JavadocSummary,$(JAAS_OPTIONS_FILE),$(JAAS_PACKAGES_FILE))
       
   655 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   656 	  @$(JAAS_OPTIONS_FILE) @$(JAAS_PACKAGES_FILE)
       
   657 
       
   658 # Create file with javadoc options in it
       
   659 $(JAAS_OPTIONS_FILE): $(JAAS_OVERVIEW)
       
   660 	$(prep-target)
       
   661 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   662 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   663 	  $(call OptionPair,-encoding,ascii)				; \
       
   664 	  $(call OptionPair,-overview,$(JAAS_OVERVIEW))			; \
       
   665 	  $(call OptionPair,-doctitle,$(JAAS_DOCTITLE))			; \
       
   666 	  $(call OptionPair,-windowtitle,$(JAAS_WINDOWTITLE) $(DRAFT_WINTITLE)); \
       
   667 	  $(call OptionPair,-header,$(JAAS_HEADER)$(DRAFT_HEADER))	; \
       
   668 	  $(call OptionPair,-bottom,$(JAAS_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   669 	  $(call OptionTrip,-linkoffline,$(JAAS2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   670         ) >> $@
       
   671 
       
   672 # Create a file with the package names in it
       
   673 $(JAAS_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(JAAS_PKGS))
       
   674 	$(prep-target)
       
   675 	$(call PackageFilter,$(JAAS_PKGS))
       
   676 
       
   677 #############################################################
       
   678 #
       
   679 # jgssdocs
       
   680 #
       
   681 
       
   682 ALL_OTHER_TARGETS += jgssdocs
       
   683 
       
   684 JGSS_DOCDIR	 := $(JRE_API_DOCSDIR)/security/jgss/spec
       
   685 JGSS2COREAPI     := ../../../$(JDKJRE2COREAPI)
       
   686 JGSS_DOCTITLE    := Java$(TRADEMARK) GSS-API Utilities
       
   687 JGSS_WINDOWTITLE := Java GSS-API Utilities
       
   688 JGSS_HEADER      := <strong>Java GSS-API Utilities</strong>
       
   689 JGSS_BOTTOM      := $(call CommonBottom,$(JGSS_FIRST_COPYRIGHT_YEAR))
       
   690 JGSS_OVERVIEW    := $(SHARE_SRC)/classes/com/sun/security/jgss/jgss-overview.html
       
   691 # JGSS_PKGS is located in NON_CORE_PKGS.gmk
       
   692 
       
   693 # The index.html, options, and packages files
       
   694 JGSS_INDEX_FILE    = $(JGSS_DOCDIR)/index.html
       
   695 JGSS_OPTIONS_FILE  = $(DOCSTMPDIR)/jgss.options
       
   696 JGSS_PACKAGES_FILE = $(DOCSTMPDIR)/jgss.packages
       
   697 
       
   698 jgssdocs: $(JGSS_INDEX_FILE)
       
   699 
       
   700 # Set relative location to core api document root
       
   701 $(JGSS_INDEX_FILE): GET2DOCSDIR=$(JGSS2COREAPI)/..
       
   702 
       
   703 # Run javadoc if the index file is out of date or missing
       
   704 $(JGSS_INDEX_FILE): $(JGSS_OPTIONS_FILE) $(JGSS_PACKAGES_FILE)
       
   705 	$(prep-javadoc)
       
   706 	$(call JavadocSummary,$(JGSS_OPTIONS_FILE),$(JGSS_PACKAGES_FILE))
       
   707 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   708 	  @$(JGSS_OPTIONS_FILE) @$(JGSS_PACKAGES_FILE)
       
   709 
       
   710 # Create file with javadoc options in it
       
   711 $(JGSS_OPTIONS_FILE): $(JGSS_OVERVIEW)
       
   712 	$(prep-target)
       
   713 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   714 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   715 	  $(call OptionPair,-encoding,ascii)				; \
       
   716 	  $(call OptionOnly,-nodeprecatedlist)				; \
       
   717 	  $(call OptionPair,-overview,$(JGSS_OVERVIEW))			; \
       
   718 	  $(call OptionPair,-doctitle,$(JGSS_DOCTITLE))			; \
       
   719 	  $(call OptionPair,-windowtitle,$(JGSS_WINDOWTITLE) $(DRAFT_WINTITLE)); \
       
   720 	  $(call OptionPair,-header,$(JGSS_HEADER)$(DRAFT_HEADER))	; \
       
   721 	  $(call OptionPair,-bottom,$(JGSS_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   722 	  $(call OptionTrip,-linkoffline,$(JGSS2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   723         ) >> $@
       
   724 
       
   725 # Create a file with the package names in it
       
   726 $(JGSS_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(JGSS_PKGS))
       
   727 	$(prep-target)
       
   728 	$(call PackageFilter,$(JGSS_PKGS))
       
   729 
       
   730 #############################################################
       
   731 #
       
   732 # smartcardiodocs
       
   733 #
       
   734 
       
   735 ALL_OTHER_TARGETS += smartcardiodocs
       
   736 
       
   737 SMARTCARDIO_DOCDIR	:= $(JRE_API_DOCSDIR)/security/smartcardio/spec
       
   738 SMARTCARDIO2COREAPI     := ../../../$(JDKJRE2COREAPI)
       
   739 SMARTCARDIO_DOCTITLE    := Java$(TRADEMARK) Smart Card I/O
       
   740 SMARTCARDIO_WINDOWTITLE := Java Smart Card I/O
       
   741 SMARTCARDIO_HEADER      := <strong>Java Smart Card I/O</strong>
       
   742 SMARTCARDIO_BOTTOM      := $(call CommonBottom,$(SMARTCARDIO_FIRST_COPYRIGHT_YEAR))
       
   743 # SMARTCARDIO_PKGS is located in NON_CORE_PKGS.gmk
       
   744 
       
   745 # The index.html, options, and packages files
       
   746 SMARTCARDIO_INDEX_FILE    = $(SMARTCARDIO_DOCDIR)/index.html
       
   747 SMARTCARDIO_OPTIONS_FILE  = $(DOCSTMPDIR)/smartcardio.options
       
   748 SMARTCARDIO_PACKAGES_FILE = $(DOCSTMPDIR)/smartcardio.packages
       
   749 
       
   750 smartcardiodocs: $(SMARTCARDIO_INDEX_FILE)
       
   751 
       
   752 # Set relative location to core api document root
       
   753 $(SMARTCARDIO_INDEX_FILE): GET2DOCSDIR=$(SMARTCARDIO2COREAPI)/..
       
   754 
       
   755 # Run javadoc if the index file is out of date or missing
       
   756 $(SMARTCARDIO_INDEX_FILE): $(SMARTCARDIO_OPTIONS_FILE) $(SMARTCARDIO_PACKAGES_FILE)
       
   757 	$(prep-javadoc)
       
   758 	$(call JavadocSummary,$(SMARTCARDIO_OPTIONS_FILE),$(SMARTCARDIO_PACKAGES_FILE))
       
   759 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   760 	  @$(SMARTCARDIO_OPTIONS_FILE) @$(SMARTCARDIO_PACKAGES_FILE)
       
   761 
       
   762 # Create file with javadoc options in it
       
   763 $(SMARTCARDIO_OPTIONS_FILE):
       
   764 	$(prep-target)
       
   765 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   766 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   767 	  $(call OptionPair,-encoding,ascii)				; \
       
   768 	  $(call OptionOnly,-nodeprecatedlist)				; \
       
   769 	  $(call OptionPair,-doctitle,$(SMARTCARDIO_DOCTITLE))		; \
       
   770 	  $(call OptionPair,-windowtitle,$(SMARTCARDIO_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
   771 	  $(call OptionPair,-header,$(SMARTCARDIO_HEADER)$(DRAFT_HEADER)); \
       
   772 	  $(call OptionPair,-bottom,$(SMARTCARDIO_BOTTOM)$(DRAFT_BOTTOM)); \
       
   773 	  $(call OptionTrip,-linkoffline,$(SMARTCARDIO2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   774         ) >> $@
       
   775 
       
   776 # Create a file with the package names in it
       
   777 $(SMARTCARDIO_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(SMARTCARDIO_PKGS))
       
   778 	$(prep-target)
       
   779 	$(call PackageFilter,$(SMARTCARDIO_PKGS))
       
   780 
       
   781 #############################################################
       
   782 #
       
   783 # httpserverdocs
       
   784 #
       
   785 
       
   786 ALL_OTHER_TARGETS += httpserverdocs
       
   787 
       
   788 HTTPSERVER_DOCDIR      := $(JRE_API_DOCSDIR)/net/httpserver/spec
       
   789 HTTPSERVER2COREAPI     := ../../../$(JDKJRE2COREAPI)
       
   790 HTTPSERVER_DOCTITLE    := Java$(TRADEMARK) HTTP Server
       
   791 HTTPSERVER_WINDOWTITLE := Java HTTP Server
       
   792 HTTPSERVER_HEADER      := <strong>Java HTTP Server</strong>
       
   793 HTTPSERVER_BOTTOM      := $(call CommonBottom,$(HTTPSERVER_FIRST_COPYRIGHT_YEAR))
       
   794 # HTTPSERVER_PKGS is located in NON_CORE_PKGS.gmk
       
   795 
       
   796 HTTPSERVER_INDEX_HTML    = $(HTTPSERVER_DOCDIR)/index.html
       
   797 HTTPSERVER_OPTIONS_FILE  = $(DOCSTMPDIR)/httpserver.options
       
   798 HTTPSERVER_PACKAGES_FILE = $(DOCSTMPDIR)/httpserver.packages
       
   799 
       
   800 httpserverdocs: $(HTTPSERVER_INDEX_HTML)
       
   801 
       
   802 # Set relative location to core api document root
       
   803 $(HTTPSERVER_INDEX_HTML): GET2DOCSDIR=$(HTTPSERVER2COREAPI)/..
       
   804 
       
   805 # Run javadoc if the index file is out of date or missing
       
   806 $(HTTPSERVER_INDEX_HTML): $(HTTPSERVER_OPTIONS_FILE) $(HTTPSERVER_PACKAGES_FILE)
       
   807 	$(prep-javadoc)
       
   808 	$(call JavadocSummary,$(HTTPSERVER_OPTIONS_FILE),$(HTTPSERVER_PACKAGES_FILE))
       
   809 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   810 	  @$(HTTPSERVER_OPTIONS_FILE) @$(HTTPSERVER_PACKAGES_FILE)
       
   811 
       
   812 # Create file with javadoc options in it
       
   813 $(HTTPSERVER_OPTIONS_FILE):
       
   814 	$(prep-target)
       
   815 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   816 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   817 	  $(call OptionPair,-encoding,ascii)				; \
       
   818 	  $(call OptionOnly,-nodeprecatedlist)				; \
       
   819 	  $(call OptionPair,-doctitle,$(HTTPSERVER_DOCTITLE))		; \
       
   820 	  $(call OptionPair,-windowtitle,$(HTTPSERVER_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
   821 	  $(call OptionPair,-header,$(HTTPSERVER_HEADER)$(DRAFT_HEADER)); \
       
   822 	  $(call OptionPair,-bottom,$(HTTPSERVER_BOTTOM)$(DRAFT_BOTTOM)); \
       
   823 	  $(call OptionTrip,-linkoffline,$(HTTPSERVER2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   824         ) >> $@
       
   825 
       
   826 # Create a file with the package names in it
       
   827 $(HTTPSERVER_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(HTTPSERVER_PKGS))
       
   828 	$(prep-target)
       
   829 	$(call PackageFilter,$(HTTPSERVER_PKGS))
       
   830 
       
   831 #############################################################
       
   832 #
       
   833 # mgmtdocs
       
   834 #
       
   835 
       
   836 ALL_OTHER_TARGETS += mgmtdocs
       
   837 
       
   838 MGMT_DOCDIR	 := $(JRE_API_DOCSDIR)/management/extension
       
   839 MGMT2COREAPI     := ../../$(JDKJRE2COREAPI)
       
   840 JVM_MIB_NAME     := JVM-MANAGEMENT-MIB.mib
       
   841 JVM_MIB_SRC      := $(CLOSED_SRC)/share/classes/sun/management/snmp/$(JVM_MIB_NAME)
       
   842 MGMT_DOCTITLE    := Monitoring and Management Interface for the Java$(TRADEMARK) Platform
       
   843 MGMT_WINDOWTITLE := Monitoring and Management Interface for the Java Platform
       
   844 MGMT_HEADER      := <strong>Monitoring and Management Interface for the Java Platform</strong>
       
   845 MGMT_BOTTOM      := $(call CommonBottom,$(MGMT_FIRST_COPYRIGHT_YEAR))
       
   846 MGMT_OVERVIEW    := $(SHARE_SRC)/classes/com/sun/management/mgmt-overview.html
       
   847 # MGMT_PKGS is located in NON_CORE_PKGS.gmk
       
   848 
       
   849 # The index.html, options, and packages files
       
   850 MGMT_INDEX_FILE    = $(MGMT_DOCDIR)/index.html
       
   851 MGMT_OPTIONS_FILE  = $(DOCSTMPDIR)/mgmt.options
       
   852 MGMT_PACKAGES_FILE = $(DOCSTMPDIR)/mgmt.packages
       
   853 
       
   854 mgmtdocs: $(MGMT_INDEX_FILE)
       
   855 
       
   856 # Set relative location to core api document root
       
   857 $(MGMT_INDEX_FILE): GET2DOCSDIR=$(MGMT2COREAPI)/..
       
   858 
       
   859 # Run javadoc if the index file is out of date or missing
       
   860 $(MGMT_INDEX_FILE): $(MGMT_OPTIONS_FILE) $(MGMT_PACKAGES_FILE)
       
   861 	$(prep-javadoc)
       
   862 	@if [ -f $(JVM_MIB_SRC) ] ; then 				\
       
   863 	  $(ECHO) "$(CP) $(JVM_MIB_SRC) $(@D)/.."; 			\
       
   864 	  $(CP) $(JVM_MIB_SRC) $(@D)/.. ; 				\
       
   865 	else 								\
       
   866 	  $(ECHO) "WARNING: File $(JVM_MIB_NAME) not available."; 	\
       
   867 	fi
       
   868 	$(call JavadocSummary,$(MGMT_OPTIONS_FILE),$(MGMT_PACKAGES_FILE))
       
   869 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   870 	  @$(MGMT_OPTIONS_FILE) @$(MGMT_PACKAGES_FILE)
       
   871 
       
   872 # Create file with javadoc options in it
       
   873 $(MGMT_OPTIONS_FILE): $(MGMT_OVERVIEW)
       
   874 	$(prep-target)
       
   875 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   876 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   877 	  $(call OptionPair,-encoding,ascii)				; \
       
   878 	  $(call OptionOnly,-nodeprecatedlist)				; \
       
   879 	  $(call OptionPair,-overview,$(MGMT_OVERVIEW))			; \
       
   880 	  $(call OptionPair,-doctitle,$(MGMT_DOCTITLE))			; \
       
   881 	  $(call OptionPair,-windowtitle,$(MGMT_WINDOWTITLE) $(DRAFT_WINTITLE)); \
       
   882 	  $(call OptionPair,-header,$(MGMT_HEADER)$(DRAFT_HEADER))	; \
       
   883 	  $(call OptionPair,-bottom,$(MGMT_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   884 	  $(call OptionTrip,-linkoffline,$(MGMT2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   885         ) >> $@
       
   886 
       
   887 # Create a file with the package names in it
       
   888 $(MGMT_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(MGMT_PKGS))
       
   889 	$(prep-target)
       
   890 	$(call PackageFilter,$(MGMT_PKGS))
       
   891 
       
   892 #############################################################
       
   893 #
       
   894 # attachdocs
       
   895 #
       
   896 
       
   897 ALL_OTHER_TARGETS += attachdocs
       
   898 
       
   899 ATTACH_DOCDIR      := $(JDK_API_DOCSDIR)/attach/spec
       
   900 ATTACH2COREAPI     := ../../$(JDKJRE2COREAPI)
       
   901 ATTACH_DOCTITLE    := Attach API
       
   902 ATTACH_WINDOWTITLE := Attach API
       
   903 ATTACH_HEADER      := <strong>Attach API</strong>
       
   904 ATTACH_BOTTOM      := $(call CommonBottom,$(ATTACH_FIRST_COPYRIGHT_YEAR))
       
   905 # ATTACH_PKGS is located in NON_CORE_PKGS.gmk
       
   906 
       
   907 ATTACH_INDEX_HTML    = $(ATTACH_DOCDIR)/index.html
       
   908 ATTACH_OPTIONS_FILE  = $(DOCSTMPDIR)/attach.options
       
   909 ATTACH_PACKAGES_FILE = $(DOCSTMPDIR)/attach.packages
       
   910 
       
   911 attachdocs: $(ATTACH_INDEX_HTML)
       
   912 
       
   913 # Set relative location to core api document root
       
   914 $(ATTACH_INDEX_HTML): GET2DOCSDIR=$(ATTACH2COREAPI)/..
       
   915 
       
   916 # Run javadoc if the index file is out of date or missing
       
   917 $(ATTACH_INDEX_HTML): $(ATTACH_OPTIONS_FILE) $(ATTACH_PACKAGES_FILE)
       
   918 	$(prep-javadoc)
       
   919 	$(call JavadocSummary,$(ATTACH_OPTIONS_FILE),$(ATTACH_PACKAGES_FILE))
       
   920 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   921 	  @$(ATTACH_OPTIONS_FILE) @$(ATTACH_PACKAGES_FILE)
       
   922 
       
   923 # Create file with javadoc options in it
       
   924 $(ATTACH_OPTIONS_FILE):
       
   925 	$(prep-target)
       
   926 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   927 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   928 	  $(call OptionPair,-encoding,ascii)				; \
       
   929 	  $(call OptionOnly,-nodeprecatedlist)				; \
       
   930 	  $(call OptionPair,-doctitle,$(ATTACH_DOCTITLE))		; \
       
   931 	  $(call OptionPair,-windowtitle,$(ATTACH_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
   932 	  $(call OptionPair,-header,$(ATTACH_HEADER)$(DRAFT_HEADER))	; \
       
   933 	  $(call OptionPair,-bottom,$(ATTACH_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   934 	  $(call OptionTrip,-linkoffline,$(ATTACH2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   935         ) >> $@
       
   936 
       
   937 # Create a file with the package names in it
       
   938 $(ATTACH_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(ATTACH_PKGS))
       
   939 	$(prep-target)
       
   940 	$(call PackageFilter,$(ATTACH_PKGS))
       
   941 
       
   942 #############################################################
       
   943 #
       
   944 # jconsoledocs
       
   945 #
       
   946 
       
   947 ALL_OTHER_TARGETS += jconsoledocs
       
   948 
       
   949 JCONSOLE_DOCDIR      := $(JDK_API_DOCSDIR)/jconsole/spec
       
   950 JCONSOLE2COREAPI     := ../../$(JDKJRE2COREAPI)
       
   951 JCONSOLE_DOCTITLE    := JConsole API
       
   952 JCONSOLE_WINDOWTITLE := JConsole API
       
   953 JCONSOLE_HEADER      := <strong>JConsole API</strong>
       
   954 JCONSOLE_BOTTOM      := $(call CommonBottom,$(JCONSOLE_FIRST_COPYRIGHT_YEAR))
       
   955 # JCONSOLE_PKGS is located in NON_CORE_PKGS.gmk
       
   956 
       
   957 JCONSOLE_INDEX_HTML    = $(JCONSOLE_DOCDIR)/index.html
       
   958 JCONSOLE_OPTIONS_FILE  = $(DOCSTMPDIR)/jconsole.options
       
   959 JCONSOLE_PACKAGES_FILE = $(DOCSTMPDIR)/jconsole.packages
       
   960 
       
   961 jconsoledocs: $(JCONSOLE_INDEX_HTML)
       
   962 
       
   963 # Set relative location to core api document root
       
   964 $(JCONSOLE_INDEX_HTML): GET2DOCSDIR=$(JCONSOLE2COREAPI)/..
       
   965 
       
   966 # Run javadoc if the index file is out of date or missing
       
   967 $(JCONSOLE_INDEX_HTML): $(JCONSOLE_OPTIONS_FILE) $(JCONSOLE_PACKAGES_FILE)
       
   968 	$(prep-javadoc)
       
   969 	$(call JavadocSummary,$(JCONSOLE_OPTIONS_FILE),$(JCONSOLE_PACKAGES_FILE))
       
   970 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
   971 	  @$(JCONSOLE_OPTIONS_FILE) @$(JCONSOLE_PACKAGES_FILE)
       
   972 
       
   973 # Create file with javadoc options in it
       
   974 $(JCONSOLE_OPTIONS_FILE):
       
   975 	$(prep-target)
       
   976 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
   977 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
   978 	  $(call OptionPair,-encoding,ascii)				; \
       
   979 	  $(call OptionOnly,-nodeprecatedlist)				; \
       
   980 	  $(call OptionPair,-doctitle,$(JCONSOLE_DOCTITLE))		; \
       
   981 	  $(call OptionPair,-windowtitle,$(JCONSOLE_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
   982 	  $(call OptionPair,-header,$(JCONSOLE_HEADER)$(DRAFT_HEADER))	; \
       
   983 	  $(call OptionPair,-bottom,$(JCONSOLE_BOTTOM)$(DRAFT_BOTTOM))	; \
       
   984 	  $(call OptionTrip,-linkoffline,$(JCONSOLE2COREAPI),$(COREAPI_DOCSDIR)/); \
       
   985         ) >> $@
       
   986 
       
   987 # Create a file with the package names in it
       
   988 $(JCONSOLE_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(JCONSOLE_PKGS))
       
   989 	$(prep-target)
       
   990 	$(call PackageFilter,$(JCONSOLE_PKGS))
       
   991 
       
   992 #############################################################
       
   993 #
       
   994 # treeapidocs
       
   995 #
       
   996 
       
   997 # Part of langtools
       
   998 ifdef LANGTOOLS_DIST
       
   999   ALL_OTHER_TARGETS += treeapidocs
       
  1000 endif
       
  1001 
       
  1002 TREEAPI_DOCDIR       := $(JDK_API_DOCSDIR)/javac/tree
       
  1003 TREEAPI2COREAPI      := ../../$(JDKJRE2COREAPI)
       
  1004 TREEAPI_DOCTITLE     := Compiler Tree API
       
  1005 TREEAPI_WINDOWTITLE  := Compiler Tree API
       
  1006 TREEAPI_HEADER       := <strong>Compiler Tree API</strong>
       
  1007 TREEAPI_BOTTOM       := $(call CommonBottom,$(TREEAPI_FIRST_COPYRIGHT_YEAR))
       
  1008 TREEAPI_GROUPNAME    := Packages
       
  1009 TREEAPI_REGEXP       := com.sun.source.*
       
  1010 # TREEAPI_PKGS is located in NON_CORE_PKGS.gmk
       
  1011 
       
  1012 TREEAPI_INDEX_HTML    = $(TREEAPI_DOCDIR)/index.html
       
  1013 TREEAPI_OPTIONS_FILE  = $(DOCSTMPDIR)/treeapi.options
       
  1014 TREEAPI_PACKAGES_FILE = $(DOCSTMPDIR)/treeapi.packages
       
  1015 
       
  1016 treeapidocs: $(TREEAPI_INDEX_HTML)
       
  1017 
       
  1018 # Set relative location to core api document root
       
  1019 $(TREEAPI_INDEX_HTML): GET2DOCSDIR=$(TREEAPI2COREAPI)/..
       
  1020 
       
  1021 # Run javadoc if the index file is out of date or missing
       
  1022 $(TREEAPI_INDEX_HTML): $(TREEAPI_OPTIONS_FILE) $(TREEAPI_PACKAGES_FILE)
       
  1023 	$(prep-javadoc)
       
  1024 	$(call JavadocSummary,$(TREEAPI_OPTIONS_FILE),$(TREEAPI_PACKAGES_FILE))
       
  1025 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
  1026 	  @$(TREEAPI_OPTIONS_FILE) @$(TREEAPI_PACKAGES_FILE)
       
  1027 
       
  1028 # Create file with javadoc options in it
       
  1029 $(TREEAPI_OPTIONS_FILE):
       
  1030 	$(prep-target)
       
  1031 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
  1032 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
  1033 	  $(call OptionPair,-encoding,ascii)				; \
       
  1034 	  $(call OptionPair,-doctitle,$(TREEAPI_DOCTITLE))		; \
       
  1035 	  $(call OptionPair,-windowtitle,$(TREEAPI_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
  1036 	  $(call OptionPair,-header,$(TREEAPI_HEADER)$(DRAFT_HEADER))	; \
       
  1037           $(call OptionPair,-tag,$(TAG_JLS)) 				; \
       
  1038 	  $(call OptionPair,-bottom,$(TREEAPI_BOTTOM)$(DRAFT_BOTTOM))	; \
       
  1039 	  $(call OptionTrip,-group,$(TREEAPI_GROUPNAME),$(TREEAPI_REGEXP)); \
       
  1040 	  $(call OptionTrip,-linkoffline,$(TREEAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
       
  1041         ) >> $@
       
  1042 
       
  1043 # Create a file with the package names in it
       
  1044 $(TREEAPI_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(TREEAPI_PKGS))
       
  1045 	$(prep-target)
       
  1046 	$(call PackageFilter,$(TREEAPI_PKGS))
       
  1047 
       
  1048 #############################################################
       
  1049 #
       
  1050 # sctpdocs
       
  1051 #
       
  1052 
       
  1053 ALL_OTHER_TARGETS += sctpdocs
       
  1054 
       
  1055 SCTPAPI_DOCDIR      := $(JRE_API_DOCSDIR)/nio/sctp/spec
       
  1056 SCTPAPI2COREAPI     := ../../../$(JDKJRE2COREAPI)
       
  1057 SCTPAPI_DOCTITLE    := SCTP API
       
  1058 SCTPAPI_WINDOWTITLE := SCTP API
       
  1059 SCTPAPI_HEADER      := <strong>SCTP API</strong>
       
  1060 SCTPAPI_BOTTOM      := $(call CommonBottom,$(SCTPAPI_FIRST_COPYRIGHT_YEAR))
       
  1061 # SCTPAPI_PKGS is located in NON_CORE_PKGS.gmk
       
  1062 
       
  1063 SCTPAPI_INDEX_HTML    = $(SCTPAPI_DOCDIR)/index.html
       
  1064 SCTPAPI_OPTIONS_FILE  = $(DOCSTMPDIR)/sctp.options
       
  1065 SCTPAPI_PACKAGES_FILE = $(DOCSTMPDIR)/sctp.packages
       
  1066 
       
  1067 sctpdocs: $(SCTPAPI_INDEX_HTML)
       
  1068 
       
  1069 # Set relative location to core api document root
       
  1070 $(SCTSCTSCTP: GET2DOCSDIR=$(SCTPAPI2COREAPI)/..
       
  1071 
       
  1072 # Run javadoc if the index file is out of date or missing
       
  1073 $(SCTPAPI_INDEX_HTML): $(SCTPAPI_OPTIONS_FILE) $(SCTPAPI_PACKAGES_FILE)
       
  1074 	$(prep-javadoc)
       
  1075 	$(call JavadocSummary,$(SCTPAPI_OPTIONS_FILE),$(SCTPAPI_PACKAGES_FILE))
       
  1076 	$(JAVADOC_CMD) $(JAVADOC_VM_MEMORY_FLAGS) -d $(@D) \
       
  1077 	  @$(SCTPAPI_OPTIONS_FILE) @$(SCTPAPI_PACKAGES_FILE)
       
  1078 
       
  1079 # Create file with javadoc options in it
       
  1080 $(SCTPAPI_OPTIONS_FILE):
       
  1081 	$(prep-target)
       
  1082 	@($(call OptionOnly,$(COMMON_JAVADOCFLAGS))			; \
       
  1083 	  $(call OptionPair,-sourcepath,$(RELEASEDOCS_SOURCEPATH))	; \
       
  1084 	  $(call OptionPair,-encoding,ascii)				; \
       
  1085 	  $(call OptionOnly,-nodeprecatedlist)				; \
       
  1086 	  $(call OptionPair,-doctitle,$(SCTPAPI_DOCTITLE))		; \
       
  1087 	  $(call OptionPair,-windowtitle,$(SCTPAPI_WINDOWTITLE) $(DRAFT_WINTITLE));\
       
  1088 	  $(call OptionPair,-header,$(SCTPAPI_HEADER)$(DRAFT_HEADER))	; \
       
  1089 	  $(call OptionPair,-bottom,$(SCTPAPI_BOTTOM)$(DRAFT_BOTTOM))	; \
       
  1090 	  $(call OptionTrip,-linkoffline,$(SCTPAPI2COREAPI),$(COREAPI_DOCSDIR)/); \
       
  1091         ) >> $@
       
  1092 
       
  1093 # Create a file with the package names in it
       
  1094 $(SCTPAPI_PACKAGES_FILE): $(DIRECTORY_CACHE) $(call PackageDependencies,$(SCTPAPI_PKGS))
       
  1095 	$(prep-target)
       
  1096 	$(call PackageFilter,$(SCTPAPI_PKGS))
       
  1097 
       
  1098 #############################################################
       
  1099 #
       
  1100 # Get a cache of all the directories
       
  1101 
       
  1102 $(DIRECTORY_CACHE): $(ALL_EXISTING_SOURCE_DIRS)
       
  1103 	$(prep-target)
       
  1104 	@for cp in $(ALL_EXISTING_SOURCE_DIRS) ; do 	\
       
  1105 	  $(ECHO) "$(FIND) $${cp} -type f >> $@"; 	\
       
  1106 	  $(FIND) $${cp} -type f >> $@; 		\
       
  1107 	done
       
  1108 
       
  1109 #############################################################
       
  1110 #release version of core packages ########
       
  1111 # Maximize performance and ensure that build number & milestone are set.
       
  1112 
       
  1113 rel-coredocs: sanitycheckcoredocs
       
  1114 	$(MAKE) coredocs
       
  1115 
       
  1116 rel-docs: rel-coredocs $(ALL_OTHER_TARGETS)
       
  1117 #
       
  1118 # end of production targets
       
  1119 
       
  1120 otherdocs: $(ALL_OTHER_TARGETS)
       
  1121 
       
  1122 clean:
       
  1123 	$(RM) -r $(DOCSDIR) $(DOCSTMPDIR)
       
  1124 
       
  1125 #############################################################
       
  1126 # DEBUG TARGET
       
  1127 # List the values defined in the makefile hierarchy, to make sure everything
       
  1128 # is set properly, and to help identify values we can use instead of making new ones.
       
  1129 # (Most of them come from common/shared/Defs.gmk)
       
  1130 #
       
  1131 #  Notes:
       
  1132 #    * BUILD_NUMBER defaults to b00 if not set on command line with BUILD_NUMBER=<value>
       
  1133 #    * MILESTONE defaults to internal unless set to beta, rc, or fcs on command line
       
  1134 #
       
  1135 
       
  1136 echovalues:
       
  1137 	@$(ECHO) ""
       
  1138 	@$(ECHO) --------------Imports---------------------------
       
  1139 	@$(ECHO) "IMPORT_PACKAGES = $(IMPORT_PACKAGES)"
       
  1140 	@$(ECHO) "IMPORT_PACKAGE_FILTER = $(IMPORT_PACKAGE_FILTER)"
       
  1141 	@$(ECHO) --------------Imports---------------------------
       
  1142 	@$(ECHO) ""
       
  1143 	@$(ECHO) --------------Shared---------------------------
       
  1144 	@$(ECHO) BUILD_NUMBER = $(BUILD_NUMBER)
       
  1145 	@$(ECHO) FULL_VERSION = $(FULL_VERSION)
       
  1146 	@$(ECHO) JDK_VERSION = $(JDK_VERSION)
       
  1147 	@$(ECHO) JDK_MAJOR_VERSION = $(JDK_MAJOR_VERSION)
       
  1148 	@$(ECHO) JDK_MINOR_VERSION = $(JDK_MINOR_VERSION)
       
  1149 	@$(ECHO) JDK_MICRO_VERSION = $(JDK_MICRO_VERSION)
       
  1150 	@$(ECHO) JDK_UPDATE_VERSION = $(JDK_UPDATE_VERSION)
       
  1151 	@$(ECHO) JDK_MKTG_VERSION = $(JDK_MKTG_VERSION)
       
  1152 	@$(ECHO) JDK_UNDERSCORE_VERSION = $(JDK_UNDERSCORE_VERSION)
       
  1153 	@$(ECHO) JDK_MKTG_UNDERSCORE_VERSION = $(JDK_MKTG_UNDERSCORE_VERSION)
       
  1154 	@$(ECHO) MARKETING_NUMBER = $(MARKETING_NUMBER)
       
  1155 	@$(ECHO) MARKET_NAME = $(MARKET_NAME)
       
  1156 	@$(ECHO) MILESTONE = $(MILESTONE)
       
  1157 	@$(ECHO) RELEASE = $(RELEASE)
       
  1158 	@$(ECHO) USER_RELEASE_SUFFIX = $(USER_RELEASE_SUFFIX)
       
  1159 	@$(ECHO) --------------Shared---------------------------
       
  1160 	@$(ECHO) ""
       
  1161 	@$(ECHO) --------------common/Defs---------------------------
       
  1162 	@$(ECHO) "RELEASEDOCS_SOURCEPATH"
       
  1163 	@$(ECHO) "   SHARE_SRC/classes: $(SHARE_SRC)/classes"
       
  1164 	@$(ECHO) "   PLATFORM_SRC/classes: $(PLATFORM_SRC)/classes"
       
  1165 	@$(ECHO) "   GENSRCDIR: $(GENSRCDIR)"
       
  1166 	@$(ECHO) "   SHARE_SRC/doc/stub: $(SHARE_SRC)/doc/stub"
       
  1167 	@$(ECHO) "   IMPORTSRCDIR: $(IMPORTSRCDIR)"
       
  1168 	@$(ECHO) --------------common/Defs---------------------------
       
  1169 	@$(ECHO) ""
       
  1170 
       
  1171 #############################################################
       
  1172 .PHONY: all docs coredocs rel-docs echovalues otherdocs rel-coredocs \
       
  1173         sanitycheckcoredocs $(ALL_OTHER_TARGETS)
       
  1174