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 33293 - JUnit javadoc not accessible
Summary: JUnit javadoc not accessible
Status: VERIFIED FIXED
Alias: None
Product: java
Classification: Unclassified
Component: JUnit (show other bugs)
Version: 3.x
Hardware: PC Linux
: P3 blocker (vote)
Assignee: junit-issues@java
URL:
Keywords: RELNOTE, SIMPLEFIX
: 33388 33664 (view as bug list)
Depends on:
Blocks:
 
Reported: 2003-04-29 10:32 UTC by _ rkubacki
Modified: 2003-12-11 14:24 UTC (History)
4 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description _ rkubacki 2003-04-29 10:32:44 UTC
trunk sources from 2003-Apr-26

though there is docs/junit-3.8.1-api.zip file the
documentation is not visible for example in View |
Documentation Indices because all its content is
packaged within javadoc directory. You can
repackage the zip or maybe set root offset for
this archive
Comment 1 Martin Brehovsky 2003-04-30 16:14:03 UTC
The junit-3.8.1-api.zip file was taken directly from junit
distribution. I will repackage it.
Comment 2 Martin Brehovsky 2003-04-30 16:20:38 UTC
Fixed in trunk. Unfortunately, I cannot fix it in release35 branch,
because of the high resistance and code freeze policy.
Comment 3 Martin Brehovsky 2003-05-05 09:21:43 UTC
*** Issue 33388 has been marked as a duplicate of this issue. ***
Comment 4 Martin Brehovsky 2003-05-16 10:45:49 UTC
*** Issue 33664 has been marked as a duplicate of this issue. ***
Comment 5 Jesse Glick 2003-05-16 12:24:23 UTC
Perhaps the P3 ranking is inappropriate given that three people have
independently noticed this and filed it, so it is not that obscure;
that the state in 3.5 is clearly wrong (a ZIP of Javadoc is shipped
yet cannot be used); and that the fix is so easy.
Comment 6 Martin Brehovsky 2003-05-16 12:50:26 UTC
I know it's simple, but because of rules in the high resistance mode,
to be able to fix the bug in release35 it has to be a showstopper,
which I'm afraid this is not.

Sorry I'd like to fix it myself, but I just simply cannot :-(.
Comment 7 John Baker 2003-05-22 01:27:00 UTC
I think this should be integrated since
JUnit is a new feature for Studio.
Can the priority be raised to P2?
Comment 8 Martin Brehovsky 2003-05-22 08:32:07 UTC
I think this has to be a P1 to be able to fix it in release35. And
because there exist an known workaround (you can set root offset)
which will be (hopefully) described in release notes, I don't think I
could make it a P1. 

Honzo what do you think? The fix is basically just a replace of
existing .zip file. Personally I would like to do it.
Comment 9 Jan Chalupa 2003-05-22 14:23:00 UTC
It's unfortunate, but it's too late for this for release35. Only
showstoppers (P1s) can be fixed at this point and this issue does not
fit into that category.

I propose to create a patch a made it available on the NetBeans update
center immediately after 3.5 is released.
Comment 10 Patrick Keegan 2003-05-27 20:15:03 UTC
Not sure this will make the release notes. However, if it does, would
this wording work?:

"Even though the API docs for JUnit come with the junit module, the
docs do not appear in View | Documentation Indices because they are
packaged incorrectly.

Workaround: Go to the IDE's installation directory, open the docs
folder, and unzip junit-3.8.1-api.zip. Then create a new zip with the
'javadoc' directory removed from the hierarchy." 
Comment 11 Jesse Glick 2003-05-27 20:54:40 UTC
"create a new zip with the 'javadoc' directory removed from the
hierarchy" - to be concrete, perhaps specify "create a new ZIP file
with the 'javadoc/' prefix removed from the hierarchy, leaving entries
such as 'packages.html' and 'junit/framework/Test.html'".

May also need to mention that the new ZIP file should replace the old
one (same name); and that the IDE should not be running at the time
(especially for Windows users).
Comment 12 Martin Brehovsky 2003-05-28 09:01:52 UTC
I don't think it is necessary to repackage the zip. If I'm not
mistaken, it should be enoug to go to Tools/Javadoc Manager, select
junit-3.8.1-api.zip and change Root Offset to 'javadoc' subdirectory. 

But it shold be rather checked if it works - I have some problem with
JavaDoc manager on my machine, because it does not show any JavaDoc at
all ....
Comment 13 Jesse Glick 2003-05-28 17:16:39 UTC
That's true, changing root offset should work, at least for Javadoc
Index Search - I don't think it would cause an entry to appear in
Documentation Indices however. Cannot confirm easily ATM - I have
already installed the fixed version of the module.
Comment 14 Bob May 2003-05-28 23:51:39 UTC
There needs to be confirmation/closure on this issue now, a final
answer for the Studio Release notes. Please let me know what I need to
write. I have sent email to appropriate parties with a copy of the
Studio Release Notes. Thanks.
Comment 15 Martin Brehovsky 2003-06-11 13:37:50 UTC
Tagging the issue with SIMPLEFIX keyword, because the fix is really
very simple and it would be nice to get this fixed for Nb 3.5.1 ...
Comment 16 David Kaspar 2003-06-30 15:18:59 UTC
Verified in trunk