-
Type:
Bug
-
Resolution: Unresolved
-
Priority:
P3
-
Affects Version/s: 25
-
Component/s: specification
When DocCheck and tidy run on the JLS & JVMS html files, they report a number of issues, in the following categories:
- Redundant identifiers: the html for grammar productions looks like the following, using the same name twice:
<div id="jls-3.3-110" class="productionset"><a name="jls-3.3-110"></a>
- Proprietary attributes: tidy does not like the attributes "xmlns:fo" and "xmlns:rx" appearing in the header and footer of each page:
<div xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:rx="http://www.renderx.com/XSL/Extensions" id="logo">
<div xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:rx="http://www.renderx.com/XSL/Extensions" class="navfooter">
- Tables without "summary": a number of tables in JVMS 4 and 7 do not have a "summary" attribute:
<table class="table" border="0">
vs.
<table class="table" summary="Floating-point parameters" border="1">
- Empty list tags: a few lists/list items with no body in JVMS 4, JVMS 6, and the index page TOC:
<li class="listitem"></li>
<dd>
<dl></dl>
</dd>
- Unexpected doctype: we've standardized on HTML 5, but these docs use 4.01:
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- Redundant identifiers: the html for grammar productions looks like the following, using the same name twice:
<div id="jls-3.3-110" class="productionset"><a name="jls-3.3-110"></a>
- Proprietary attributes: tidy does not like the attributes "xmlns:fo" and "xmlns:rx" appearing in the header and footer of each page:
<div xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:rx="http://www.renderx.com/XSL/Extensions" id="logo">
<div xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:rx="http://www.renderx.com/XSL/Extensions" class="navfooter">
- Tables without "summary": a number of tables in JVMS 4 and 7 do not have a "summary" attribute:
<table class="table" border="0">
vs.
<table class="table" summary="Floating-point parameters" border="1">
- Empty list tags: a few lists/list items with no body in JVMS 4, JVMS 6, and the index page TOC:
<li class="listitem"></li>
<dd>
<dl></dl>
</dd>
- Unexpected doctype: we've standardized on HTML 5, but these docs use 4.01:
<!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- blocks
-
JDK-8370249 Test jdk/javadoc/doccheck/checks/jdkCheckLinks.java fails due to JVMS/JLS links after JDK-8349681
-
- Open
-
-
JDK-8370970 DocCheck failure in jdkDoctypeBadcharsCheck.java and jdkCheckHtml.java
-
- Open
-