<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
font-size:11.0pt;
font-family:"Calibri",sans-serif;
mso-ligatures:standardcontextual;
mso-fareast-language:EN-US;}
pre
{mso-style-priority:99;
mso-style-link:"HTML Preformatted Char";
margin:0cm;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Courier New";}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
{mso-style-priority:34;
margin-top:0cm;
margin-right:0cm;
margin-bottom:0cm;
margin-left:36.0pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;
mso-ligatures:standardcontextual;
mso-fareast-language:EN-US;}
span.Heading3Char
{mso-style-name:blob-code-inner;}
span.pl-token
{mso-style-name:pl-token;}
span.pl-ent
{mso-style-name:pl-ent;}
span.pl-kos
{mso-style-name:pl-kos;}
span.HTMLPreformattedChar
{mso-style-name:"HTML Preformatted Char";
mso-style-priority:99;
mso-style-link:"HTML Preformatted";
font-family:"Courier New";
mso-fareast-language:EN-GB;}
span.linewrapper
{mso-style-name:line_wrapper;}
span.x
{mso-style-name:x;}
span.pl-c
{mso-style-name:pl-c;}
span.truncate
{mso-style-name:truncate;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;
mso-ligatures:none;
mso-fareast-language:EN-US;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
/* List Definitions */
@list l0
{mso-list-id:731006914;
mso-list-template-ids:920841846;}
@list l0:level1
{mso-level-tab-stop:36.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level2
{mso-level-tab-stop:72.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level3
{mso-level-tab-stop:108.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level4
{mso-level-tab-stop:144.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level5
{mso-level-tab-stop:180.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level6
{mso-level-tab-stop:216.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level7
{mso-level-tab-stop:252.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level8
{mso-level-tab-stop:288.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l0:level9
{mso-level-tab-stop:324.0pt;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l1
{mso-list-id:2078671799;
mso-list-type:hybrid;
mso-list-template-ids:1905421482 134807567 134807577 134807579 134807567 134807577 134807579 134807567 134807577 134807579;}
@list l1:level1
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l1:level2
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l1:level3
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l1:level4
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l1:level5
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l1:level6
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l1:level7
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l1:level8
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-18.0pt;}
@list l1:level9
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
ol
{margin-bottom:0cm;}
ul
{margin-bottom:0cm;}
--></style>
</head>
<body lang="EN-IN" link="#0563C1" vlink="#954F72" style="word-wrap:break-word">
<div class="WordSection1">
<p class="MsoNormal"><span lang="EN-US">Hello,<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">Currently we’re facing 4 violations when generated our API docs using OpenJDK8.<o:p></o:p></span></p>
<ol style="margin-top:0cm" start="1" type="1">
<li class="MsoListParagraph" style="margin-left:0cm;mso-list:l1 level1 lfo3">aria_content_in_landmark<span lang="EN-US"><o:p></o:p></span></li><li class="MsoListParagraph" style="margin-left:0cm;mso-list:l1 level1 lfo3">skip_main_exists<span lang="EN-US"><o:p></o:p></span></li><li class="MsoListParagraph" style="margin-left:0cm;mso-list:l1 level1 lfo3">table_summary_redundant<span lang="EN-US"><o:p></o:p></span></li><li class="MsoListParagraph" style="margin-left:0cm;mso-list:l1 level1 lfo3"><span lang="EN-US">text_contrast_sufficient<o:p></o:p></span></li></ol>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">In OpenJDK11 and OpenJDK17 these issues are not seen. As per our observation, the Javadoc implementation with respect to below vulnerabilities is different in OpenJDK11/17 compared to OpenJDK8.
<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><br>
Hence, below is our proposed fix.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">1. text_contrast_sufficient<br>
<br>
<o:p></o:p></span></p>
<p class="MsoNormal"><b><span lang="EN-US">Description:</span></b><span lang="EN-US"> When text and its background colors have less than a 4.5 to 1 contrast ratio it can be difficult for people with moderately low vision to read the text without a contrast-enhancing
technology. For larger text of 18 point or more, or bold 14 point text, the text and background colors must give at least a 3 to 1 contrast ratio.<br>
<br>
<b>Fix for the violation:<o:p></o:p></b></span></p>
<p class="MsoNormal"><span lang="EN-US">Modify stylesheet.css to adjust packagesummary wherever color coding is defined. Below are the changes added to stylesheet which fixed the violation.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">File changed: </span><span class="truncate">langtools/src/share/classes/com/sun/tools/doclets/internal/toolkit/resources/stylesheet.css</span><span lang="EN-US"><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">Line 383 : Add below lines of code.<o:p></o:p></span></p>
<p class="MsoNormal" style="background:white"><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">.</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">constantsSummary
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">caption</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">a</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:purple;mso-ligatures:none;mso-fareast-language:EN-GB">:</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">link</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">,</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">.</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">constantsSummary
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">caption</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">a</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:purple;mso-ligatures:none;mso-fareast-language:EN-GB">:</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">visited</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">,</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB"><o:p></o:p></span></p>
<p class="MsoNormal" style="background:white"><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">.</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">useSummary
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">caption</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">a</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:purple;mso-ligatures:none;mso-fareast-language:EN-GB">:</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">link</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">,</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">.</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">useSummary
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">caption</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">a</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:purple;mso-ligatures:none;mso-fareast-language:EN-GB">:</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:maroon;mso-ligatures:none;mso-fareast-language:EN-GB">visited</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><span style="font-size:10.0pt;font-family:"Courier New";color:purple;mso-ligatures:none;mso-fareast-language:EN-GB">{</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB"><o:p></o:p></span></p>
<p class="MsoNormal" style="background:white"><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB">
</span><b><span style="font-size:10.0pt;font-family:"Courier New";color:#BB7977;mso-ligatures:none;mso-fareast-language:EN-GB">color</span></b><span style="font-size:10.0pt;font-family:"Courier New";color:#808030;mso-ligatures:none;mso-fareast-language:EN-GB">:</span><span style="font-size:10.0pt;font-family:"Courier New";color:#008C00;mso-ligatures:none;mso-fareast-language:EN-GB">#</span><span style="font-size:10.0pt;font-family:"Courier New";color:green;mso-ligatures:none;mso-fareast-language:EN-GB">1f389c</span><span style="font-size:10.0pt;font-family:"Courier New";color:purple;mso-ligatures:none;mso-fareast-language:EN-GB">;</span><span style="font-size:10.0pt;font-family:"Courier New";color:black;mso-ligatures:none;mso-fareast-language:EN-GB"><o:p></o:p></span></p>
<p class="MsoNormal" style="background:white"><span style="font-size:10.0pt;font-family:"Courier New";color:purple;mso-ligatures:none;mso-fareast-language:EN-GB">}<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">Line 385 : Add </span><span class="Heading3Char">.</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">caption</span><span class="Heading3Char"> </span><span class="pl-ent">a</span><span class="pl-kos">:</span><span class="pl-token">link</span><span class="pl-kos">,</span>
<span lang="EN-US"><br>
Line 395 : Add </span><span class="Heading3Char">.</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">caption</span><span class="Heading3Char"> </span><span class="pl-token">span<br>
Line 407 : Add </span><span class="x">.</span><span class="pl-token">packagesSummary</span><span class="x">
</span><span class="pl-token">caption</span><span class="x"> </span><span class="pl-token">span</span><span class="x">.</span><span class="pl-token">activeTableTab</span><span class="x">
</span><span class="pl-token">span<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 429 : Add </span><span class="Heading3Char">.</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">caption</span><span class="Heading3Char"> </span><span class="pl-token">span</span><span class="Heading3Char">.</span><span class="pl-token">tableTab</span><span class="pl-kos">,</span><span class="Heading3Char"> .</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">caption</span><span class="Heading3Char"> </span><span class="pl-token">span</span><span class="Heading3Char">.</span><span class="pl-token">activeTableTab<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 438 : Add </span><span class="x">.</span><span class="pl-token">packagesSummary</span><span class="x"> .</span><span class="pl-token">tabEnd<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 445 : Add </span><span class="x">.</span><span class="pl-token">packagesSummary</span><span class="x"> .</span><span class="pl-token">activeTableTab</span><span class="x"> .</span><span class="pl-token">tabEnd<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 453 : Add </span><span class="x">.</span><span class="pl-token">packagesSummary</span><span class="x"> .</span><span class="pl-token">activeTableTab</span><span class="x"> .</span><span class="pl-token">tabEnd<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 463 : Add </span><span class="Heading3Char">.</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">td<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 468 : Add </span><span class="Heading3Char">.</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">th<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 474 : Add </span><span class="Heading3Char">.</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">th<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-token">Line 488 : Add below lines of code.<o:p></o:p></span></p>
<pre style="background:white"><span class="linewrapper"><span style="color:#808030">.</span><span style="color:black">constantsSummary </span><b><span style="color:maroon">th</span></b><span style="color:#808030">,</span><span style="color:black"> </span><span style="color:#808030">.</span><span style="color:black">packagesSummary </span><b><span style="color:maroon">th</span></b><span style="color:black"> </span><span style="color:purple">{</span></span><span style="color:black"><o:p></o:p></span></pre>
<pre style="background:white"><span class="linewrapper"><b><span style="color:#BB7977"> font-size</span></b><span style="color:#808030">:</span><span style="color:#008C00">13</span><span style="color:#006600">px</span><span style="color:purple">;</span></span><span style="color:black"><o:p></o:p></span></pre>
<pre style="background:white"><span class="linewrapper"><span style="color:purple">}</span></span><span class="pl-token"><span style="color:black"><o:p></o:p></span></span></pre>
<p class="MsoNormal"><span class="pl-token">Line 490 : Add </span><span class="Heading3Char">.</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">td</span><span class="Heading3Char">.</span><span class="pl-token">colFirst</span><span class="pl-kos">,</span><span class="Heading3Char"> .</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-ent">td</span><span class="Heading3Char">.</span><span class="pl-token">colSecond</span><span class="pl-kos">,</span><span class="Heading3Char"> .</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">th</span><span class="Heading3Char">.</span><span class="pl-token">colFirst</span><span class="pl-kos">,</span><span class="Heading3Char"> .</span><span class="pl-token">packagesSummary</span><span class="Heading3Char">
</span><span class="pl-token">th</span><span class="pl-kos">,<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-kos">Line 497 : Add below lines of code.<o:p></o:p></span></p>
<pre style="background:white"><span class="linewrapper"><span style="color:#808030">.</span><span style="color:black">packagesSummary </span><b><span style="color:maroon">th</span></b><span style="color:#808030">.</span><span style="color:black">colLast</span><span style="color:#808030">,</span><span style="color:black"> </span><span style="color:#808030">.</span><span style="color:black">packagesSummary </span><b><span style="color:maroon">td</span></b><span style="color:#808030">.</span><span style="color:black">colLast </span><span style="color:purple">{</span></span><span style="color:black"><o:p></o:p></span></pre>
<pre style="background:white"><span class="linewrapper"><span style="color:black"> </span><b><span style="color:#BB7977">white-space</span></b><span style="color:#808030">:</span><span style="color:#074726">normal</span><span style="color:purple">;</span></span><span style="color:black"><o:p></o:p></span></pre>
<pre style="background:white"><span class="linewrapper"><span style="color:purple">}</span></span><span style="color:black"><o:p></o:p></span></pre>
<p class="MsoNormal"><span class="pl-token"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">2. </span>table_summary_redundant</p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><b>Description:</b> Duplicating a table’s caption and its summary description is repetitive and slows productivity for Assistive Technology users. If used, the summary should provide complementary information not already available in the
caption.</p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><b>Fix for the violation:<o:p></o:p></b></p>
<p class="MsoNormal">Eliminate repetitive caption from adding it to HtmlTree.</p>
<p class="MsoNormal"><br>
File changed : <span class="truncate">langtools/src/share/classes/com/sun/tools/doclets/formats/html/markup/HtmlTree.java</span></p>
<p class="MsoNormal">Line 652 : Comment out the repetitive content from adding to HtmlTree</p>
<p class="MsoNormal"><span class="x">//</span><span class="pl-c">htmltree.addAttr(HtmlAttr.SUMMARY, nullCheck(summary));<o:p></o:p></span></p>
<p class="MsoNormal"><span class="pl-c"><o:p> </o:p></span></p>
<p class="MsoNormal"><span class="pl-c">The other 2 violations we’re still working on the fix. Please evaluate and suggest if we can merge these fixes to OpenJDK8.
<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div>
<p class="MsoNormal"><span style="mso-ligatures:none;mso-fareast-language:EN-GB">Thanks,<br>
---------------------<o:p></o:p></span></p>
<p class="MsoNormal"><span style="mso-ligatures:none;mso-fareast-language:EN-GB">Pasam Soujanya<o:p></o:p></span></p>
<p class="MsoNormal"><span style="mso-ligatures:none;mso-fareast-language:EN-GB">SVT/JCK Test Engineer<o:p></o:p></span></p>
<p class="MsoNormal"><span style="mso-ligatures:none;mso-fareast-language:EN-GB">IBM Runtime Technologies<o:p></o:p></span></p>
<p class="MsoNormal"><span style="mso-ligatures:none;mso-fareast-language:EN-GB">Mobile: +91-6301274414<o:p></o:p></span></p>
<p class="MsoNormal"><span style="mso-ligatures:none;mso-fareast-language:EN-GB"> <o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><br>
<br>
<br>
<span lang="EN-US"><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
</body>
</html>