author | redestad |
Wed, 17 Oct 2018 14:19:21 +0200 | |
changeset 52175 | c2672a0f233a |
parent 51575 | 76072a077ee1 |
child 52204 | cf3fafc740bb |
child 56891 | 78ed9c424877 |
permissions | -rw-r--r-- |
48759
ffa68af7da87
8195795: Organize output files by module/package, not just package
jjg
parents:
47459
diff
changeset
|
1 |
# Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved. |
13697 | 2 |
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 |
# |
|
4 |
# This code is free software; you can redistribute it and/or modify it |
|
5 |
# under the terms of the GNU General Public License version 2 only, as |
|
6 |
# published by the Free Software Foundation. Oracle designates this |
|
7 |
# particular file as subject to the "Classpath" exception as provided |
|
8 |
# by Oracle in the LICENSE file that accompanied this code. |
|
9 |
# |
|
10 |
# This code is distributed in the hope that it will be useful, but WITHOUT |
|
11 |
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
12 |
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
13 |
# version 2 for more details (a copy is included in the LICENSE file that |
|
14 |
# accompanied this code). |
|
15 |
# |
|
16 |
# You should have received a copy of the GNU General Public License version |
|
17 |
# 2 along with this work; if not, write to the Free Software Foundation, |
|
18 |
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
19 |
# |
|
20 |
# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
21 |
# or visit www.oracle.com if you need additional information or have any |
|
22 |
# questions. |
|
23 |
# |
|
24 |
||
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 | 27 |
include $(SPEC) |
28 |
include MakeBase.gmk |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
29 |
include Modules.gmk |
44983 | 30 |
include ProcessMarkdown.gmk |
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
31 |
include ZipArchive.gmk |
47217 | 32 |
include $(TOPDIR)/make/ToolsJdk.gmk |
33 |
include $(TOPDIR)/make/ModuleTools.gmk |
|
13697 | 34 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
35 |
# This is needed to properly setup DOCS_MODULES. |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
36 |
$(eval $(call ReadImportMetaData)) |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
37 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
38 |
################################################################################ |
44827 | 39 |
# Hook to include the corresponding custom file, if present. |
47314 | 40 |
$(eval $(call IncludeCustomExtension, Docs.gmk)) |
44827 | 41 |
|
42 |
################################################################################ |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
43 |
# This file generates all documentation for OpenJDK. |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
44 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
45 |
# We will generate API documentation for two different selections of the source |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
46 |
# code: "Java SE", which contains just the modules covered by the top-level |
48841 | 47 |
# module java.se and "JDK", which covers all of Java SE and also all |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
48 |
# other available modules that should be documented, including imported modules, |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
49 |
# if any. |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
50 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
51 |
# We will also generate separate, free-standing specifications from either |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
52 |
# markdown or existing html files. |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
53 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
54 |
|
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
55 |
################################################################################ |
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
56 |
# Javadoc settings |
13697 | 57 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
58 |
# On top of the sources that was used to compile the JDK, we need some |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
59 |
# extra java.rmi sources that are used just for javadoc. |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
60 |
MODULES_SOURCE_PATH := $(call PathList, $(call GetModuleSrcPath) \ |
47217 | 61 |
$(SUPPORT_OUTPUTDIR)/rmic/* $(TOPDIR)/src/*/share/doc/stub) |
36506 | 62 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
63 |
# URLs |
51575
76072a077ee1
8209806: API docs should be updated to refer to javase11
jjg
parents:
51019
diff
changeset
|
64 |
JAVADOC_BASE_URL := http://www.oracle.com/pls/topic/lookup?ctx=javase$(VERSION_NUMBER)&id=homepage |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
65 |
BUG_SUBMIT_URL := http://bugreport.java.com/bugreport/ |
45613 | 66 |
COPYRIGHT_URL := {@docroot}/../legal/copyright.html |
49494 | 67 |
LICENSE_URL := http://www.oracle.com/technetwork/java/javase/terms/license/java$(VERSION_NUMBER)speclicense.html |
44990
db3606f423a3
8140268: Generate link to specification license for JavaDoc API documentation
ihse
parents:
44989
diff
changeset
|
68 |
REDISTRIBUTION_URL := http://www.oracle.com/technetwork/java/redist-137594.html |
db3606f423a3
8140268: Generate link to specification license for JavaDoc API documentation
ihse
parents:
44989
diff
changeset
|
69 |
|
42135 | 70 |
# In order to get a specific ordering it's necessary to specify the total |
71 |
# ordering of tags as the tags are otherwise ordered in order of definition. |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
72 |
JAVADOC_TAGS := \ |
42135 | 73 |
-tag beaninfo:X \ |
74 |
-tag revised:X \ |
|
75 |
-tag since.unbundled:X \ |
|
76 |
-tag spec:X \ |
|
77 |
-tag specdefault:X \ |
|
78 |
-tag Note:X \ |
|
79 |
-tag ToDo:X \ |
|
80 |
-tag 'apiNote:a:API Note:' \ |
|
81 |
-tag 'implSpec:a:Implementation Requirements:' \ |
|
82 |
-tag 'implNote:a:Implementation Note:' \ |
|
83 |
-tag param \ |
|
84 |
-tag return \ |
|
85 |
-tag throws \ |
|
44397
f932d6b9f7fe
8173303: Add module-subgraph images to main platform documentation
mchung
parents:
44071
diff
changeset
|
86 |
-taglet build.tools.taglet.ModuleGraph \ |
42135 | 87 |
-tag since \ |
88 |
-tag serialData \ |
|
89 |
-tag factory \ |
|
90 |
-tag see \ |
|
91 |
-tag 'jvms:a:See <cite>The Java™ Virtual Machine Specification</cite>:' \ |
|
92 |
-tag 'jls:a:See <cite>The Java™ Language Specification</cite>:' \ |
|
44826
7a887996ee84
8178725: provide way to link to external documentation
ksrini
parents:
44734
diff
changeset
|
93 |
-taglet build.tools.taglet.ExtLink \ |
43285
223c3eea12e4
8173354: javadoc warning notice for types in Incubator Modules
chegar
parents:
43171
diff
changeset
|
94 |
-taglet build.tools.taglet.Incubating \ |
223c3eea12e4
8173354: javadoc warning notice for types in Incubator Modules
chegar
parents:
43171
diff
changeset
|
95 |
-tagletpath $(BUILDTOOLS_OUTPUTDIR)/jdk_tools_classes \ |
44827 | 96 |
$(CUSTOM_JAVADOC_TAGS) \ |
42135 | 97 |
# |
98 |
||
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
99 |
# The reference tags must stay stable to allow for comparisons across the |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
100 |
# development cycle. If JAVADOC_TAGS needs to change, make sure that |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
101 |
# REFERENCE_TAGS remains unchanged, by copying and hardcoding, if necessary. |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
102 |
REFERENCE_TAGS := $(JAVADOC_TAGS) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
103 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
104 |
# Which doclint checks to ignore |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
105 |
JAVADOC_DISABLED_DOCLINT := accessibility html missing syntax reference |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
106 |
|
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
107 |
# The initial set of options for javadoc |
46087 | 108 |
JAVADOC_OPTIONS := -use -keywords -notimestamp \ |
109 |
-serialwarn -encoding ISO-8859-1 -docencoding UTF-8 -breakiterator \ |
|
49428
ce86061aff12
8199705: Docs.gmk needs to be updated to remove the -html5 option
bpatel
parents:
49075
diff
changeset
|
110 |
-splitIndex --system none -javafx --expand-requires transitive \ |
47429
aa31c0a9ebca
8189706: javadoc for the JDK APIs should summarize overridden methods with no specification changes
ksrini
parents:
47314
diff
changeset
|
111 |
--override-methods=summary |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
112 |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
113 |
# The reference options must stay stable to allow for comparisons across the |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
114 |
# development cycle. |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
115 |
REFERENCE_OPTIONS := -XDignore.symbol.file=true -use -keywords -notimestamp \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
116 |
-serialwarn -encoding ISO-8859-1 -breakiterator -splitIndex --system none \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
117 |
-html5 -javafx --expand-requires transitive |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
118 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
119 |
# Should we add DRAFT stamps to the generated javadoc? |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
120 |
ifeq ($(VERSION_IS_GA), true) |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
121 |
IS_DRAFT := false |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
122 |
else |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
123 |
IS_DRAFT := true |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
124 |
endif |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
125 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
126 |
################################################################################ |
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
127 |
# General text snippets |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
128 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
129 |
FULL_COMPANY_NAME := Oracle and/or its affiliates |
45616 | 130 |
COMPANY_ADDRESS := 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
13697 | 131 |
|
45616 | 132 |
JAVA_PLATFORM := Java Platform |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
133 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
134 |
ifeq ($(IS_DRAFT), true) |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
135 |
DRAFT_MARKER_STR := <br><strong>DRAFT $(VERSION_STRING)</strong> |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
136 |
ifeq ($(VERSION_BUILD), 0) |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
137 |
DRAFT_MARKER_TITLE := [ad-hoc build] |
43047
28be7f773e4e
8172562: Changing log level on Javadoc causes total rebuild
ihse
parents:
43044
diff
changeset
|
138 |
else |
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
139 |
DRAFT_MARKER_TITLE := [build $(VERSION_BUILD)] |
43047
28be7f773e4e
8172562: Changing log level on Javadoc causes total rebuild
ihse
parents:
43044
diff
changeset
|
140 |
endif |
45616 | 141 |
DRAFT_TEXT := This specification is not final and is subject to change. \ |
142 |
Use is subject to <a href="$(LICENSE_URL)">license terms</a>. |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
143 |
|
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
144 |
# Workaround stylesheet bug |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
145 |
HEADER_STYLE := style="margin-top: 9px;" |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
146 |
else |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
147 |
HEADER_STYLE := style="margin-top: 14px;" |
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
148 |
endif |
42135 | 149 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
150 |
JAVADOC_BOTTOM := \ |
45616 | 151 |
<a href="$(BUG_SUBMIT_URL)">Report a bug or suggest an enhancement</a><br> \ |
152 |
For further API reference and developer documentation see the \ |
|
45108
8ad1bd49f4bc
8180328: Bad links in footer of all javadoc-generated pages
ihse
parents:
45105
diff
changeset
|
153 |
<a href="$(JAVADOC_BASE_URL)" target="_blank">Java SE \ |
45616 | 154 |
Documentation</a>, which contains more detailed, \ |
155 |
developer-targeted descriptions with conceptual overviews, definitions \ |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
156 |
of terms, workarounds, and working code examples.<br> \ |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
157 |
Java is a trademark or registered trademark of $(FULL_COMPANY_NAME) in \ |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
158 |
the US and other countries.<br> \ |
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
159 |
<a href="$(COPYRIGHT_URL)">Copyright</a> \ |
45616 | 160 |
© 1993, $(COPYRIGHT_YEAR), $(FULL_COMPANY_NAME), \ |
161 |
$(COMPANY_ADDRESS).<br>All rights reserved. \ |
|
162 |
Use is subject to <a href="$(LICENSE_URL)">license terms</a> and the \ |
|
44990
db3606f423a3
8140268: Generate link to specification license for JavaDoc API documentation
ihse
parents:
44989
diff
changeset
|
163 |
<a href="$(REDISTRIBUTION_URL)">documentation redistribution policy</a>. \ |
45616 | 164 |
$(DRAFT_MARKER_STR) <!-- Version $(VERSION_STRING) --> |
165 |
||
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
166 |
JAVADOC_TOP := \ |
45616 | 167 |
<div style="padding: 6px; text-align: center; font-size: 80%; \ |
168 |
font-family: DejaVu Sans, Arial, Helvetica, sans-serif; \ |
|
169 |
font-weight: normal;">$(DRAFT_TEXT)</div> |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
170 |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
171 |
JDK_INDEX_CONTENT := \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
172 |
<!DOCTYPE html> \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
173 |
<html lang="en"> \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
174 |
<head> \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
175 |
<meta http-equiv="refresh" content="0;url=api/index.html"> \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
176 |
</head> \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
177 |
</html> |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
178 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
179 |
################################################################################ |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
180 |
# JDK javadoc titles/text snippets |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
181 |
|
45616 | 182 |
JDK_SHORT_NAME := Java SE $(VERSION_SPECIFICATION) & JDK $(VERSION_SPECIFICATION) |
183 |
JDK_LONG_NAME := Java<sup>®</sup> Platform, Standard Edition \ |
|
45775
e333a1979702
8183251: Meta "keywords" tag malformed in overview-summary.html and related pages
mr
parents:
45617
diff
changeset
|
184 |
& Java Development Kit |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
185 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
186 |
################################################################################ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
187 |
# Java SE javadoc titles/text snippets |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
188 |
|
45616 | 189 |
JAVASE_SHORT_NAME := Java SE $(VERSION_SPECIFICATION) |
190 |
JAVASE_LONG_NAME := Java<sup>®</sup> Platform, Standard Edition |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
191 |
|
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
192 |
################################################################################ |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
193 |
# Functions |
13697 | 194 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
195 |
# Helper function for creating a png file from a dot file generated by the |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
196 |
# GenGraphs tool. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
197 |
# param 1: SetupJavadocGeneration namespace ($1) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
198 |
# param 2: module name |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
199 |
# |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
200 |
define setup_gengraph_dot_to_png |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
201 |
$1_$2_DOT_SRC := $$($1_GENGRAPHS_DIR)/$2.dot |
48759
ffa68af7da87
8195795: Organize output files by module/package, not just package
jjg
parents:
47459
diff
changeset
|
202 |
$1_$2_PNG_TARGET := $$($1_TARGET_DIR)/$2/module-graph.png |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
203 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
204 |
# For each module needing a graph, create a png file from the dot file |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
205 |
# generated by the GenGraphs tool and store it in the target dir. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
206 |
$$($1_$2_PNG_TARGET): $$($1_GENGRAPHS_MARKER) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
207 |
$$(call MakeDir, $$(@D)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
208 |
$$(call ExecuteWithLog, $$($1_$2_DOT_SRC), \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
209 |
$$(DOT) -Tpng -o $$($1_$2_PNG_TARGET) $$($1_$2_DOT_SRC)) |
42427
2c48c5ffb581
8170648: Move java.net.http package out of Java SE to incubator namespace
michaelm
parents:
42290
diff
changeset
|
210 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
211 |
$1_MODULEGRAPH_TARGETS += $$($1_$2_PNG_TARGET) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
212 |
endef |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
213 |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
214 |
# Helper function to create the overview.html file to use with the -overview |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
215 |
# javadoc option. |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
216 |
# Returns the filename as $1_OVERVIEW. |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
217 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
218 |
# param 1: SetupJavadocGeneration namespace ($1) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
219 |
define create_overview_file |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
220 |
$1_OVERVIEW_TEXT := \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
221 |
<!DOCTYPE html> \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
222 |
<html><head></head><body> \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
223 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
224 |
ifneq ($$($1_GROUPS),) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
225 |
$1_OVERVIEW_TEXT += \ |
45616 | 226 |
<p>This document is divided into \ |
227 |
$$(subst 2,two,$$(subst 3,three,$$(words $$($1_GROUPS)))) sections:</p> \ |
|
228 |
<blockquote><dl> \ |
|
229 |
# |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
230 |
$1_OVERVIEW_TEXT += $$(foreach g, $$($1_GROUPS), \ |
45616 | 231 |
<dt style="margin-top: 8px;"><a href="\#$$g">$$($$g_GROUP_NAME)</a></dt> \ |
45775
e333a1979702
8183251: Meta "keywords" tag malformed in overview-summary.html and related pages
mr
parents:
45617
diff
changeset
|
232 |
<dd style="margin-top: 8px;">$$($$g_GROUP_DESCRIPTION)</dd> \ |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
233 |
) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
234 |
$1_OVERVIEW_TEXT += \ |
45775
e333a1979702
8183251: Meta "keywords" tag malformed in overview-summary.html and related pages
mr
parents:
45617
diff
changeset
|
235 |
</dl></blockquote> \ |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
236 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
237 |
endif |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
238 |
$1_OVERVIEW_TEXT += \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
239 |
</body></html> \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
240 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
241 |
|
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
242 |
$1_OVERVIEW := $$(SUPPORT_OUTPUTDIR)/docs/$1-overview.html |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
243 |
|
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
244 |
$1_OVERVIEW_VARDEPS_FILE := $$(call DependOnVariable, $1_OVERVIEW_TEXT, \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
245 |
$$($1_OVERVIEW).vardeps) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
246 |
|
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
247 |
$$($1_OVERVIEW): $$($1_OVERVIEW_VARDEPS_FILE) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
248 |
$$(call LogInfo, Creating overview.html for $1) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
249 |
$$(call MakeDir, $$(@D)) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
250 |
$$(PRINTF) > $$@ '$$($1_OVERVIEW_TEXT)' |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
251 |
endef |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
252 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
253 |
################################################################################ |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
254 |
# Setup make rules to create an API documentation collection, using javadoc and |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
255 |
# other tools if needed. |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
256 |
# |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
257 |
# Parameter 1 is the name of the rule. This name is used as variable prefix. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
258 |
# Targets generated are returned as $1_JAVADOC_TARGETS and |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
259 |
# $1_MODULEGRAPH_TARGETS. Note that the index.html file will work as a "touch |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
260 |
# file" for all the magnitude of files that are generated by javadoc. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
261 |
# |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
262 |
# Remaining parameters are named arguments. These include: |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
263 |
# MODULES - Modules to generate javadoc for |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
264 |
# GROUPS - Name of the groups to divide the modules into, if any |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
265 |
# SHORT_NAME - The short name of this documentation collection |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
266 |
# LONG_NAME - The long name of this documentation collection |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
267 |
# TARGET_DIR - Where to store the output |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
268 |
# |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
269 |
SetupApiDocsGeneration = $(NamedParamsMacroTemplate) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
270 |
define SetupApiDocsGenerationBody |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
271 |
|
45233
538af025db97
8180480: Use "requires transitive" relationship when determining modules for javadoc
ihse
parents:
45229
diff
changeset
|
272 |
# Figure out all modules, both specified and transitive indirect exports, that |
538af025db97
8180480: Use "requires transitive" relationship when determining modules for javadoc
ihse
parents:
45229
diff
changeset
|
273 |
# will be processed by javadoc. |
538af025db97
8180480: Use "requires transitive" relationship when determining modules for javadoc
ihse
parents:
45229
diff
changeset
|
274 |
$1_INDIRECT_EXPORTS := $$(call FindTransitiveIndirectDepsForModules, $$($1_MODULES)) |
538af025db97
8180480: Use "requires transitive" relationship when determining modules for javadoc
ihse
parents:
45229
diff
changeset
|
275 |
$1_ALL_MODULES := $$(sort $$($1_MODULES) $$($1_INDIRECT_EXPORTS)) |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
276 |
|
50969
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
277 |
$1_JAVA_ARGS := -Dextlink.spec.version=$$(VERSION_SPECIFICATION) |
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
278 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
279 |
ifeq ($$(ENABLE_FULL_DOCS), true) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
280 |
# Tell the ModuleGraph taglet to generate html links to soon-to-be-created |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
281 |
# png files with module graphs. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
282 |
$1_JAVA_ARGS += -DenableModuleGraph=true |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
283 |
endif |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
284 |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
285 |
# Start with basic options and tags |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
286 |
ifeq ($$($1_OPTIONS), ) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
287 |
$1_OPTIONS := $$(JAVADOC_OPTIONS) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
288 |
endif |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
289 |
ifeq ($$($1_TAGS), ) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
290 |
$1_TAGS := $$(JAVADOC_TAGS) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
291 |
endif |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
292 |
$1_OPTIONS += $$($1_TAGS) |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
293 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
294 |
$1_OPTIONS += --module-source-path $$(MODULES_SOURCE_PATH) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
295 |
$1_OPTIONS += --module $$(call CommaList, $$($1_MODULES)) |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
296 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
297 |
# Create a string like "-Xdoclint:all,-syntax,-html,..." |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
298 |
$1_OPTIONS += -Xdoclint:all,$$(call CommaList, $$(addprefix -, \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
299 |
$$(JAVADOC_DISABLED_DOCLINT))) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
300 |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
301 |
$1_DOC_TITLE := $$($1_LONG_NAME)<br>Version $$(VERSION_SPECIFICATION) API \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
302 |
Specification |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
303 |
$1_WINDOW_TITLE := $$(subst &,&,$$($1_SHORT_NAME)) $$(DRAFT_MARKER_TITLE) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
304 |
$1_HEADER_TITLE := <div $$(HEADER_STYLE)><strong>$$($1_SHORT_NAME)</strong> \ |
45616 | 305 |
$$(DRAFT_MARKER_STR)</div> |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
306 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
307 |
$1_OPTIONS += -doctitle '$$($1_DOC_TITLE)' |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
308 |
$1_OPTIONS += -windowtitle '$$($1_WINDOW_TITLE)' |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
309 |
$1_OPTIONS += -header '$$($1_HEADER_TITLE)' |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
310 |
$1_OPTIONS += -bottom '$$(JAVADOC_BOTTOM)' |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
311 |
ifeq ($$(IS_DRAFT), true) |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
312 |
$1_OPTIONS += -top '$$(JAVADOC_TOP)' |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
313 |
endif |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
314 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
315 |
# Do not store debug level options in VARDEPS. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
316 |
ifneq ($$(LOG_LEVEL), trace) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
317 |
$1_LOG_OPTION += -quiet |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
318 |
else |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
319 |
$1_LOG_OPTION += -verbose |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
320 |
endif |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
321 |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
322 |
# Generate the overview.html file. This will return the filename in |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
323 |
# $1_OVERVIEW. |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
324 |
$$(eval $$(call create_overview_file,$1)) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
325 |
$1_OPTIONS += -overview $$($1_OVERVIEW) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
326 |
|
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
327 |
$$(foreach g, $$($1_GROUPS), \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
328 |
$$(eval $1_OPTIONS += -group "$$($$g_GROUP_NAME)" "$$($$g_GROUP_MODULES)") \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
329 |
) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
330 |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
331 |
ifeq ($$($1_JAVADOC_CMD), ) |
50969
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
332 |
$1_JAVADOC_CMD := $$(JAVA) -Djava.awt.headless=true $$($1_JAVA_ARGS) \ |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
333 |
$$(NEW_JAVADOC) |
50969
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
334 |
else |
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
335 |
$1_OPTIONS += $$(addprefix -J, $$($1_JAVA_ARGS)) |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
336 |
endif |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
337 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
338 |
$1_VARDEPS := $$($1_JAVA_ARGS) $$($1_OPTIONS) $$(MODULES_SOURCE_PATH) \ |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
339 |
$$($1_ALL_MODULES) $$($1_JAVADOC_CMD) |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
340 |
$1_VARDEPS_FILE := $$(call DependOnVariable, $1_VARDEPS, \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
341 |
$$(SUPPORT_OUTPUTDIR)/docs/$1.vardeps) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
342 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
343 |
# Get a list of all files in all the source dirs for all included modules |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
344 |
$1_SOURCE_DEPS := $$(call CacheFind, $$(wildcard $$(foreach module, \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
345 |
$$($1_ALL_MODULES), $$(call FindModuleSrcDirs, $$(module))))) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
346 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
347 |
# Javadoc creates a lot of files but use index.html as a marker |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
348 |
$$($1_TARGET_DIR)/index.html: $$(BUILD_TOOLS_JDK) $$($1_VARDEPS_FILE) \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
349 |
$$($1_SOURCE_DEPS) $$($1_OVERVIEW) |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
350 |
$$(call LogWarn, Generating $1 javadoc for \ |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
351 |
$$(words $$($1_ALL_MODULES)) modules) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
352 |
$$(call LogInfo, Javadoc modules: $$($1_ALL_MODULES)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
353 |
$$(call MakeDir, $$($1_TARGET_DIR)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
354 |
$$(call ExecuteWithLog, $$(SUPPORT_OUTPUTDIR)/docs/$1, \ |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
355 |
$$($1_JAVADOC_CMD) -d $$($1_TARGET_DIR) \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
356 |
$$($1_OPTIONS) $$($1_LOG_OPTION)) |
13697 | 357 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
358 |
$1_JAVADOC_TARGETS := $$($1_TARGET_DIR)/index.html |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
359 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
360 |
ifeq ($$(ENABLE_FULL_DOCS), true) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
361 |
# We have asked ModuleGraph to generate links to png files. Now we must |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
362 |
# produce the png files. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
363 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
364 |
# Locate which modules has the @moduleGraph tag in their module-info.java |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
365 |
$1_MODULES_NEEDING_GRAPH := $$(strip $$(foreach m, $$($1_ALL_MODULES), \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
366 |
$$(if $$(shell $$(GREP) -e @moduleGraph \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
367 |
$$(wildcard $$(addsuffix /module-info.java, \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
368 |
$$(call FindModuleSrcDirs, $$m)))), \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
369 |
$$m) \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
370 |
)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
371 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
372 |
# First we run the GenGraph tool. It will query the module structure of the |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
373 |
# running JVM and output .dot files for all existing modules. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
374 |
GENGRAPHS_PROPS := \ |
47217 | 375 |
$$(TOPDIR)/make/jdk/src/classes/build/tools/jigsaw/javadoc-graphs.properties |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
376 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
377 |
$1_GENGRAPHS_DIR := $$(SUPPORT_OUTPUTDIR)/docs/$1-gengraphs |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
378 |
$1_GENGRAPHS_MARKER := $$($1_GENGRAPHS_DIR)/_gengraphs_run.marker |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
379 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
380 |
$$($1_GENGRAPHS_MARKER): $$(BUILD_JIGSAW_TOOLS) $$(GENGRAPHS_PROPS) |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
381 |
$$(call LogInfo, Running gengraphs for $1 documentation) |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
382 |
$$(call MakeDir, $$($1_GENGRAPHS_DIR)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
383 |
$$(call ExecuteWithLog, $$($1_GENGRAPHS_DIR)/gengraphs, \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
384 |
$$(TOOL_GENGRAPHS) --spec --output $$($1_GENGRAPHS_DIR) \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
385 |
--dot-attributes $$(GENGRAPHS_PROPS) && \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
386 |
$$(TOUCH) $$($1_GENGRAPHS_MARKER)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
387 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
388 |
# For each module needing a graph, create a png file from the dot file |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
389 |
# generated by the GenGraphs tool and store it in the target dir. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
390 |
# They will depend on $1_GENGRAPHS_MARKER, and will be added to $1. |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
391 |
$$(foreach m, $$($1_MODULES_NEEDING_GRAPH), \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
392 |
$$(eval $$(call setup_gengraph_dot_to_png,$1,$$m)) \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
393 |
) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
394 |
endif |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
395 |
endef |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
396 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
397 |
################################################################################ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
398 |
# Setup generation of the JDK API documentation (javadoc + modulegraph) |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
399 |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
400 |
# Define the groups of the JDK API documentation |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
401 |
JavaSE_GROUP_NAME := Java SE |
48841 | 402 |
JavaSE_GROUP_MODULES := $(call ColonList, $(sort java.se \ |
403 |
$(call FindTransitiveIndirectDepsForModules, java.se))) |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
404 |
JavaSE_GROUP_DESCRIPTION := \ |
45616 | 405 |
The Java Platform, Standard Edition (Java SE) APIs define the core Java \ |
406 |
platform for general-purpose computing. These APIs are in modules whose \ |
|
407 |
names start with {@code java}. \ |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
408 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
409 |
JDK_GROUPS += JavaSE |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
410 |
|
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
411 |
JDK_GROUP_NAME := JDK |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
412 |
JDK_GROUP_MODULES := jdk.* |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
413 |
JDK_GROUP_DESCRIPTION := \ |
45616 | 414 |
The Java Development Kit (JDK) APIs are specific to the JDK and will not \ |
415 |
necessarily be available in all implementations of the Java SE Platform. \ |
|
416 |
These APIs are in modules whose names start with {@code jdk}. \ |
|
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
417 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
418 |
JDK_GROUPS += JDK |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
419 |
|
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
420 |
# If we are importing JavaFX, we need a JavaFX group. In an ideal world, this |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
421 |
# would have been abstracted away to a more proper generic handling of imported |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
422 |
# modules. |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
423 |
ifneq ($(findstring javafx., $(IMPORTED_MODULES)), ) |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
424 |
JavaFX_GROUP_NAME := JavaFX |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
425 |
JavaFX_GROUP_MODULES := javafx.* |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
426 |
JavaFX_GROUP_DESCRIPTION := \ |
45616 | 427 |
The JavaFX APIs define a set of user-interface controls, graphics, \ |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
428 |
media, and web packages for developing rich client applications. These \ |
45616 | 429 |
APIs are in modules whose names start with {@code javafx}. \ |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
430 |
# |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
431 |
JDK_GROUPS += JavaFX |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
432 |
endif |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
433 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
434 |
# All modules to have docs generated by docs-jdk-api target |
49916 | 435 |
JDK_MODULES := $(sort $(filter-out $(MODULES_FILTER), $(DOCS_MODULES))) |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
436 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
437 |
$(eval $(call SetupApiDocsGeneration, JDK_API, \ |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
438 |
MODULES := $(JDK_MODULES), \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
439 |
GROUPS := $(JDK_GROUPS), \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
440 |
SHORT_NAME := $(JDK_SHORT_NAME), \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
441 |
LONG_NAME := $(JDK_LONG_NAME), \ |
45103 | 442 |
TARGET_DIR := $(DOCS_OUTPUTDIR)/api, \ |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
443 |
)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
444 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
445 |
# Targets generated are returned in JDK_API_JAVADOC_TARGETS and |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
446 |
# JDK_API_MODULEGRAPH_TARGETS. |
13697 | 447 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
448 |
################################################################################ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
449 |
# Setup generation of the Java SE API documentation (javadoc + modulegraph) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
450 |
|
48855
0006d97556ba
8197866: Docs.mk still had a reference to java.se.ee
lancea
parents:
48841
diff
changeset
|
451 |
# The Java SE module scope is just java.se and its transitive indirect |
45233
538af025db97
8180480: Use "requires transitive" relationship when determining modules for javadoc
ihse
parents:
45229
diff
changeset
|
452 |
# exports. |
48855
0006d97556ba
8197866: Docs.mk still had a reference to java.se.ee
lancea
parents:
48841
diff
changeset
|
453 |
JAVASE_MODULES := java.se |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
454 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
455 |
$(eval $(call SetupApiDocsGeneration, JAVASE_API, \ |
45323
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
456 |
MODULES := $(JAVASE_MODULES), \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
457 |
SHORT_NAME := $(JAVASE_SHORT_NAME), \ |
52500c1d7f1f
8175824: Adapt javadoc generation to different requirements for JDK and JavaSE
ihse
parents:
45233
diff
changeset
|
458 |
LONG_NAME := $(JAVASE_LONG_NAME), \ |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
459 |
TARGET_DIR := $(IMAGES_OUTPUTDIR)/javase-docs/api, \ |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
460 |
)) |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
461 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
462 |
# Targets generated are returned in JAVASE_API_JAVADOC_TARGETS and |
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
463 |
# JAVASE_API_MODULEGRAPH_TARGETS. |
36506 | 464 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
465 |
################################################################################ |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
466 |
# Setup generation of the reference Java SE API documentation (javadoc + modulegraph) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
467 |
|
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
468 |
# The reference javadoc is just the same as javase, but using the BootJDK javadoc |
50969
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
469 |
# and a stable set of javadoc options. Typically it is used for generating |
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
470 |
# diffs between the reference javadoc and a javadoc bundle of a specific build |
3f879ff34084
8206184: docs-reference build fails due to extlink.spec.version property not set
mchung
parents:
50782
diff
changeset
|
471 |
# generated in the same way. |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
472 |
|
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
473 |
$(eval $(call SetupApiDocsGeneration, REFERENCE_API, \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
474 |
MODULES := $(JAVASE_MODULES), \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
475 |
SHORT_NAME := $(JAVASE_SHORT_NAME), \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
476 |
LONG_NAME := $(JAVASE_LONG_NAME), \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
477 |
TARGET_DIR := $(IMAGES_OUTPUTDIR)/reference-docs/api, \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
478 |
JAVADOC_CMD := $(JAVADOC), \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
479 |
OPTIONS := $(REFERENCE_OPTIONS), \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
480 |
TAGS := $(REFERENCE_TAGS), \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
481 |
)) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
482 |
|
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
483 |
# Targets generated are returned in REFERENCE_API_JAVADOC_TARGETS and |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
484 |
# REFERENCE_API_MODULEGRAPH_TARGETS. |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
485 |
|
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
486 |
################################################################################ |
45105 | 487 |
|
45229
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
488 |
JDK_INDEX_HTML := $(DOCS_OUTPUTDIR)/index.html |
45105 | 489 |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
490 |
$(JDK_INDEX_HTML): |
45610
e9dbf9eb0100
8182029: Make the top-level docs index.html to a HTML-level redirect to the API overview page
mchung
parents:
45323
diff
changeset
|
491 |
$(ECHO) '$(JDK_INDEX_CONTENT)' > $@ |
45105 | 492 |
|
45613 | 493 |
JDK_INDEX_TARGETS += $(JDK_INDEX_HTML) |
45229
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
494 |
|
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
495 |
# Copy the global resources |
47217 | 496 |
GLOBAL_SPECS_RESOURCES_DIR := $(TOPDIR)/make/data/docs-resources/ |
45229
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
497 |
$(eval $(call SetupCopyFiles, COPY_GLOBAL_RESOURCES, \ |
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
498 |
SRC := $(GLOBAL_SPECS_RESOURCES_DIR), \ |
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
499 |
FILES := $(call CacheFind, $(GLOBAL_SPECS_RESOURCES_DIR)), \ |
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
500 |
DEST := $(DOCS_OUTPUTDIR), \ |
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
501 |
)) |
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
502 |
JDK_INDEX_TARGETS += $(COPY_GLOBAL_RESOURCES) |
45105 | 503 |
|
45617
1e5b518f5e14
8182492: docs bundle needs legal notices for 3rd party libraries distributed for javadoc search
mchung
parents:
45616
diff
changeset
|
504 |
# Copy the legal notices distributed with the docs bundle |
1e5b518f5e14
8182492: docs bundle needs legal notices for 3rd party libraries distributed for javadoc search
mchung
parents:
45616
diff
changeset
|
505 |
$(eval $(call SetupCopyFiles, COPY_DOCS_LEGAL_NOTICES, \ |
47217 | 506 |
SRC := $(TOPDIR)/src/jdk.javadoc/share/legal, \ |
51019 | 507 |
FILES := $(wildcard $(TOPDIR)/src/jdk.javadoc/share/legal/*), \ |
45617
1e5b518f5e14
8182492: docs bundle needs legal notices for 3rd party libraries distributed for javadoc search
mchung
parents:
45616
diff
changeset
|
508 |
DEST := $(DOCS_OUTPUTDIR)/legal, \ |
1e5b518f5e14
8182492: docs bundle needs legal notices for 3rd party libraries distributed for javadoc search
mchung
parents:
45616
diff
changeset
|
509 |
)) |
1e5b518f5e14
8182492: docs bundle needs legal notices for 3rd party libraries distributed for javadoc search
mchung
parents:
45616
diff
changeset
|
510 |
JDK_INDEX_TARGETS += $(COPY_DOCS_LEGAL_NOTICES) |
1e5b518f5e14
8182492: docs bundle needs legal notices for 3rd party libraries distributed for javadoc search
mchung
parents:
45616
diff
changeset
|
511 |
|
45105 | 512 |
################################################################################ |
44733 | 513 |
# Copy JDK specs files |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
514 |
|
44733 | 515 |
# For all html documentation in $module/share/specs directories, copy it |
516 |
# unmodified |
|
517 |
||
518 |
ALL_MODULES := $(call FindAllModules) |
|
44983 | 519 |
COPY_SPEC_FILTER := %.html %.gif %.jpg %.mib %.css |
13697 | 520 |
|
44733 | 521 |
$(foreach m, $(ALL_MODULES), \ |
522 |
$(eval SPECS_$m := $(call FindModuleSpecsDirs, $m)) \ |
|
45095
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
523 |
$(foreach d, $(SPECS_$m), \ |
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
524 |
$(if $(filter $(COPY_SPEC_FILTER), $(call CacheFind, $d)), \ |
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
525 |
$(eval $(call SetupCopyFiles, COPY_$m, \ |
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
526 |
SRC := $d, \ |
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
527 |
FILES := $(filter $(COPY_SPEC_FILTER), $(call CacheFind, $d)), \ |
45103 | 528 |
DEST := $(DOCS_OUTPUTDIR)/specs/, \ |
45095
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
529 |
)) \ |
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
530 |
$(eval JDK_SPECS_TARGETS += $(COPY_$m)) \ |
704e6f5e9b6d
8178278: Move Standard Algorithm Names document to specs directory
ihse
parents:
44990
diff
changeset
|
531 |
) \ |
44733 | 532 |
) \ |
533 |
) |
|
534 |
||
44734 | 535 |
ifeq ($(ENABLE_FULL_DOCS), true) |
536 |
# For all markdown files in $module/share/specs directories, convert them to |
|
537 |
# html. |
|
538 |
||
45229
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
539 |
GLOBAL_SPECS_DEFAULT_CSS_FILE := $(DOCS_OUTPUTDIR)/resources/jdk-default.css |
44734 | 540 |
|
541 |
$(foreach m, $(ALL_MODULES), \ |
|
542 |
$(eval SPECS_$m := $(call FindModuleSpecsDirs, $m)) \ |
|
44983 | 543 |
$(foreach d, $(SPECS_$m), \ |
544 |
$(if $(filter %.md, $(call CacheFind, $d)), \ |
|
47217 | 545 |
$(eval $m_$d_NAME := CONVERT_MARKDOWN_$m_$(strip $(call RelativePath, $d, $(TOPDIR)))) \ |
546 |
$(eval $(call SetupProcessMarkdown, $($m_$d_NAME), \ |
|
44983 | 547 |
SRC := $d, \ |
548 |
FILES := $(filter %.md, $(call CacheFind, $d)), \ |
|
45103 | 549 |
DEST := $(DOCS_OUTPUTDIR)/specs/, \ |
44983 | 550 |
CSS := $(GLOBAL_SPECS_DEFAULT_CSS_FILE), \ |
551 |
)) \ |
|
47217 | 552 |
$(eval JDK_SPECS_TARGETS += $($($m_$d_NAME))) \ |
44983 | 553 |
) \ |
44734 | 554 |
) \ |
555 |
) |
|
556 |
endif |
|
557 |
||
44733 | 558 |
# Special treatment for generated documentation |
559 |
||
560 |
JDWP_PROTOCOL := $(SUPPORT_OUTPUTDIR)/gensrc/jdk.jdi/jdwp-protocol.html |
|
561 |
$(eval $(call SetupCopyFiles, COPY_JDWP_PROTOCOL, \ |
|
562 |
FILES := $(JDWP_PROTOCOL), \ |
|
45103 | 563 |
DEST := $(DOCS_OUTPUTDIR)/specs/jdwp, \ |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
564 |
)) |
44733 | 565 |
JDK_SPECS_TARGETS += $(COPY_JDWP_PROTOCOL) |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
566 |
|
44733 | 567 |
# Get jvmti.html from the main jvm variant (all variants' jvmti.html are identical). |
49928 | 568 |
JVMTI_HTML ?= $(HOTSPOT_OUTPUTDIR)/variant-$(JVM_VARIANT_MAIN)/gensrc/jvmtifiles/jvmti.html |
41260 | 569 |
$(eval $(call SetupCopyFiles, COPY_JVMTI_HTML, \ |
570 |
FILES := $(JVMTI_HTML), \ |
|
45103 | 571 |
DEST := $(DOCS_OUTPUTDIR)/specs, \ |
41260 | 572 |
)) |
44733 | 573 |
JDK_SPECS_TARGETS += $(COPY_JVMTI_HTML) |
13697 | 574 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
575 |
################################################################################ |
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
576 |
# 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
|
577 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
578 |
JAVADOC_ZIP_NAME := jdk-$(VERSION_STRING)-docs.zip |
47253
92fd0e04e0e1
8187544: Replace BUILD_OUTPUT and OUTPUT_ROOT with OUTPUTDIR
ihse
parents:
47217
diff
changeset
|
579 |
JAVADOC_ZIP_FILE := $(OUTPUTDIR)/bundles/$(JAVADOC_ZIP_NAME) |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
580 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
581 |
$(eval $(call SetupZipArchive, BUILD_JAVADOC_ZIP, \ |
45103 | 582 |
SRC := $(DOCS_OUTPUTDIR), \ |
44733 | 583 |
ZIP := $(JAVADOC_ZIP_FILE), \ |
584 |
EXTRA_DEPS := $(JDK_API_JAVADOC_TARGETS) $(JDK_API_MODULEGRAPH_TARGETS) \ |
|
585 |
$(JDK_SPECS_TARGETS), \ |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
586 |
)) |
37034
b63fd4af003e
8154313: Generated javadoc scattered all over the place
neugens
parents:
36792
diff
changeset
|
587 |
|
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
588 |
ZIP_TARGETS += $(BUILD_JAVADOC_ZIP) |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
589 |
|
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
590 |
################################################################################ |
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
591 |
|
45103 | 592 |
docs-jdk-api-javadoc: $(JDK_API_JAVADOC_TARGETS) $(JDK_API_CUSTOM_TARGETS) |
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
593 |
|
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
594 |
docs-jdk-api-modulegraph: $(JDK_API_MODULEGRAPH_TARGETS) |
44397
f932d6b9f7fe
8173303: Add module-subgraph images to main platform documentation
mchung
parents:
44071
diff
changeset
|
595 |
|
45103 | 596 |
docs-javase-api-javadoc: $(JAVASE_API_JAVADOC_TARGETS) $(JAVASE_API_CUSTOM_TARGETS) |
44725
8747b14eb49c
8172312: Update docs target and image for new combined docs
ihse
parents:
44397
diff
changeset
|
597 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
598 |
docs-javase-api-modulegraph: $(JAVASE_API_MODULEGRAPH_TARGETS) |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
599 |
|
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
600 |
docs-reference-api-javadoc: $(REFERENCE_API_JAVADOC_TARGETS) $(REFERENCE_API_CUSTOM_TARGETS) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
601 |
|
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
602 |
docs-reference-api-modulegraph: $(REFERENCE_API_MODULEGRAPH_TARGETS) |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
603 |
|
44733 | 604 |
docs-jdk-specs: $(JDK_SPECS_TARGETS) |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
605 |
|
45229
88a3fab6006f
8180426: Use standard css file for new docs bundle index.html page
ihse
parents:
45108
diff
changeset
|
606 |
docs-jdk-index: $(JDK_INDEX_TARGETS) |
45105 | 607 |
|
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
608 |
docs-zip: $(ZIP_TARGETS) |
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
609 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
610 |
all: docs-jdk-api-javadoc docs-jdk-api-modulegraph docs-javase-api-javadoc \ |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
611 |
docs-javase-api-modulegraph docs-reference-api-javadoc \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
612 |
docs-reference-api-modulegraph docs-jdk-specs docs-jdk-index docs-zip |
41652
a0664e2b49a1
8168772: Convert javadoc generation to build-infra standards
ihse
parents:
41260
diff
changeset
|
613 |
|
44726
04aa2c065f5c
8176785: Add build support to generate PNG file from .dot file
ihse
parents:
44725
diff
changeset
|
614 |
.PHONY: default all docs-jdk-api-javadoc docs-jdk-api-modulegraph \ |
47432
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
615 |
docs-javase-api-javadoc docs-javase-api-modulegraph \ |
28d6070f5f2f
8189056: javadoc target for stable specdiff comparisons
ihse
parents:
47429
diff
changeset
|
616 |
docs-reference-api-javadoc docs-reference-api-modulegraph docs-jdk-specs \ |
45105 | 617 |
docs-jdk-index docs-zip |