United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-7006270 Several javadoc regression tests are failing on windows
JDK-7006270 : Several javadoc regression tests are failing on windows

Details
Type:
Bug
Submit Date:
2010-12-11
Status:
Closed
Updated Date:
2012-10-11
Project Name:
JDK
Resolved Date:
2011-05-17
Component:
tools
OS:
windows_xp
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P1
Resolution:
Fixed
Affected Versions:
7
Fixed Versions:

Related Reports
Relates:

Sub Tasks

Description
I might be missing something, but I am getting several javadoc regression test failures on windows with tip:
    changeset:   780:8ec3a824f925
    tag:         tip
    user:        jjg
    date:        Fri Dec 10 07:38:28 2010 -0800
    summary:     6504896: TreeMaker.Literal(Object) does not support Booleans

I believe they pass with b120:
    changeset:   746:1dd813a529cf
    tag:         jdk7-b120
    user:        mcimadamore
    date:        Mon Nov 15 14:41:21 2010 +0000
    summary:     6999635: Multicatch: crash while compiling simple code with a multicatch parameter

At least the one test I tried passes. Note that you have to run the tests from b120 as well as the jdk from b120 - the tests have changed.

Here are the failures:

com/sun/javadoc/AccessH1/AccessH1.java
com/sun/javadoc/AccessSkipNav/AccessSkipNav.java
com/sun/javadoc/JavascriptWinTitle/JavascriptWinTitle.java
com/sun/javadoc/testClassCrossReferences/TestClassCrossReferences.java
com/sun/javadoc/testClassTree/TestClassTree.java
com/sun/javadoc/testConstructorIndent/TestConstructorIndent.java
com/sun/javadoc/testDeprecatedDocs/TestDeprecatedDocs.java
com/sun/javadoc/testExternalOverridenMethod/TestExternalOverridenMethod.java
com/sun/javadoc/testHeadings/TestHeadings.java
com/sun/javadoc/testHref/TestHref.java
com/sun/javadoc/testHtmlTableTags/TestHtmlTableTags.java
com/sun/javadoc/testIndex/TestIndex.java
com/sun/javadoc/testInterface/TestInterface.java
com/sun/javadoc/testJavascript/TestJavascript.java
com/sun/javadoc/testLinkOption/TestLinkOption.java
com/sun/javadoc/testLinkTaglet/TestLinkTaglet.java
com/sun/javadoc/testMemberInheritence/TestMemberInheritence.java
com/sun/javadoc/testMemberSummary/TestMemberSummary.java
com/sun/javadoc/testNavagation/TestNavagation.java
com/sun/javadoc/testNewLanguageFeatures/TestNewLanguageFeatures.java
com/sun/javadoc/testOverridenMethods/TestOverridenPrivateMethods.java
com/sun/javadoc/testOverridenMethods/TestOverridenPrivateMethodsWithPackageFlag.java
com/sun/javadoc/testOverridenMethods/TestOverridenPrivateMethodsWithPrivateFlag.java
com/sun/javadoc/testPrivateClasses/TestPrivateClasses.java
com/sun/javadoc/testStylesheet/TestStylesheet.java
com/sun/javadoc/testTypeParams/TestTypeParameters.java
com/sun/javadoc/ValidHtml/ValidHtml.java


This test
   test/com/sun/javadoc/AccessH1/AccessH1.java

gets this failure
Sub-test 1 for bug 4636667 (AccessH1) FAILED
when searching for
.header h1.title {
    font-size
    text-align
    margin
}

I looked at a few of the other failures and they were similar.

                                    

Comments
EVALUATION

The AccessH1.java test runs javadoc, which generates a stylesheet.css file.  The test reads this file into a java String and then searches for a substring that contains property line.separator, which on windows is a string containing CRLF.

The stylesheet.css file contains just LF as the line break, and so does the java String that the file is read into.  This causes the search for a substring containing CRLF to fail, since the searchee doesn't contain the CR.

Possibliy this fix has something to do with this:
    changeset:   755:90af8d87741f
    user:        bpatel
    date:        Wed Dec 01 11:02:38 2010 -0800
    summary:     6851834: Javadoc doclet needs a structured approach to generate the output HTML.
                                     
2010-12-11
SUGGESTED FIX

The tests fail due to line separator used in Html Document Tree generation. The "\n" should be replaced by DocletConstants.NL in the classes supporting HTML Document Tree generation.
                                     
2010-12-12
EVALUATION

No additional regression tests required as the existing tests cover newline testing.
                                     
2010-12-17
EVALUATION

http://hg.openjdk.java.net/jdk7/build/langtools/rev/ffbf2b2a8611
                                     
2010-12-25



Hardware and Software, Engineered to Work Together