This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 123025

Summary: NetBeans API Documentation Module needs to point/link to index instead of overview-summary
Product: java Reporter: _ wadechandler <wadechandler>
Component: JavadocAssignee: Jan Becicka <jbecicka>
Status: NEW ---    
Severity: blocker    
Priority: P3    
Version: 6.x   
Hardware: All   
OS: All   
Issue Type: ENHANCEMENT Exception Reporter:

Description _ wadechandler 2007-11-29 00:44:20 UTC
The NetBeans Documentation Module installs the Action to the JavaDoc references Help|Javadoc References|NetBeans API
List which points to
jar:file:///${userdir}/docs/NetBeansAPIs.zip!/overview-summary.html

It seems it would be more useful to point to
jar:file:///${userdir}/docs/NetBeansAPIs.zip!/index.html

As this page includes the page currently referenced (Overview - overview-summary.html) yet also allows the user to
immediately jump into the JavaDocs and browse by classes. I end up manually changing it to index every time I open it as
I don't want to have multiple Windows or Tabs opened for every API unless I need to have one. Currently clicking on a
link from that page opens a new window and even if it didn't would not be a navigable as the index.
Comment 1 Jesse Glick 2007-11-29 07:40:05 UTC
You can click on 'FRAMES'.

Probably the original intent was to work around a bug in javax.swing.text.html code which would show HTML source for
frames in a frameset, if using the internal web browser. Anyway that bug is no longer manifested, due to a change in NB
editor kit registration.

Nothing to do with apisupport, part of the javadoc module.
Comment 2 _ wadechandler 2007-11-29 11:42:43 UTC
I had tried clicking on Frames in one of the APIs, but it would solely show the frameset for the single API. That was
why I started looking for index just like the link we click on when we go to platform.netbeans.org. index is a frameset
with all the APIs classes, so I don't have to know which modules has a class to find it. I never could find a link from
a single API which would take me to a frameset for all APIs like the main index does. 
Comment 3 Jan Pokorsky 2007-11-29 12:09:51 UTC
Agreed. I am also not aware of any more reason to open overview-summary.html instead of index.html with frames. NetBeans
docs is the reason to change it back since it is especially uncomfortable in this case. I will do it for NB 6.1.