|
Quick Lists
|
|
Bug ID:
|
4625400
|
|
Votes
|
0
|
|
Synopsis
|
stddoclet: Missing whitespace in DOCTYPE declaration
|
|
Category
|
doclet:tbd
|
|
Reported Against
|
merlin-beta3
|
|
Release Fixed
|
1.4.2(mantis)
|
|
State
|
10-Fix Delivered,
bug
|
|
Priority:
|
4-Low
|
|
Related Bugs
|
|
|
Submit Date
|
17-JAN-2002
|
|
Description
|
Fixed by adding the required space.
Regresssion test at:
<ws>/test/com/sun/javadoc/ValidHtml/ValidHtml.java
xxxxx@xxxxx 2002-09-25
FULL PRODUCT VERSION :
java version "1.3.1"
Jav(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.3.1-FCS)
Java HotSpot(TM) Client VM (build Blackdown-1.3.1-FCS, mixed mode)
FULL OPERATING SYSTEM VERSION :
linux-2.4.17
libc6-2.2.4
Debian GNU 3.0
This behavior also appears on Solaris 8 with JDK 1.4 beta 3.
A DESCRIPTION OF THE PROBLEM :
This bug is very similar to 4418115.
The generated JavaDoc documentation has a wrong DOCTYPE
definition:
<!DOCTYPE HTML PUBLIC "-//W3C/DTD HTML 4.0
Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
There is no blank between the public identifier
"-//W3C/DTD HTML 4.0 Transitional//EN"
and its URI
"http://www.w3.org/TR/REC-html40/loose.dtd"
Every old generated JavaDoc is wrong. The bug was found when
trying to parse generated JavaDoc for automated index
generation of installed package documentation.
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. echo "public class x { }" > x.java
2. javadoc x.java
3. head -1 *.html
EXPECTED VERSUS ACTUAL BEHAVIOR :
Actual Result:
<!DOCTYPE HTML PUBLIC "-//W3C/DTD HTML 4.0
Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
Expected Result:
<!DOCTYPE HTML PUBLIC "-//W3C/DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
This bug can be reproduced always.
---------- BEGIN SOURCE ----------
class x { }
---------- END SOURCE ----------
CUSTOMER WORKAROUND :
Postprecess every generated JavaDoc and add a blank:
find . -name \*.html -exec perl -i -p -e 's,<!DOCTYPE HTML
PUBLIC "-//W3C/DTD HTML 4.0
Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">,<!DOCTYPE
HTML PUBLIC "-//W3C/DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">,' {} \;
(Review ID: 138175)
======================================================================
|
|
Work Around
|
N/A
|
|
Evaluation
|
It does appear from spot checking that there is indeed not a character space. However, I'm not sure if the specification for the DOCTYPE declaration requires a space. Must be investigated.
xxxxx@xxxxx 2002-01-17
|
|
Comments
|
PLEASE NOTE: JDK6 is formerly known as Project Mustang
|
|
|
|
