United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4140824 : stddoclet: "All Classes" list is not available when frames are off

Details
Type:
Enhancement
Submit Date:
1998-05-21
Status:
Closed
Updated Date:
2014-05-05
Project Name:
JDK
Resolved Date:
2001-07-13
Component:
tools
OS:
solaris_2.5,windows_95
Sub-Component:
javadoc(tool)
CPU:
x86,sparc
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.2.0
Fixed Versions:
1.4.0 (beta2)

Related Reports
Duplicate:

Sub Tasks

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


                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
merlin-beta2

FIXED IN:
merlin-beta2

INTEGRATED IN:
merlin-beta2

VERIFIED IN:
merlin-rc1


                                     
2004-06-14
EVALUATION

Yes, index page is the correct place for the All_Classes link. Easy to fix.
atul.dambalkar@eng 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.
earl.johnson@Eng 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. 
doug.kramer@eng 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.
doug.kramer@eng 2000-02-29

This bug has been fixed.  Location of fix:

AllClassesFrameWriter.java
HtmlStandardWriter.java
standard.properties

jamie.ho@Eng 2001-05-30

Reopenning bug to refine fix.
jamie.ho@Eng 2001-05-30

The fix has been refined.  The "All Classes" link now appears next to the "No Frames" link.
jamie.ho@Eng 2001-05-30
                                     
2001-05-30
PUBLIC COMMENTS

This bug has been fixed.  A "Class Index" link has been added to the navagation bar.

jamie.ho@Eng 2001-05-30
                                     
2001-05-30
SUGGESTED FIX

See the evaluation for possible fixes.  We should decide on a fix before implementing it.
doug.kramer@Eng 2000-02-29
                                     
2000-02-29



Hardware and Software, Engineered to Work Together