SYNOPSIS
--------
Accessibility in Javadoc: hyperlinks should contain text or an image with alt text


OPERATING SYSTEMS
-----------------
ALL


PATCH BASE
---------
See attached webrev for code changes and jtreg testcase, based on JDK 8 (b51).


FULL JDK VERSIONS
-----------------
All


DESCRIPTION from LICENSEE
-------------------------
Assistive technologies must be able to gather information about user interface controls in page content. Without this information, users are unable to determine the purpose of a link. Text within the <a> element, or the 'alt' attribute on an image of the link, should be employed to convey this information to users.

Refer to WCAG 2.0 Technique H30:

  http://www.w3.org/WAI/GL/WCAG20/WD-WCAG20-TECHS/H30


REPRODUCTION INSTRUCTIONS
-------------------------
For any packages, generate javadoc using the javadoc tool. For example:

  javadoc -d e:\docs -sourcepath . java.util javax.swing java.io

Example current HTML:
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">

Example expected HTML:
<div class="skip"><a href="#skip-navbar_top" title="Skip navigation links">Skip navigation links</a></div>

Related guideline references:

  WCAG 2.0 checkpoint 1.1.1
  WCAG 2.0 checkpoint 2.1.1
  WCAG 2.0 checkpoint 2.4.4
  WCAG 2.0 checkpoint 2.4.9
  WCAG 2.0 checkpoint 4.1.2


WORKAROUND
----------
NONE