JDK-8225448 : String::translateEscapes javadoc has accessibility issues
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.lang
  • Affected Version: 13
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2019-06-06
  • Updated: 2019-06-27
  • Resolved: 2019-06-07
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 13 JDK 14
13 b25Fixed 14Fixed
Related Reports
Relates :  
Description
The recent update to String.java JDK-8223780 contained a <table> with accesibility issues:

build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3750: no row header for row 1
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3751: no row header for row 1
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3755: no row header for row 2
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3756: no row header for row 2
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3760: no row header for row 3
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3761: no row header for row 3
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3765: no row header for row 4
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3766: no row header for row 4
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3770: no row header for row 5
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3771: no row header for row 5
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3775: no row header for row 6
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3776: no row header for row 6
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3780: no row header for row 7
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3781: no row header for row 7
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3785: no row header for row 8
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3786: no row header for row 8
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3790: no row header for row 9
build/linux-x86_64-server-release/images/docs/api/java.base/java/lang/String.html:3791: no row header for row 9

Here is the table:

3002      * <table class="plain">
3003      *   <caption style="display:none">Escape sequences</caption>
3004      *   <thead>
3005      *   <tr>
3006      *     <th scope="col">Escape</th>
3007      *     <th scope="col">Name</th>
3008      *     <th scope="col">Unicode/action</th>
3009      *   </tr>
3010      *   </thead>
3011      *   <tr>
3012      *     <td>{@code \u005Cb}</td>
3013      *     <td>backspace</td>
3014      *     <td>{@code \u005Cu0008}</td>
3015      *   </tr>
3016      *   <tr>
3017      *     <td>{@code \u005Ct}</td>
3018      *     <td>horizontal tab</td>
3019      *     <td>{@code \u005Cu0009}</td>
3020      *   </tr>
3021      *   <tr>
3022      *     <td>{@code \u005Cn}</td>
3023      *     <td>line feed</td>
3024      *     <td>{@code \u005Cu000A}</td>
3025      *   </tr>
3026      *   <tr>
3027      *     <td>{@code \u005Cf}</td>
3028      *     <td>form feed</td>
3029      *     <td>{@code \u005Cu000C}</td>
3030      *   </tr>
3031      *   <tr>
3032      *     <td>{@code \u005Cr}</td>
3033      *     <td>carriage return</td>
3034      *     <td>{@code \u005Cu000D}</td>
3035      *   </tr>
3036      *   <tr>
3037      *     <td>{@code \u005C"}</td>
3038      *     <td>double quote</td>
3039      *     <td>{@code \u005Cu0022}</td>
3040      *   </tr>
3041      *   <tr>
3042      *     <td>{@code \u005C'}</td>
3043      *     <td>single quote</td>
3044      *     <td>{@code \u005Cu0027}</td>
3045      *   </tr>
3046      *   <tr>
3047      *     <td>{@code \u005C\u005C}</td>
3048      *     <td>backslash</td>
3049      *     <td>{@code \u005Cu005C}</td>
3050      *   </tr>
3051      *   <tr>
3052      *     <td>{@code \u005C0 - \u005C377}</td>
3053      *     <td>octal escape</td>
3054      *     <td>code point equivalents</td>
3055      *   </tr>
3056      * </table>


I suggest using <table class="striped"> and change the first element of each row to <th scope="row">...</th>
Also suggest putting <tbody> around the body rows.