make/Javadoc.gmk
author dholmes
Tue, 31 Jan 2017 19:26:10 -0500
changeset 43611 e6396b0cd092
parent 43047 28be7f773e4e
child 43171 61b58ba86188
permissions -rw-r--r--
8173421: Obsolete and expired flags for JDK 10 need to be removed and related tests updated Reviewed-by: mchung
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
43047
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
     1
# Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     2
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     3
#
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     4
# This code is free software; you can redistribute it and/or modify it
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     5
# under the terms of the GNU General Public License version 2 only, as
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     6
# published by the Free Software Foundation.  Oracle designates this
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     7
# particular file as subject to the "Classpath" exception as provided
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     8
# by Oracle in the LICENSE file that accompanied this code.
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
     9
#
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    10
# This code is distributed in the hope that it will be useful, but WITHOUT
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    11
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    12
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    13
# version 2 for more details (a copy is included in the LICENSE file that
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    14
# accompanied this code).
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    15
#
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    16
# You should have received a copy of the GNU General Public License version
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    17
# 2 along with this work; if not, write to the Free Software Foundation,
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    18
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    19
#
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    20
# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    21
# or visit www.oracle.com if you need additional information or have any
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    22
# questions.
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    23
#
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    24
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    25
default: all
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    26
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    27
include $(SPEC)
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    28
include MakeBase.gmk
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    29
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    30
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    31
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    32
# List of all possible directories for javadoc to look for sources
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    33
# Allow custom to overwrite.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    34
JAVADOC_SOURCE_DIRS = \
36506
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    35
      $(SUPPORT_OUTPUTDIR)/gensrc/* \
42289
08548fd6e608 8169069: Module system implementation refresh (11/2016)
alanb
parents: 41652
diff changeset
    36
      $(addsuffix /*, $(IMPORT_MODULES_SRC)) \
36506
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    37
      $(JDK_TOPDIR)/src/*/$(OPENJDK_TARGET_OS)/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    38
      $(JDK_TOPDIR)/src/*/$(OPENJDK_TARGET_OS_TYPE)/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    39
      $(JDK_TOPDIR)/src/*/share/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    40
      $(HOTSPOT_TOPDIR)/src/*/share/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    41
      $(LANGTOOLS_TOPDIR)/src/*/share/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    42
      $(NASHORN_TOPDIR)/src/*/share/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    43
      $(CORBA_TOPDIR)/src/*/share/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    44
      $(JAXP_TOPDIR)/src/*/share/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    45
      $(JAXWS_TOPDIR)/src/*/share/classes \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    46
      $(SUPPORT_OUTPUTDIR)/rmic/* \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    47
      $(JDK_TOPDIR)/src/*/share/doc/stub \
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    48
      #
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
    49
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    50
# Should we use -Xdocrootparent? Allow custom to overwrite.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    51
DOCROOTPARENT_FLAG = TRUE
37034
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
    52
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    53
# URLs
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    54
JAVADOC_BASE_URL := http://docs.oracle.com/javase/$(VERSION_SPECIFICATION)/docs
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    55
BUG_SUBMIT_URL := http://bugreport.java.com/bugreport/
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    56
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    57
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    58
# Text snippets
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    59
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    60
FULL_COMPANY_NAME := Oracle and/or its affiliates
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
    61
COMPANY_ADDRESS := 500 Oracle Parkway<br>Redwood Shores, CA 94065 USA
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    62
BUG_SUBMIT_LINE := <a href="$(BUG_SUBMIT_URL)">Submit a bug or feature</a>
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    63
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
    64
COMMON_BOTTOM_TEXT := $(BUG_SUBMIT_LINE)<br> Java is a trademark or registered \
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
    65
    trademark of $(FULL_COMPANY_NAME) in the US and other countries.
25614
0d18591d71d8 8051010: Support @apiNote, @implSpec and @implNote in all javadoc bundles
mduigou
parents: 25046
diff changeset
    66
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    67
CORE_BOTTOM_COPYRIGHT_URL := {@docroot}/../legal/cpyr.html
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    68
CORE_BOTTOM_TEXT := \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    69
    $(BUG_SUBMIT_LINE) \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    70
    <br>For further API reference and developer documentation, see \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    71
    <a href="$(JAVADOC_BASE_URL)/index.html" target="_blank">Java SE \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    72
    Documentation</a>. That documentation contains more detailed, \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    73
    developer-targeted descriptions, with conceptual overviews, definitions of \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    74
    terms, workarounds, and working code examples.
25614
0d18591d71d8 8051010: Support @apiNote, @implSpec and @implNote in all javadoc bundles
mduigou
parents: 25046
diff changeset
    75
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    76
ifeq ($(VERSION_IS_GA), true)
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    77
  DRAFT_MARKER :=
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    78
  DRAFT_WINDOW_TITLE_MARKER :=
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    79
  EARLYACCESS_TOP :=
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    80
else
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    81
  # We need a draft format when not building the GA version.
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    82
  DRAFT_MARKER := <br><strong>DRAFT&nbsp;$(VERSION_STRING)</strong>
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
    83
  ifeq ($(VERSION_BUILD), 0)
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    84
    DRAFT_WINDOW_TITLE_MARKER := $(SPACE)[ad-hoc build]
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
    85
  else
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    86
    DRAFT_WINDOW_TITLE_MARKER := $(SPACE)[build $(VERSION_BUILD)]
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
    87
  endif
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    88
  EARLYACCESS_TOP := \
43044
6ff517127736 8171932: unresolved macro in javadoc command
erikj
parents: 42851
diff changeset
    89
      <div style="background-color: $(HASH)EEEEEE"><div style="padding: 6px; \
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    90
      margin-top: 2px; margin-bottom: 6px; margin-left: 6px; margin-right: \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    91
      6px; text-align: justify; font-size: 80%; font-family: Helvetica, Arial, \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    92
      sans-serif; font-weight: normal;">Please note that the specifications \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    93
      and other information contained herein are not final and are subject to \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    94
      change. The information is being made available to you solely for \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    95
      purpose of evaluation.</div></div>
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    96
endif
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
    97
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
    98
################################################################################
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
    99
# Special treatment for the core package list. All separate "small" javadoc
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   100
# invocation needs to be able to see the core package list.
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   101
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   102
ALL_PKG_DIRS := $(dir $(filter %.java, $(call CacheFind, \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   103
    $(wildcard $(JAVADOC_SOURCE_DIRS)))))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   104
ALL_SRC_PREFIXES := $(addsuffix /%, $(wildcard $(JAVADOC_SOURCE_DIRS)))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   105
ALL_PKG_DIRNAMES := $(foreach prefix, $(ALL_SRC_PREFIXES), \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   106
    $(patsubst $(prefix),%, $(filter $(prefix), $(ALL_PKG_DIRS))))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   107
ALL_PACKAGES := $(sort $(subst /,., $(patsubst %/, %, $(ALL_PKG_DIRNAMES))))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   108
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   109
# Core packages are all packages beginning with java, javax or org, except a few
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   110
# excludes.
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   111
JAVA_PACKAGES := $(filter java.%, $(ALL_PACKAGES))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   112
JAVAX_PACKAGES := $(filter javax.%, $(ALL_PACKAGES))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   113
ORG_PACKAGES := $(filter org.%, $(ALL_PACKAGES))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   114
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   115
# Allow custom makefile to add more excluded packages
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   116
CORE_EXCLUDED_PACKAGES += \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   117
    java.awt.dnd.peer \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   118
    java.awt.peer \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   119
    javax.smartcardio \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   120
    org.jcp.xml.dsig.internal% \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   121
    org.w3c.dom.css \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   122
    org.w3c.dom.html \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   123
    org.w3c.dom.stylesheets \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   124
    org.w3c.dom.xpath \
42531
37ee95196b17 8166417: Integrate Graal-core into JDK for AOT compiler
kvn
parents: 42290
diff changeset
   125
    org.graalvm.compiler.% \
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   126
    #
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   127
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   128
CORE_PACKAGES := $(filter-out $(CORE_EXCLUDED_PACKAGES), \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   129
    $(JAVA_PACKAGES) $(JAVAX_PACKAGES) $(ORG_PACKAGES))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   130
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   131
CORE_PACKAGES_LIST_DIR := $(SUPPORT_OUTPUTDIR)/docs/core-packages
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   132
CORE_PACKAGES_LIST_FILE := $(CORE_PACKAGES_LIST_DIR)/package-list
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   133
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   134
CORE_PACKAGES_VARDEPS_FILE := $(call DependOnVariable, CORE_PACKAGES, \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   135
    $(CORE_PACKAGES_LIST_FILE).vardeps)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   136
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   137
$(CORE_PACKAGES_LIST_FILE): $(CORE_PACKAGES_VARDEPS_FILE)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   138
	$(call MakeDir, $(@D))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   139
	$(eval $(call ListPathsSafely, CORE_PACKAGES, $@))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   140
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   141
################################################################################
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   142
# Support functions for SetupJavadocGeneration
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   143
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   144
# Generate the text used in the -bottom argument.
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   145
# Note that COPYRIGHT_YEAR is the current year (from spec.gmk)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   146
# Arguments:
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   147
# arg 1: first copyright year
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   148
# arg 2: copyright url (optional)
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   149
# arg 3: free-form text snippet (optional)
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   150
define GenerateBottom
42851
72e5b4fb1e1b 8171978: docs should use CSS-friendly <span> instead of <font>
jjg
parents: 42539
diff changeset
   151
  <span style="font-size:smaller">$(if $(strip $3), $(strip $3))<br> $(if \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   152
      $(strip $2),<a href="$(strip $2)">Copyright</a>,Copyright) \
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   153
      &copy; $(strip $1), $(COPYRIGHT_YEAR), $(FULL_COMPANY_NAME). \
42851
72e5b4fb1e1b 8171978: docs should use CSS-friendly <span> instead of <font>
jjg
parents: 42539
diff changeset
   154
      $(COMPANY_ADDRESS). All rights reserved.</span>
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   155
endef
27328
17f2bc9cd16a 8062475: Enable hook for custom doc generation
rriggs
parents: 26119
diff changeset
   156
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   157
# Speed up finding by filling cache
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   158
$(eval $(call FillCacheFind, $(wildcard $(JAVADOC_SOURCE_DIRS))))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   159
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   160
# In order to get a specific ordering it's necessary to specify the total
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   161
# ordering of tags as the tags are otherwise ordered in order of definition.
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   162
DEFAULT_JAVADOC_TAGS := \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   163
    -tag beaninfo:X \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   164
    -tag revised:X \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   165
    -tag since.unbundled:X \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   166
    -tag spec:X \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   167
    -tag specdefault:X \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   168
    -tag Note:X \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   169
    -tag ToDo:X \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   170
    -tag 'apiNote:a:API Note:' \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   171
    -tag 'implSpec:a:Implementation Requirements:' \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   172
    -tag 'implNote:a:Implementation Note:' \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   173
    -tag param \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   174
    -tag return \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   175
    -tag throws \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   176
    -tag since \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   177
    -tag version \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   178
    -tag serialData \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   179
    -tag factory \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   180
    -tag see \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   181
    -tag 'jvms:a:See <cite>The Java&trade; Virtual Machine Specification</cite>:' \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   182
    -tag 'jls:a:See <cite>The Java&trade; Language Specification</cite>:' \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   183
    #
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   184
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   185
DEFAULT_JAVADOC_OPTIONS := -XDignore.symbol.file=true -use -keywords -notimestamp \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   186
    -serialwarn -encoding ISO-8859-1 -breakiterator --system none
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   187
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   188
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   189
# Setup make rules for running javadoc.
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   190
#
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   191
# Parameter 1 is the name of the rule. This name is used as variable prefix,
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   192
# and the targets generated are listed in a variable by that name. Note that
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   193
# the index.html file will work as a "touch file" for all the magnitude of
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   194
# files that are generated by javadoc.
37034
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   195
#
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   196
# Remaining parameters are named arguments. These include:
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   197
#   MODULES - Modules to include
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   198
#   PACKAGES - Packages to include
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   199
#   IS_CORE - Set to TRUE for the Core API package which needs special treatment
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   200
#   API_ROOT - Where to base the documentation (jre or jdk)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   201
#   DEST_DIR - A directory relative to the API root
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   202
#   OVERVIEW - Path to a html overview file
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   203
#   TITLE - Default title to use for the more specific versions below
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   204
#   WINDOW_TITLE - Title to use in -windowtitle. Computed from TITLE if empty.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   205
#   HEADER_TITLE - Title to use in -header. Computed from TITLE if empty.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   206
#   DOC_TITLE - Title to use in -doctitle. Computed from TITLE if empty.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   207
#   FIRST_COPYRIGHT_YEAR - First year this bundle was introduced
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   208
#   DISABLED_DOCLINT - Doclint warnings to exclude.
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   209
#   DOCLINT_PACKAGES - Optional -Xdoclint/package value
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   210
#   SPLIT_INDEX - Enable -splitIndex (split index-all.html if it is too large)
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   211
#   BOTTOM_COPYRIGHT_URL - Copyright URL to use in -bottom
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   212
#   BOTTOM_TEXT - Extra text to use in -bottom
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   213
#   EXTRA_TOP - Additional -top data
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   214
#
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   215
SetupJavadocGeneration = $(NamedParamsMacroTemplate)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   216
define SetupJavadocGenerationBody
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   217
  ifeq ($$($1_IS_CORE), TRUE)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   218
    $1_JAVA := $$(JAVA)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   219
    $1_OUTPUT_DIRNAME := api
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   220
  else
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   221
    $1_JAVA := $$(JAVA_SMALL)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   222
    $1_OUTPUT_DIRNAME := $$($1_API_ROOT)/api/$$($1_DEST_DIR)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   223
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   224
    # Compute a relative path to core root.
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   225
    # The non-core api javadocs need to be able to access the root of the core
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   226
    # api directory, so for jdk/api or jre/api to get to the core api/
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   227
    # directory we would use this
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   228
    $1_RELATIVE_CORE_DIR := $$(call DirToDotDot, $$($1_OUTPUT_DIRNAME))/api
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   229
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   230
    # We need to tell javadoc the directory in which to find the core package-list
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   231
    $1_OPTIONS += -linkoffline $$($1_RELATIVE_CORE_DIR) $$(CORE_PACKAGES_LIST_DIR)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   232
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   233
    $1_DEPS += $(CORE_PACKAGES_LIST_FILE)
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   234
  endif
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   235
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   236
  $1_OPTIONS += --add-modules $$(call CommaList, $$($1_MODULES))
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   237
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   238
  ifneq ($$($1_DISABLED_DOCLINT), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   239
    # Create a string like ",-syntax,-html"
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   240
    $1_DOCLINT_EXCEPTIONS := ,$$(call CommaList, $$(addprefix -, $$($1_DISABLED_DOCLINT)))
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   241
  endif
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   242
  $1_OPTIONS += -Xdoclint:all$$($1_DOCLINT_EXCEPTIONS)
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   243
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   244
  ifneq ($$($1_DOCLINT_PACKAGES), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   245
    $1_OPTIONS += -Xdoclint/package:$$(call CommaList, $$($1_DOCLINT_PACKAGES))
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   246
  endif
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   247
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   248
  ifeq ($$($1_DOC_TITLE), )
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   249
    $1_DOC_TITLE := $$($1_TITLE)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   250
  endif
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   251
  $1_OPTIONS += -doctitle '$$($1_DOC_TITLE)'
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   252
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   253
  ifeq ($$($1_WINDOW_TITLE), )
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   254
    $1_WINDOW_TITLE := $$(strip $$(subst &trade;,, $$($1_TITLE)))
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   255
  endif
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   256
  $1_OPTIONS += -windowtitle '$$($1_WINDOW_TITLE)$$(DRAFT_WINDOW_TITLE_MARKER)'
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   257
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   258
  ifeq ($$($1_HEADER_TITLE), )
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   259
    $1_HEADER_TITLE := $$(strip $$(subst &trade;,, $$($1_TITLE)))
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   260
  endif
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   261
  $1_OPTIONS += -header '<strong>$$($1_HEADER_TITLE)</strong>$$(DRAFT_MARKER)'
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   262
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   263
  ifneq ($$($1_EXTRA_TOP), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   264
    $1_OPTIONS += -top '$$($1_EXTRA_TOP)'
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   265
  endif
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   266
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   267
  ifeq ($$($1_BOTTOM_TEXT), )
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   268
    $1_BOTTOM_TEXT := $(COMMON_BOTTOM_TEXT)
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   269
  endif
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   270
  $1_BOTTOM := $$(call GenerateBottom, $$($1_FIRST_COPYRIGHT_YEAR), \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   271
      $$($1_BOTTOM_COPYRIGHT_URL), $$($1_BOTTOM_TEXT))
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   272
  $1_OPTIONS += -bottom '$$($1_BOTTOM)$$(DRAFT_MARKER)'
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   273
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   274
  ifneq ($$($1_OVERVIEW), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   275
    $1_OPTIONS += -overview $$($1_OVERVIEW)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   276
    $1_DEPS +=  $$($1_OVERVIEW)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   277
  endif
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   278
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   279
  ifneq ($$($1_SPLIT_INDEX), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   280
    $1_OPTIONS += -splitIndex
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   281
  endif
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   282
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   283
  ifneq ($$($DOCROOTPARENT_FLAG), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   284
    $1_OPTIONS += -Xdocrootparent $(JAVADOC_BASE_URL)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   285
  endif
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   286
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   287
  $1_VARDEPS := $$($1_OPTIONS) $$($1_PACKAGES)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   288
  $1_VARDEPS_FILE := $$(call DependOnVariable, $1_VARDEPS, \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   289
       $$(SUPPORT_OUTPUTDIR)/docs/$1.vardeps)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   290
43047
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
   291
  # Do not store debug level options in VARDEPS.
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
   292
  ifneq ($$(LOG_LEVEL), trace)
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
   293
    $1_OPTIONS += -quiet
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
   294
  else
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
   295
    $1_OPTIONS += -verbose
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
   296
  endif
28be7f773e4e 8172562: Changing log level on Javadoc causes total rebuild
ihse
parents: 43044
diff changeset
   297
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   298
  $1_PACKAGE_DEPS := $$(call CacheFind, $$(wildcard $$(foreach p, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   299
      $$(subst .,/,$$(strip $$($1_PACKAGES))), \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   300
      $$(addsuffix /$$p, $$(wildcard $$(JAVADOC_SOURCE_DIRS))))))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   301
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   302
  # If there are many packages, use an @-file...
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   303
  ifneq ($$(word 17, $$($1_PACKAGES)), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   304
    $1_PACKAGES_FILE := $$(SUPPORT_OUTPUTDIR)/docs/$1.packages
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   305
    $1_PACKAGES_ARG := @$$($1_PACKAGES_FILE)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   306
  else
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   307
    $1_PACKAGES_ARG := $$($1_PACKAGES)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   308
  endif
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   309
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   310
  # The index.html which is a marker for all the output from javadoc.
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   311
  $1_INDEX_FILE := $$(JAVADOC_OUTPUTDIR)/$$($1_OUTPUT_DIRNAME)/index.html
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   312
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   313
  # Rule for actually running javadoc
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   314
  $$($1_INDEX_FILE): $$($1_VARDEPS_FILE) $$($1_PACKAGE_DEPS) $$($1_DEPS)
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   315
	$$(call LogWarn, Generating Javadoc from $$(words $$($1_PACKAGES)) package(s) for $$($1_OUTPUT_DIRNAME))
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   316
	$$(call MakeDir, $$(@D))
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   317
        ifneq ($$($1_PACKAGES_FILE), )
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   318
	  $$(eval $$(call ListPathsSafely, $1_PACKAGES, $$($1_PACKAGES_FILE)))
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   319
        endif
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   320
	$$(call ExecuteWithLog, $$(SUPPORT_OUTPUTDIR)/docs/$1.javadoc, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   321
	    $$($1_JAVA) -Djava.awt.headless=true $(NEW_JAVADOC) -d $$(@D) \
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   322
	        $$(DEFAULT_JAVADOC_TAGS) $$(DEFAULT_JAVADOC_OPTIONS) \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   323
	        --module-source-path $$(call PathList, $$(JAVADOC_SOURCE_DIRS)) \
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   324
	        $$($1_OPTIONS) $$($1_PACKAGES_ARG))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   325
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   326
  # The output returned will be the index.html file
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   327
  $1 := $$($1_INDEX_FILE)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   328
endef
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   329
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   330
################################################################################
35367
48968f91bab4 8035473: [javadoc] Revamp the existing Doclet APIs
ksrini
parents: 33934
diff changeset
   331
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   332
$(eval $(call SetupJavadocGeneration, coredocs, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   333
    MODULES := java.se.ee, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   334
    PACKAGES := $(CORE_PACKAGES), \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   335
    IS_CORE := TRUE, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   336
    OVERVIEW := $(JDK_TOPDIR)/src/java.base/share/classes/overview-core.html, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   337
    WINDOW_TITLE := Java Platform SE $(VERSION_SPECIFICATION), \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   338
    HEADER_TITLE := Java&trade;&nbsp;Platform<br>Standard&nbsp;Ed.&nbsp;$(VERSION_SPECIFICATION), \
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   339
    DOC_TITLE := Java&trade; Platform$(COMMA) Standard Edition \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   340
      $(VERSION_SPECIFICATION)<br>API Specification, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   341
    FIRST_COPYRIGHT_YEAR := 1993, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   342
    DISABLED_DOCLINT := accessibility html missing syntax, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   343
    DOCLINT_PACKAGES := -org.omg.* jdk.internal.logging.*, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   344
    SPLIT_INDEX := TRUE, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   345
    BOTTOM_COPYRIGHT_URL := $(CORE_BOTTOM_COPYRIGHT_URL), \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   346
    BOTTOM_TEXT := $(CORE_BOTTOM_TEXT), \
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   347
    EXTRA_TOP := $(EARLYACCESS_TOP), \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   348
))
35367
48968f91bab4 8035473: [javadoc] Revamp the existing Doclet APIs
ksrini
parents: 33934
diff changeset
   349
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   350
TARGETS += $(coredocs)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   351
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   352
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   353
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   354
$(eval $(call SetupJavadocGeneration, docletapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   355
    MODULES := jdk.javadoc, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   356
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   357
        jdk.javadoc.doclet \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   358
        jdk.javadoc.doclet.taglet \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   359
        jdk.javadoc.doclets, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   360
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   361
    DEST_DIR := javadoc/doclet, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   362
    TITLE := Doclet API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   363
    FIRST_COPYRIGHT_YEAR := 1993, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   364
))
35367
48968f91bab4 8035473: [javadoc] Revamp the existing Doclet APIs
ksrini
parents: 33934
diff changeset
   365
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   366
TARGETS += $(docletapi)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   367
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   368
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   369
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   370
$(eval $(call SetupJavadocGeneration, old-docletapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   371
    MODULES := jdk.javadoc, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   372
    PACKAGES := com.sun.javadoc, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   373
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   374
    DEST_DIR := javadoc/old/doclet, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   375
    TITLE := Doclet API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   376
    FIRST_COPYRIGHT_YEAR := 1993, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   377
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   378
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   379
TARGETS += $(old-docletapi)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   380
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   381
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   382
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   383
$(eval $(call SetupJavadocGeneration, tagletapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   384
    MODULES := jdk.javadoc, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   385
    PACKAGES := com.sun.tools.doclets, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   386
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   387
    DEST_DIR := javadoc/old/taglet, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   388
    TITLE := Taglet API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   389
    FIRST_COPYRIGHT_YEAR := 1993, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   390
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   391
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   392
TARGETS += $(tagletapi)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   393
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   394
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   395
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   396
$(eval $(call SetupJavadocGeneration, domapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   397
    MODULES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   398
        java.xml \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   399
        jdk.xml.dom, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   400
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   401
        org.w3c.dom \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   402
        org.w3c.dom.bootstrap \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   403
        org.w3c.dom.ls \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   404
        org.w3c.dom.ranges \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   405
        org.w3c.dom.traversal \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   406
        org.w3c.dom.html \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   407
        org.w3c.dom.stylesheets \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   408
        org.w3c.dom.css \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   409
        org.w3c.dom.events \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   410
        org.w3c.dom.views, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   411
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   412
    DEST_DIR := plugin/dom, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   413
    TITLE := Common DOM API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   414
    FIRST_COPYRIGHT_YEAR := 2005, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   415
    DISABLED_DOCLINT := accessibility html missing, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   416
    SPLIT_INDEX := TRUE, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   417
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   418
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   419
TARGETS += $(domapi)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   420
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   421
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   422
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   423
$(eval $(call SetupJavadocGeneration, jdi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   424
    MODULES := jdk.jdi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   425
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   426
        com.sun.jdi \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   427
        com.sun.jdi.event \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   428
        com.sun.jdi.request \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   429
        com.sun.jdi.connect \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   430
        com.sun.jdi.connect.spi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   431
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   432
    DEST_DIR := jpda/jdi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   433
    OVERVIEW := $(JDK_TOPDIR)/src/jdk.jdi/share/classes/jdi-overview.html, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   434
    TITLE := Java&trade; Debug Interface, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   435
    FIRST_COPYRIGHT_YEAR := 1999, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   436
    DISABLED_DOCLINT := accessibility missing syntax, \
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   437
    SPLIT_INDEX := TRUE, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   438
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   439
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   440
TARGETS += $(jdi)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   441
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   442
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   443
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   444
$(eval $(call SetupJavadocGeneration, jaas, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   445
    MODULES := jdk.security.auth, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   446
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   447
        com.sun.security.auth \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   448
        com.sun.security.auth.callback \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   449
        com.sun.security.auth.login \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   450
        com.sun.security.auth.module, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   451
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   452
    DEST_DIR := security/jaas/spec, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   453
    OVERVIEW := $(JDK_TOPDIR)/src/jdk.security.auth/share/classes/jaas-overview.html, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   454
    TITLE := Java&trade; Authentication and Authorization Service, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   455
    FIRST_COPYRIGHT_YEAR := 1998, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   456
    DISABLED_DOCLINT := missing, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   457
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   458
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   459
TARGETS += $(jaas)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   460
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   461
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   462
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   463
$(eval $(call SetupJavadocGeneration, jgss, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   464
    MODULES := jdk.security.jgss, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   465
    PACKAGES := com.sun.security.jgss, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   466
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   467
    DEST_DIR := security/jgss/spec, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   468
    OVERVIEW := $(JDK_TOPDIR)/src/java.security.jgss/share/classes/jgss-overview.html, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   469
    TITLE := Java&trade; GSS-API Utilities, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   470
    FIRST_COPYRIGHT_YEAR := 2000, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   471
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   472
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   473
TARGETS += $(jgss)
36506
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
   474
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   475
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   476
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   477
$(eval $(call SetupJavadocGeneration, smartcardio, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   478
    MODULES := java.smartcardio, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   479
    PACKAGES := javax.smartcardio, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   480
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   481
    DEST_DIR := security/smartcardio/spec, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   482
    TITLE := Java&trade; Smart Card I/O, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   483
    FIRST_COPYRIGHT_YEAR := 2005, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   484
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   485
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   486
TARGETS += $(smartcardio)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   487
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   488
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   489
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   490
$(eval $(call SetupJavadocGeneration, httpserver, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   491
    MODULES := jdk.httpserver, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   492
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   493
        com.sun.net.httpserver \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   494
        com.sun.net.httpserver.spi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   495
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   496
    DEST_DIR := net/httpserver/spec, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   497
    TITLE := Java&trade; HTTP Server, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   498
    FIRST_COPYRIGHT_YEAR := 2005, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   499
    DISABLED_DOCLINT := accessibility missing syntax, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   500
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   501
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   502
TARGETS += $(httpserver)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   503
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   504
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   505
42427
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   506
$(eval $(call SetupJavadocGeneration, httpclient, \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   507
    MODULES := jdk.incubator.httpclient, \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   508
    PACKAGES := \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   509
        jdk.incubator.http, \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   510
    API_ROOT := jre, \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   511
    DEST_DIR := incubator/httpclient/spec, \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   512
    TITLE := Java&trade; HTTP Client API (incubator module), \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   513
    FIRST_COPYRIGHT_YEAR := 2015, \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   514
    DISABLED_DOCLINT := accessibility missing syntax, \
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   515
))
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   516
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   517
TARGETS += $(httpclient)
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   518
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   519
################################################################################
2c48c5ffb581 8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents: 42290
diff changeset
   520
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   521
$(eval $(call SetupJavadocGeneration, jsobject, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   522
    MODULES := jdk.jsobject, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   523
    PACKAGES := netscape.javascript, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   524
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   525
    DEST_DIR := plugin/jsobject, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   526
    FIRST_COPYRIGHT_YEAR := 1993, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   527
    TITLE := Java&trade; JSObject Doc, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   528
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   529
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   530
TARGETS += $(jsobject)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   531
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   532
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   533
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   534
$(eval $(call SetupJavadocGeneration, mgmt, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   535
    MODULES := jdk.management, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   536
    PACKAGES := com.sun.management, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   537
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   538
    DEST_DIR := management/extension, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   539
    OVERVIEW := $(JDK_TOPDIR)/src/java.management/share/classes/mgmt-overview.html, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   540
    TITLE := Monitoring and Management Interface for the Java&trade; Platform, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   541
    FIRST_COPYRIGHT_YEAR := 2003, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   542
    DISABLED_DOCLINT := accessibility missing reference, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   543
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   544
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   545
TARGETS += $(mgmt)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   546
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   547
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   548
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   549
$(eval $(call SetupJavadocGeneration, attach, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   550
    MODULES := jdk.attach, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   551
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   552
        com.sun.tools.attach \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   553
        com.sun.tools.attach.spi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   554
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   555
    DEST_DIR := attach/spec, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   556
    TITLE := Attach API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   557
    FIRST_COPYRIGHT_YEAR := 2005, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   558
    DISABLED_DOCLINT := reference, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   559
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   560
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   561
TARGETS += $(attach)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   562
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   563
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   564
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   565
$(eval $(call SetupJavadocGeneration, jconsole, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   566
    MODULES := jdk.jconsole, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   567
    PACKAGES := com.sun.tools.jconsole, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   568
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   569
    DEST_DIR := jconsole/spec, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   570
    TITLE := JConsole API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   571
    FIRST_COPYRIGHT_YEAR := 2006, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   572
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   573
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   574
TARGETS += $(jconsole)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   575
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   576
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   577
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   578
$(eval $(call SetupJavadocGeneration, jshellapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   579
    MODULES := jdk.jshell, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   580
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   581
        jdk.jshell \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   582
        jdk.jshell.spi \
42539
d706d00a2719 8170195: jshell tool (make): update javadoc generation for jdk.jshell
rfield
parents: 42533
diff changeset
   583
        jdk.jshell.execution \
d706d00a2719 8170195: jshell tool (make): update javadoc generation for jdk.jshell
rfield
parents: 42533
diff changeset
   584
        jdk.jshell.tool, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   585
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   586
    DEST_DIR := jshell, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   587
    TITLE := JShell API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   588
    FIRST_COPYRIGHT_YEAR := 2015, \
42539
d706d00a2719 8170195: jshell tool (make): update javadoc generation for jdk.jshell
rfield
parents: 42533
diff changeset
   589
    SPLIT_INDEX := TRUE, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   590
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   591
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   592
TARGETS += $(jshellapi)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   593
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   594
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   595
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   596
$(eval $(call SetupJavadocGeneration, treeapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   597
    MODULES := jdk.compiler, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   598
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   599
        com.sun.source.doctree \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   600
        com.sun.source.tree \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   601
        com.sun.source.util, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   602
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   603
    DEST_DIR := javac/tree, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   604
    TITLE := Compiler Tree API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   605
    FIRST_COPYRIGHT_YEAR := 2005, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   606
    SPLIT_INDEX := TRUE, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   607
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   608
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   609
TARGETS += $(treeapi)
36506
17612cee3530 8142968: Module System implementation
alanb
parents: 35817
diff changeset
   610
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   611
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   612
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   613
$(eval $(call SetupJavadocGeneration, nashornapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   614
    MODULES := jdk.scripting.nashorn, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   615
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   616
        jdk.nashorn.api.scripting \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   617
        jdk.nashorn.api.tree, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   618
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   619
    DEST_DIR := nashorn, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   620
    TITLE := Nashorn API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   621
    FIRST_COPYRIGHT_YEAR := 2014, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   622
    SPLIT_INDEX := TRUE, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   623
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   624
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   625
TARGETS += $(nashornapi)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   626
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   627
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   628
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   629
$(eval $(call SetupJavadocGeneration, dynalinkapi, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   630
    MODULES := jdk.dynalink, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   631
    PACKAGES := \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   632
        jdk.dynalink \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   633
        jdk.dynalink.beans \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   634
        jdk.dynalink.linker \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   635
        jdk.dynalink.linker.support \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   636
        jdk.dynalink.support, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   637
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   638
    DEST_DIR := dynalink, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   639
    TITLE := Dynalink API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   640
    FIRST_COPYRIGHT_YEAR := 2015, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   641
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   642
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   643
TARGETS += $(dynalinkapi)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   644
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   645
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   646
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   647
$(eval $(call SetupJavadocGeneration, sctp, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   648
    MODULES := jdk.sctp, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   649
    PACKAGES := com.sun.nio.sctp, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   650
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   651
    DEST_DIR := nio/sctp/spec, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   652
    TITLE := SCTP API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   653
    FIRST_COPYRIGHT_YEAR := 2009, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   654
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   655
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   656
TARGETS += $(sctp)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   657
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   658
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   659
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   660
$(eval $(call SetupJavadocGeneration, jaccess, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   661
    MODULES := jdk.accessibility, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   662
    PACKAGES := com.sun.java.accessibility.util, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   663
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   664
    DEST_DIR := accessibility/jaccess/spec, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   665
    TITLE := JACCESS API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   666
    FIRST_COPYRIGHT_YEAR := 2002, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   667
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   668
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   669
TARGETS += $(jaccess)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   670
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   671
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   672
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   673
$(eval $(call SetupJavadocGeneration, jdknet, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   674
    MODULES := jdk.net, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   675
    PACKAGES := jdk.net, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   676
    API_ROOT := jre, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   677
    DEST_DIR := net/socketoptions/spec, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   678
    TITLE := jdk.net API, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   679
    FIRST_COPYRIGHT_YEAR := 2014, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   680
    DISABLED_DOCLINT := missing, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   681
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   682
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   683
TARGETS += $(jdknet)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   684
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   685
################################################################################
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   686
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   687
# TODO: Need to decide when the plugin API is ready to publish as experimental API.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   688
# This target is temporarily added for internal use for now.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   689
$(eval $(call SetupJavadocGeneration, jlinkplugins, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   690
    MODULES := jdk.jlink, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   691
    PACKAGES := jdk.tools.jlink.plugin, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   692
    API_ROOT := jdk, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   693
    DEST_DIR := jlink, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   694
    TITLE := JLink Plugin API - EXPERIMENTAL, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   695
    FIRST_COPYRIGHT_YEAR := 2015, \
42134
bbcdb49521b1 8169860: Clean up and unify the refactored Javadoc generation
ihse
parents: 41652
diff changeset
   696
    DISABLED_DOCLINT := html missing syntax, \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   697
))
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   698
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   699
TARGETS += $(jlinkplugins)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   700
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   701
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   702
# Copy JDWP html file
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   703
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   704
JDWP_HTML := $(SUPPORT_OUTPUTDIR)/gensrc/jdk.jdi/jdwp-protocol.html
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   705
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   706
$(eval $(call SetupCopyFiles, COPY_JDWP_HTML, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   707
    FILES := $(JDWP_HTML), \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   708
    DEST := $(JAVADOC_OUTPUTDIR)/platform/jpda/jdwp, \
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   709
))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   710
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   711
COPY_TARGETS += $(COPY_JDWP_HTML)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   712
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   713
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   714
# Copy JVMTI html file
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   715
41260
4f71f07b30d1 8150736: Excessive disk space used by build system
erikj
parents: 41172
diff changeset
   716
# Pick jvmti.html from any jvm variant, they are all the same.
4f71f07b30d1 8150736: Excessive disk space used by build system
erikj
parents: 41172
diff changeset
   717
JVMTI_HTML := $(firstword \
4f71f07b30d1 8150736: Excessive disk space used by build system
erikj
parents: 41172
diff changeset
   718
    $(wildcard $(HOTSPOT_OUTPUTDIR)/variant-*/gensrc/jvmtifiles/jvmti.html))
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   719
41260
4f71f07b30d1 8150736: Excessive disk space used by build system
erikj
parents: 41172
diff changeset
   720
$(eval $(call SetupCopyFiles, COPY_JVMTI_HTML, \
4f71f07b30d1 8150736: Excessive disk space used by build system
erikj
parents: 41172
diff changeset
   721
    FILES := $(JVMTI_HTML), \
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   722
    DEST := $(JAVADOC_OUTPUTDIR)/platform/jvmti, \
41260
4f71f07b30d1 8150736: Excessive disk space used by build system
erikj
parents: 41172
diff changeset
   723
))
4f71f07b30d1 8150736: Excessive disk space used by build system
erikj
parents: 41172
diff changeset
   724
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   725
COPY_TARGETS += $(COPY_JVMTI_HTML)
13697
5262b00bc10c 7197849: Update new build-infra makefiles
ohair
parents:
diff changeset
   726
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   727
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   728
# Optional target which bundles all generated javadocs into a zip archive.
37034
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   729
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   730
JAVADOC_ARCHIVE_NAME := jdk-$(VERSION_STRING)-docs.zip
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   731
JAVADOC_ARCHIVE_ASSEMBLY_DIR := $(SUPPORT_OUTPUTDIR)/docs/zip-docs
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   732
JAVADOC_ARCHIVE_DIR := $(OUTPUT_ROOT)/bundles
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   733
JAVADOC_ARCHIVE := $(JAVADOC_ARCHIVE_DIR)/$(JAVADOC_ARCHIVE_NAME)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   734
42135
484c28d7fd1b 8170077: Properly parallelize javadoc generation
ihse
parents: 42134
diff changeset
   735
$(JAVADOC_ARCHIVE): $(TARGETS) $(COPY_TARGETS)
37034
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   736
	$(call LogInfo, Compressing javadoc to single $(JAVADOC_ARCHIVE_NAME))
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   737
	$(MKDIR) -p $(JAVADOC_ARCHIVE_DIR)
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   738
	$(RM) -r $(JAVADOC_ARCHIVE_ASSEMBLY_DIR)
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   739
	$(MKDIR) -p $(JAVADOC_ARCHIVE_ASSEMBLY_DIR)
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   740
	all_roots=`$(FIND) $(JAVADOC_OUTPUTDIR) | $(GREP) index.html | grep -v old/doclet`; \
37034
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   741
	pushd $(JAVADOC_ARCHIVE_ASSEMBLY_DIR); \
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   742
	for index_file in $${all_roots} ; do \
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   743
	  target_dir=`dirname $${index_file}`; \
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   744
	  name=`$(ECHO) $${target_dir} | $(SED) "s;/spec;;" | $(SED) "s;.*/;;"`; \
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   745
	  $(LN) -s $${target_dir}  $${name}; \
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   746
	done; \
42136
f872c8278074 8168037: Use ZIPEXE instead of ZIP to avoid clash with options for zip
ihse
parents: 42135
diff changeset
   747
	$(ZIPEXE) -q -r $(JAVADOC_ARCHIVE) * ; \
37034
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   748
	popd ;
b63fd4af003e 8154313: Generated javadoc scattered all over the place
neugens
parents: 36792
diff changeset
   749
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   750
ZIP_TARGETS += $(JAVADOC_ARCHIVE)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   751
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   752
################################################################################
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   753
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   754
# Hook to include the corresponding custom file, if present.
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   755
$(eval $(call IncludeCustomExtension, , Javadoc.gmk))
39384
adde8cb7d01b 8003593: build-infra: Paths to optional platform-specific files should not be hardwired to src/closed
erikj
parents: 39381
diff changeset
   756
adde8cb7d01b 8003593: build-infra: Paths to optional platform-specific files should not be hardwired to src/closed
erikj
parents: 39381
diff changeset
   757
################################################################################
adde8cb7d01b 8003593: build-infra: Paths to optional platform-specific files should not be hardwired to src/closed
erikj
parents: 39381
diff changeset
   758
41652
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   759
docs-javadoc: $(TARGETS)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   760
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   761
docs-copy: $(COPY_TARGETS)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   762
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   763
docs-zip: $(ZIP_TARGETS)
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   764
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   765
all: docs-javadoc docs-copy docs-zip
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   766
a0664e2b49a1 8168772: Convert javadoc generation to build-infra standards
ihse
parents: 41260
diff changeset
   767
.PHONY: default all docs-javadoc docs-copy docs-zip