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: 4140824
Votes 0
Synopsis stddoclet: "All Classes" list is not available when frames are off
Category doclet:tbd
Reported Against 1.2beta4
Release Fixed 1.4(merlin-beta2)
State 10-Fix Delivered, Verified, request for enhancement
Priority: 4-Low
Related Bugs 4187643
Submit Date 21-MAY-1998
Description
When frames are turned off, the user should have the same full access
to all the web pages.  However, with frames off there is no link that will 
take you to the "All Classes" list, a very useful page.  

So where should we add that link?  The main nav bar is too cluttered for 
another long name.  Suggest adding this link to the index nav bar:

A B C D E F ... X Y Z _ All Classes
Work Around
N/A
Evaluation
Yes, index page is the correct place for the All_Classes link. Easy to fix.
  xxxxx@xxxxx   1998-05-22


From an accessibility perespective this isn't true. Equivalence is the goal for accessibility and burying All_Classes in link does not provide this. The easy access provided to frame users should be available with the same level of access as to the non-frame user. Overiew is one feature provided with frames in the non-frames function, the same should be done for all classes. javadoc's competitor Polardoc places an all classes function (called class search) in the header of its pages because they feel it is important. In speaking with Doug Kramer on this he says many users find an All Classes function much more helpful than using the Index.
  xxxxx@xxxxx   1998-08-11

What Earl says makes sense.  However, I don't see how to do that without
adding clutter for the frame users.  To give All_Classes the equivalence 
he seeks, we could put a link for All Classes in the navigation bar;  
however, it would not make much sense for the frame users, as it would 
display a list that initially is already present in the lower-left frame.
If we put it in the navigation bar, I suggest calling it:

   Class_Index

Then it should go to the left of the Index link. 
  xxxxx@xxxxx   2000-02-29

A blind developer, James Homme, has written in and requested this
feature.  In response, I have copied his comment into the "Comment"
field and raised this to priority 4.
  xxxxx@xxxxx   2000-02-29

This bug has been fixed.  Location of fix:

AllClassesFrameWriter.java
HtmlStandardWriter.java
standard.properties

  xxxxx@xxxxx   2001-05-30

Reopenning bug to refine fix.
  xxxxx@xxxxx   2001-05-30

The fix has been refined.  The "All Classes" link now appears next to the "No Frames" link.
  xxxxx@xxxxx   2001-05-30
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang