Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4706779
Votes 0
Synopsis stddoclet: Add text equivalent of ASCII art in class tree for accessibility
Category doclet:tbd
Reported Against 1.2 , 1.4.0_00
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, request for enhancement
Priority: 4-Low
Related Bugs 4198141
Submit Date 22-JUN-2002
Description
The ASCII class trees need equivalent text.

  Priority 1
  Section 508 1194.22(a)
      A text equivalent for every non-text element shall be provided 
      (e.g., via "alt", "longdesc", or in element content)
  W3C Checkpoint 1.1
       http://www.w3.org/TR/WCAG10-CORE-TECHS/#text-equivalent
       "Text equivalents mus be provided for every non-text element ... 
        This includes ASCII art..."

The ASCII art under consideration is the vertical line, horizontal line 
and plus sign:

   java.lang.Object
    |
    +--java.lang.String
Work Around
N/A
Evaluation
Important for accessibility.
 xxxxx@xxxxx  2002-06-22

There are two ways to resolve this:

- Put a <MAP title="xxx"> element around each piece of ASCII art,
  similar to that recommended for grouping links in a navigation bar
- Replace the ASCII art with an image <IMG src="inherit.gif" alt="xxx">

The second approach would also make the appearance better, a long-needed 
enhancement.

 xxxxx@xxxxx  2002-08-22

> What should the alt text be?
>
> The alt text should make sense when spoken by an accessibility program
> to a non-sighted user in the context of the words before and after it.
> For example, the above would be spoken as:
>
>   "java-dot-lang-dot-Object is extended by com-dot-package-dot-Class1"
>
> Unfortunately, this is the reverse of the way we normally speak it.
>
> A) "is extended by" in all cases
> B) Insert different strings for an interface "implemented by" a class
>    compared to an interface "extended by" an interface,
>    and a class "extended by" a class.
> C) Drop the word "is" in proposal A or B:  "extended by", "implemented by"
> D) Other proposals?

  I vote C.  I'd *definitely* distinguish extended and implemented.  I agree
that the "is" seems unnecessary, but I could go either way on it.

            Regards,

             xxxxx@xxxxx 

Conclusion for alt text:
  interface "implemented by" class
  interface "extended by" interface
  class "extended by" class

 xxxxx@xxxxx  2002-08-27

Decided to create a resources directory in the destination directory
to hold non-HTML files that come from the source tree resources directory,
such as inherit.gif and stylesheet.css.  Equivalent to what is used in 
the MIF Doclet.

 xxxxx@xxxxx  2002-08-29
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang