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 - NetBeans API Documentation Module needs to point/link to index instead of overview-summary
Summary: NetBeans API Documentation Module needs to point/link to index instead of ove...
Status: NEW
Alias: None
Product: java
Classification: Unclassified
Component: Javadoc (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker (vote)
Assignee: Jan Becicka
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-11-29 00:44 UTC by _ wadechandler
Modified: 2010-09-23 08:39 UTC (History)
0 users

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
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.