jdk-sandbox: langtools/test/jdk/javadoc/doclet/testHtmlTag/TestHtmlTag.java@5429549751ad (annotated)

1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	1	/*
36526 3b41f1c69604 8142968: Module System implementation alanb parents: 35426 diff changeset	2	* Copyright (c) 2009, 2016, Oracle and/or its affiliates. All rights reserved.
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	3	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	4	*
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	5	* This code is free software; you can redistribute it and/or modify it
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	6	* under the terms of the GNU General Public License version 2 only, as
32337 c9d3ab9f601c 8133671: langtools tests have bad license alundblad parents: 30730 diff changeset	7	* published by the Free Software Foundation.
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	8	*
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	9	* This code is distributed in the hope that it will be useful, but WITHOUT
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	10	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	11	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	12	* version 2 for more details (a copy is included in the LICENSE file that
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	13	* accompanied this code).
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	14	*
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	15	* You should have received a copy of the GNU General Public License version
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	16	* 2 along with this work; if not, write to the Free Software Foundation,
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	17	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	18	*
5520 86e4b9a9da40 6943119: Rebrand source copyright notices ohair parents: 1863 diff changeset	19	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
86e4b9a9da40 6943119: Rebrand source copyright notices ohair parents: 1863 diff changeset	20	* or visit www.oracle.com if you need additional information or have any
86e4b9a9da40 6943119: Rebrand source copyright notices ohair parents: 1863 diff changeset	21	* questions.
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	22	*/
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	23
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	24	/*
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	25	* @test
41453 5429549751ad 4649116: Add option to include full package description at top, before interface table bpatel parents: 36526 diff changeset	26	* @bug 6786682 4649116
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	27	* @summary This test verifies the use of lang attribute by <HTML>.
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	28	* @author Bhavesh Patel
24399 af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	29	* @library ../lib
36526 3b41f1c69604 8142968: Module System implementation alanb parents: 35426 diff changeset	30	* @modules jdk.javadoc/jdk.javadoc.internal.tool
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	31	* @build JavadocTester
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	32	* @run main TestHtmlTag
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	33	*/
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	34
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	35	import java.util.Locale;
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	36
e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	37	public class TestHtmlTag extends JavadocTester {
25284 e6a8d468b838 8047157: [javadoc] fixup tests for determinism and add classes uses ksrini parents: 24399 diff changeset	38	private static final String defaultLanguage = Locale.getDefault().getLanguage();
24399 af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	39	public static void main(String... args) throws Exception {
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	40	TestHtmlTag tester = new TestHtmlTag();
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	41	tester.runTests();
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	42	}
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	43	@Test
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	44	void test_default() {
25284 e6a8d468b838 8047157: [javadoc] fixup tests for determinism and add classes uses ksrini parents: 24399 diff changeset	45	javadoc("-locale", defaultLanguage,
e6a8d468b838 8047157: [javadoc] fixup tests for determinism and add classes uses ksrini parents: 24399 diff changeset	46	"-d", "out-default",
24399 af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	47	"-sourcepath", testSrc,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	48	"pkg1");
25284 e6a8d468b838 8047157: [javadoc] fixup tests for determinism and add classes uses ksrini parents: 24399 diff changeset	49
24399 af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	50	checkExit(Exit.OK);
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	51
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	52	checkOutput("pkg1/C1.html", true,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	53	"<html lang=\"" + defaultLanguage + "\">");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	54
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	55	checkOutput("pkg1/package-summary.html", true,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	56	"<html lang=\"" + defaultLanguage + "\">");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	57
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	58	checkOutput("pkg1/C1.html", false,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	59	"<html>");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	60	}
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	61
24399 af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	62	@Test
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	63	void test_ja() {
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	64	// TODO: why does this test need/use pkg2; why can't it use pkg1
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	65	// like the other two tests, so that we can share the check methods?
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	66	javadoc("-locale", "ja",
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	67	"-d", "out-ja",
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	68	"-sourcepath", testSrc,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	69	"pkg2");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	70	checkExit(Exit.OK);
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	71
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	72	checkOutput("pkg2/C2.html", true,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	73	"<html lang=\"ja\">");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	74
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	75	checkOutput("pkg2/package-summary.html", true,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	76	"<html lang=\"ja\">");
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	77
24399 af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	78	checkOutput("pkg2/C2.html", false,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	79	"<html>");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	80	}
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	81
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	82	@Test
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	83	void test_en_US() {
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	84	javadoc("-locale", "en_US",
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	85	"-d", "out-en_US",
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	86	"-sourcepath", testSrc,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	87	"pkg1");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	88	checkExit(Exit.OK);
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	89
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	90	checkOutput("pkg1/C1.html", true,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	91	"<html lang=\"en\">");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	92
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	93	checkOutput("pkg1/package-summary.html", true,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	94	"<html lang=\"en\">");
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	95
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	96	checkOutput("pkg1/C1.html", false,
af1a0220d0fa 8038730: Clean up the way JavadocTester is invoked, and checks for errors. jjg parents: 24217 diff changeset	97	"<html>");
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	98	}
35426 374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	99
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	100	@Test
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	101	void test_other() {
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	102	javadoc("-locale", "en_US",
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	103	"-d", "out-other",
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	104	"-sourcepath", testSrc,
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	105	"pkg3");
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	106	checkExit(Exit.OK);
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	107
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	108	checkOutput("pkg3/package-summary.html", true,
41453 5429549751ad 4649116: Add option to include full package description at top, before interface table bpatel parents: 36526 diff changeset	109	"<div class=\"contentContainer\">\n"
35426 374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	110	+ "<div class=\"block\"><p>This is the first line."
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	111	+ " Note the newlines before the <p> is relevant.</div>");
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	112
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	113	checkOutput("pkg3/A.DatatypeFactory.html", true,
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	114	"<div class=\"block\"><p>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	115	+ " Factory that creates new <code>javax.xml.datatype</code>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	116	+ " <code>Object</code>s that map XML to/from Java <code>Object</code>s.</p>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	117	+ "\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	118	+ " <p>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	119	+ " A new instance of the <code>DatatypeFactory</code> is created through the\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	120	+ " <a href=\"../pkg3/A.DatatypeFactory.html#newInstance--\"><code>newInstance()</code></a> method that uses the following implementation\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	121	+ " resolution mechanisms to determine an implementation:</p>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	122	+ " <ol>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	123	+ " <li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	124	+ " If the system property specified by <a href=\"../pkg3/A.DatatypeFactory.html#DATATYPEFACTORY_PROPERTY\"><code>DATATYPEFACTORY_PROPERTY</code></a>,\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	125	+ " \"<code>javax.xml.datatype.DatatypeFactory</code>\", exists, a class with\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	126	+ " the name of the property value is instantiated. Any Exception thrown\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	127	+ " during the instantiation process is wrapped as a\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	128	+ " <code>IllegalStateException</code>.\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	129	+ " </li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	130	+ " <li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	131	+ " If the file ${JAVA_HOME}/lib/jaxp.properties exists, it is loaded in a\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	132	+ " <code>Properties</code> <code>Object</code>. The\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	133	+ " <code>Properties</code> <code>Object </code> is then queried for the\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	134	+ " property as documented in the prior step and processed as documented in\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	135	+ " the prior step.\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	136	+ " </li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	137	+ " <li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	138	+ " Uses the service-provider loading facilities, defined by the\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	139	+ " <code>ServiceLoader</code> class, to attempt to locate and load an\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	140	+ " implementation of the service using the default loading mechanism:\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	141	+ " the service-provider loading facility will use the current thread's context class loader\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	142	+ " to attempt to load the service. If the context class loader is null, the system class loader will be used.\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	143	+ " <br>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	144	+ " In case of <code>service configuration error</code> a\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	145	+ " <code>DatatypeConfigurationException</code> will be thrown.\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	146	+ " </li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	147	+ " <li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	148	+ " The final mechanism is to attempt to instantiate the <code>Class</code>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	149	+ " specified by <a href=\"../pkg3/A.DatatypeFactory.html#DATATYPEFACTORY_IMPLEMENTATION_CLASS\">"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	150	+ "<code>DATATYPEFACTORY_IMPLEMENTATION_CLASS</code></a>. Any Exception\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	151	+ " thrown during the instantiation process is wrapped as a\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	152	+ " <code>IllegalStateException</code>.\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	153	+ " </li>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	154	+ " </ol></div>");
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	155
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	156	checkOutput("pkg3/A.ActivationDesc.html", true,
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	157	"<pre>public class <span class=\"typeNameLabel\">A.ActivationDesc</span>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	158	+ "extends java.lang.Object\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	159	+ "implements java.io.Serializable</pre>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	160	+ "<div class=\"block\">An activation descriptor contains the information necessary to activate\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	161	+ " an object: <ul>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	162	+ " <li> the object's group identifier,\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	163	+ " <li> the object's fully-qualified class name,\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	164	+ " <li> the object's code location (the location of the class), a codebase\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	165	+ " URL path,\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	166	+ " <li> the object's restart \"mode\", and,\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	167	+ " <li> a \"marshalled\" object that can contain object specific\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	168	+ " initialization data. </ul>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	169	+ "\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	170	+ " <p>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	171	+ " A descriptor registered with the activation system can be used to\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	172	+ " recreate/activate the object specified by the descriptor. The\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	173	+ " <code>MarshalledObject</code> in the object's descriptor is passed as the\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	174	+ " second argument to the remote object's constructor for object to use\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	175	+ " during reinitialization/activation.</div>");
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	176
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	177	checkOutput("pkg3/A.ActivationGroupID.html", true,
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	178	"<pre>public class <span class=\"typeNameLabel\">A.ActivationGroupID</span>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	179	+ "extends java.lang.Object\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	180	+ "implements java.io.Serializable</pre>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	181	+ "<div class=\"block\">The identifier for a registered activation group serves several purposes:\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	182	+ " <ul>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	183	+ " <li>identifies the group uniquely within the activation system, and\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	184	+ " <li>contains a reference to the group's activation system so that the\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	185	+ " group can contact its activation system when necessary.</ul><p>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	186	+ "\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	187	+ " The <code>ActivationGroupID</code> is returned from the call to\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	188	+ " <code>ActivationSystem.registerGroup</code> and is used to identify the\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	189	+ " group within the activation system. This group id is passed as one of the\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	190	+ " arguments to the activation group's special constructor when an\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	191	+ " activation group is created/recreated.</div>\n"
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	192	+ "<dl>");
374342e56a56 8035473: [javadoc] Revamp the existing Doclet APIs ksrini parents: 32337 diff changeset	193	}
1863 e5de9abc0eb1 6786682: Javadoc HTML WCAG 2.0 accessibility issues in standard doclet - HTML tag should have lang attribute bpatel parents: diff changeset	194	}

author	bpatel
	Mon, 10 Oct 2016 15:17:02 -0700
changeset 41453	5429549751ad
parent 36526	3b41f1c69604
child 46081	7c6d73d10b6b
permissions	-rw-r--r--