TestHtmlDefinitionListTag.java revision 243
797N/A * Copyright 2009 Sun Microsystems, Inc. All Rights Reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 0N/A * published by the Free Software Foundation. Sun designates this 0N/A * particular file as subject to the "Classpath" exception as provided 0N/A * by Sun in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 553N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 553N/A * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, 0N/A * CA 95054 USA or visit www.sun.com if you need additional information or 0N/A * have any questions. 0N/A * @bug 6786690 6820360 0N/A * @summary This test verifies the nesting of definition list tags. 0N/A * @author Bhavesh Patel 0N/A * @build JavadocTester 0N/A * @build TestHtmlDefinitionListTag 0N/A * @run main TestHtmlDefinitionListTag 0N/A // Test common to all runs of javadoc. The class signature should print 0N/A // properly enclosed definition list tags and the Annotation Type 0N/A // Optional Element should print properly nested definition list tags 0N/A // for default value. 0N/A "<STRONG>C1</STRONG>" +
NL +
"extends " +
0N/A "java.lang.Object" +
NL +
"implements " +
0N/A "java.io.Serializable</PRE>"},
0N/A "<DT><STRONG>Default:</STRONG></DT><DD>true</DD>" +
NL +
0N/A "</DL>" +
NL +
"</DD>" +
NL +
"</DL>"}};
0N/A // Test for normal run of javadoc in which various ClassDocs and 765N/A // serialized form should have properly nested definition list tags 0N/A // enclosing comments, tags and deprecated information. 765N/A "<DT><STRONG>Since:</STRONG></DT>" +
NL +
0N/A " <DD>JDK1.0</DD></DL>"},
0N/A "<DT><STRONG>Since:</STRONG></DT>" +
NL +
765N/A " <DD>JDK1.0</DD>" +
NL +
"<DT><STRONG>See Also:</STRONG></DT><DD>" +
0N/A "<CODE>C2</CODE></A>, " +
NL +
0N/A "Serialized Form</A></DD></DL>"},
0N/A "<DD><STRONG>Deprecated.</STRONG> <I>As of JDK version" +
765N/A "<CODE>setUndecorated(boolean)</CODE></A>.</I></DD>" +
0N/A "<DD>This field indicates whether the C1 is undecorated." +
NL +
765N/A "<P>" +
NL +
"</DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>" +
0N/A "Since:</STRONG></DT>" +
NL +
" <DD>1.4</DD>" +
NL +
"<DT>" +
0N/A "<STRONG>See Also:</STRONG></DT><DD>" +
0N/A "setUndecorated(boolean)</CODE></A></DD></DL>" +
NL +
"</DD>" +
NL +
765N/A "<DD>Constructor." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
0N/A "<DD><DL>" +
NL +
"<DT><STRONG>Parameters:</STRONG></DT><DD>" +
765N/A "<CODE>title</CODE> - the title</DD><DD><CODE>test</CODE>" +
0N/A " - boolean value</DD>" +
NL +
"<DT><STRONG>Throws:</STRONG></DT>" +
NL +
765N/A "<DD><CODE>java.lang.IllegalArgumentException</CODE>" +
0N/A " - if the <code>owner</code>'s" +
NL +
" <code>GraphicsConfiguration" +
0N/A "</code> is not from a screen device</DD>" +
NL +
"<DD><CODE>" +
765N/A "HeadlessException</CODE></DD></DL>" +
NL +
"</DD>" +
NL +
765N/A "</DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>Parameters:" +
0N/A "</STRONG></DT><DD><CODE>undecorated</CODE> - <code>true</code>" +
0N/A " if no decorations are" +
NL +
" to be enabled;" +
NL +
0N/A " <code>false</code> if decorations are to be enabled." +
0N/A "</DD><DT><STRONG>Since:</STRONG></DT>" +
NL +
0N/A " <DD>1.4</DD>" +
NL +
"<DT><STRONG>See Also:</STRONG></DT>" +
0N/A "readObject()</CODE></A></DD></DL>" +
NL +
"</DD>" +
NL +
0N/A "<DT><STRONG>Throws:</STRONG></DT>" +
NL +
"<DD><CODE>" +
0N/A "java.io.IOException</CODE></DD><DT><STRONG>See Also:" +
0N/A "</STRONG></DT><DD>" +
0N/A "<CODE>setUndecorated(boolean)</CODE></A></DD></DL>" +
NL +
0N/A "<DD>No modal exclusion." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
0N/A "<P>" +
NL +
"</DD>" +
NL +
"</DL>"},
0N/A "Deprecated.</STRONG> <I>As of JDK version 1.5, replaced " +
0N/A "<CODE>setUndecorated(boolean)</CODE></A>.</I>" +
NL +
"<P>" +
NL +
0N/A "</DD><DD>Set visible." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
0N/A "<DD><DL>" +
NL +
"<DT><STRONG>Parameters:</STRONG></DT><DD>" +
0N/A "<CODE>set</CODE> - boolean</DD><DT><STRONG>Since:</STRONG></DT>" +
NL +
0N/A " <DD>1.4</DD></DL>" +
NL +
"</DD>" +
NL +
"</DL>"},
0N/A "<P>" +
NL +
"</DD>" +
NL +
"</DL>"},
0N/A "<DT><STRONG>Throws:</STRONG></DT>" +
NL +
"<DD><CODE>" +
0N/A "java.io.IOException</CODE></DD><DT><STRONG>See Also:</STRONG>" +
0N/A "<CODE>C1.setUndecorated(boolean)</CODE></A></DD></DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> <I>As of JDK version " +
"1.5, replaced by" +
NL +
"<CODE>setUndecorated(boolean)</CODE></A>.</I></DD>" +
"<DD>This field indicates whether the C1 is undecorated." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD> </DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>Since:</STRONG></DT>" +
NL +
" <DD>1.4</DD>" +
NL +
"<DT><STRONG>See Also:</STRONG>" +
"</DT><DD><A HREF=\"pkg1/C1.html#setUndecorated(boolean)\">" +
"<CODE>C1.setUndecorated(boolean)</CODE></A></DD></DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> <I>As of JDK version" +
" 1.5, replaced by" +
NL +
"<CODE>setUndecorated(boolean)</CODE></A>.</I>" +
NL +
"<P>" +
NL +
"</DD><DD>Reads the object stream." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>Throws:" +
"</STRONG></DT>" +
NL +
"<DD><CODE><code>" +
"IOException</code></CODE></DD>" +
NL +
"<DD><CODE>java.io.IOException</CODE></DD></DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> </DD><DD>" +
"The name for this class." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD> </DD>" +
NL +
"</DL>"}};
// Test with -nocomment option. The ClassDocs and serialized form should // have properly nested definition list tags enclosing deprecated // information and should not display definition lists for comments "Deprecated.</STRONG> <I>As of JDK version 1.5, replaced by" +
NL +
" <A HREF=\"../pkg1/C1.html#setUndecorated(boolean)\"><CODE>" +
"setUndecorated(boolean)</CODE></A>.</I></DD></DL>"},
"<DD><STRONG>Deprecated.</STRONG> <I>As of JDK version" +
" 1.5, replaced by" +
NL +
" <A HREF=\"../pkg1/C1.html#setUndecorated(boolean)\">" +
"<CODE>setUndecorated(boolean)</CODE></A>.</I>" +
NL +
"<P>" +
NL +
"protected <STRONG>C5</STRONG>()</PRE>" +
NL +
"<DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> </DD></DL>"},
"public void <STRONG>printInfo</STRONG>()</PRE>" +
NL +
"<DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> </DD></DL>"},
"undecorated</STRONG></PRE>" +
NL +
"<DL>" +
NL +
"<DD><STRONG>" +
"Deprecated.</STRONG> <I>As of JDK version 1.5, replaced by" +
NL +
" <A HREF=\"pkg1/C1.html#setUndecorated(boolean)\"><CODE>" +
"setUndecorated(boolean)</CODE></A>.</I></DD></DL>"},
"Deprecated.</STRONG> <I>As of JDK version" +
" 1.5, replaced by" +
NL +
"<CODE>setUndecorated(boolean)</CODE></A>.</I>" +
NL +
"<P>" +
NL +
"publicKey</STRONG></PRE>" +
NL +
"<DL>" +
NL +
"<DD><STRONG>" +
"Deprecated.</STRONG> </DD></DL>"}};
// Test with -nodeprecated option. The ClassDocs should have properly nested // definition list tags enclosing comments and tags. The ClassDocs should not // display definition list for deprecated information. The serialized form // should display properly nested definition list tags for comments, tags // and deprecated information. "<DT><STRONG>Since:</STRONG></DT>" +
NL +
" <DD>JDK1.0</DD></DL>"},
"<DT><STRONG>Since:</STRONG></DT>" +
NL +
" <DD>JDK1.0</DD>" +
NL +
"<DT><STRONG>See Also:</STRONG></DT><DD>" +
"<A HREF=\"../pkg1/C2.html\" title=\"class in pkg1\">" +
"<CODE>C2</CODE></A>, " +
NL +
"Serialized Form</A></DD></DL>"},
"<DD>Constructor." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>Parameters:</STRONG></DT><DD>" +
"<CODE>title</CODE> - the title</DD><DD><CODE>test</CODE>" +
" - boolean value</DD>" +
NL +
"<DT><STRONG>Throws:</STRONG></DT>" +
NL +
"<DD><CODE>java.lang.IllegalArgumentException</CODE>" +
" - if the <code>owner</code>'s" +
NL +
" <code>GraphicsConfiguration" +
"</code> is not from a screen device</DD>" +
NL +
"<DD><CODE>" +
"HeadlessException</CODE></DD></DL>" +
NL +
"</DD>" +
NL +
"<DD>Method comments." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>Parameters:" +
"</STRONG></DT><DD><CODE>undecorated</CODE> - <code>true</code>" +
" if no decorations are" +
NL +
" to be enabled;" +
NL +
" <code>false</code> if decorations are to be enabled." +
"</DD><DT><STRONG>Since:</STRONG></DT>" +
NL +
" <DD>1.4</DD>" +
NL +
"<DT><STRONG>See Also:</STRONG></DT>" +
"<DD><A HREF=\"../pkg1/C1.html#readObject()\"><CODE>" +
"readObject()</CODE></A></DD></DL>" +
NL +
"</DD>" +
NL +
"<DT><STRONG>Throws:</STRONG></DT>" +
NL +
"<DD><CODE>" +
"java.io.IOException</CODE></DD><DT><STRONG>See Also:" +
"<A HREF=\"../pkg1/C1.html#setUndecorated(boolean)\">" +
"<CODE>setUndecorated(boolean)</CODE></A></DD></DL>" +
NL +
"<DD>No modal exclusion." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"</DL>"},
"<P>" +
NL +
"</DD>" +
NL +
"</DL>"},
"<DT><STRONG>Throws:</STRONG></DT>" +
NL +
"<DD><CODE>" +
"java.io.IOException</CODE></DD><DT><STRONG>See Also:</STRONG>" +
"</DT><DD><A HREF=\"pkg1/C1.html#setUndecorated(boolean)\">" +
"<CODE>C1.setUndecorated(boolean)</CODE></A></DD></DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> <I>As of JDK version " +
"1.5, replaced by" +
NL +
"<CODE>setUndecorated(boolean)</CODE></A>.</I></DD>" +
"<DD>This field indicates whether the C1 is undecorated." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD> </DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>Since:</STRONG></DT>" +
NL +
" <DD>1.4</DD>" +
NL +
"<DT><STRONG>See Also:</STRONG>" +
"</DT><DD><A HREF=\"pkg1/C1.html#setUndecorated(boolean)\">" +
"<CODE>C1.setUndecorated(boolean)</CODE></A></DD></DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> <I>As of JDK version" +
" 1.5, replaced by" +
NL +
"<CODE>setUndecorated(boolean)</CODE></A>.</I>" +
NL +
"<P>" +
NL +
"</DD><DD>Reads the object stream." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD><DL>" +
NL +
"<DT><STRONG>Throws:" +
"</STRONG></DT>" +
NL +
"<DD><CODE><code>" +
"IOException</code></CODE></DD>" +
NL +
"<DD><CODE>java.io.IOException</CODE></DD></DL>" +
NL +
"<DD><STRONG>Deprecated.</STRONG> </DD><DD>" +
"The name for this class." +
NL +
"<P>" +
NL +
"</DD>" +
NL +
"<DD> </DD>" +
NL +
"</DL>"}};
// Test with -nocomment and -nodeprecated options. The ClassDocs whould // not display definition lists for any member details. The serialized // form should display properly nested definition list tags for // deprecated information only. "<STRONG>readObject</STRONG>()" +
NL +
" throws" +
" java.io.IOException</PRE>" +
NL +
"<HR>"},
"C2</STRONG>()</PRE>" +
NL +
"<HR>"},
"title=\"enum in pkg1\">C1.ModalExclusionType</A> <STRONG>" +
"APPLICATION_EXCLUDE</STRONG></PRE>" +
NL +
"<HR>"},
"undecorated</STRONG></PRE>" +
NL +
"<DL>" +
NL +
"<DD><STRONG>" +
"Deprecated.</STRONG> <I>As of JDK version 1.5, replaced by" +
NL +
" <A HREF=\"pkg1/C1.html#setUndecorated(boolean)\"><CODE>" +
"setUndecorated(boolean)</CODE></A>.</I></DD></DL>"},
"Deprecated.</STRONG> <I>As of JDK version" +
" 1.5, replaced by" +
NL +
"<CODE>setUndecorated(boolean)</CODE></A>.</I>" +
NL +
"<P>" +
NL +
"publicKey</STRONG></PRE>" +
NL +
"<DL>" +
NL +
"<DD><STRONG>" +
"Deprecated.</STRONG> </DD></DL>"}};
// Test for valid HTML generation which should not comprise of empty "-d",
BUG_ID,
"-nocomment",
"-nodeprecated",
"-sourcepath",
SRC_DIR,
"pkg1"};
* The entry point of the test. * @param args the array of command line arguments.