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