jms-spec
  1. jms-spec
  2. JMS_SPEC-104

API javadocs need to conform to Oracle accessibility standards and W3C HTML validation standards

    Details

    • Type: New Feature New Feature
    • Status: Open
    • Priority: Major Major
    • Resolution: Unresolved
    • Affects Version/s: 2.0PD
    • Fix Version/s: None
    • Labels:
      None

      Description

      The JMS API javadocs need to conform to Oracle accessibility standards and W3C HTML validation standards

      The W3C HTML validator is at http://validator.w3.org

      The Oracle accessibility validator is at oac.us.oracle.com (Oracle internal only)

        Activity

        Nigel Deakin created issue -
        Nigel Deakin made changes -
        Field Original Value New Value
        Tags jms20-pd20-doc
        Nigel Deakin made changes -
        Fix Version/s 2.0 [ 14692 ]
        Nigel Deakin made changes -
        Fix Version/s 2.0FD [ 16325 ]
        Hide
        Nigel Deakin added a comment - - edited

        This has been confirmed as far as possible.

        One possible issue remains in that the character encoding (which should be UTF-8) is incorrectly configured.

        The javadocs define this as follows:

        <!-- Generated by javadoc (version 1.7.0_17) on Tue Mar 19 14:40:26 GMT 2013 -->
        <meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
        

        whereas it should be

        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
        

        Note the different use of " and ; characters.

        This is due to a bug in the javadoc program in Java SE 7. This has been logged with the JDK team (internal bug JDK-8006650).

        This issue was therefore not completely resolved in JMS 2.0 and so has been left unresolved. Tagging for JMS 2.1.

        Show
        Nigel Deakin added a comment - - edited This has been confirmed as far as possible. One possible issue remains in that the character encoding (which should be UTF-8) is incorrectly configured. The javadocs define this as follows: <!-- Generated by javadoc (version 1.7.0_17) on Tue Mar 19 14:40:26 GMT 2013 --> <meta http-equiv="Content-Type" content="text/html" charset="UTF-8"> whereas it should be <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> Note the different use of " and ; characters. This is due to a bug in the javadoc program in Java SE 7. This has been logged with the JDK team (internal bug JDK-8006650). This issue was therefore not completely resolved in JMS 2.0 and so has been left unresolved. Tagging for JMS 2.1.
        Nigel Deakin made changes -
        Fix Version/s 2.0 [ 14692 ]
        Fix Version/s 2.0FD [ 16325 ]
        Nigel Deakin made changes -
        Tags jms20-pd20-doc
        Nigel Deakin made changes -
        Tags jms21-forreview-minor

          People

          • Assignee:
            Unassigned
            Reporter:
            Nigel Deakin
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated: