Clean up generated html for JLS & JVMS

XMLWordPrintable

    • Type: Bug
    • Resolution: Unresolved
    • Priority: P3
    • 26
    • 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">

            Assignee:
            Dan Smith
            Reporter:
            Dan Smith
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated: