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 141803 - Installing Documentation
Summary: Installing Documentation
Status: RESOLVED FIXED
Alias: None
Product: java
Classification: Unclassified
Component: Javadoc (show other bugs)
Version: 6.x
Hardware: All All
: P2 blocker with 5 votes (vote)
Assignee: Jan Becicka
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-07-27 05:34 UTC by tricky99
Modified: 2011-01-13 13:05 UTC (History)
1 user (show)

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 tricky99 2008-07-27 05:34:02 UTC 
Can someone please put some meaningful instructions on on the netbeans site that gives clear and simple instructions 
as to how an end user installs and gets the documentation part of NetBeans working. I have been trying for a week now, 
and have search the netbeans site, googled as to how to get the documentation working.

Either that, or make it an easy feature like adding plugins!.

Always the same error: Javadoc not found. Either Javadoc documentation for this item does not exist or you have not 
added specified Javadoc in the Java Platform Manager or the Library Manager

Such fantastic Development system, severly handicaped by an archaic documentation methodology.

I am using both Linux (Fedora) and Vista. Same problem with both.

Regards
Trevor
Comment 1 Jan Pokorsky 2008-07-28 18:13:56 UTC 
Have you read 'Help->Java Applications->Working With Javadoc Documentation->Adding Javadoc to a Project' and 'Help->Java
Applications->Working With Javadoc Documentation->Adding the JDK Javadoc to the IDE'?
Comment 2 Petr Dvorak 2008-11-25 14:35:18 UTC 
I actually like this enhancement a lot, the key lies in words:

> Either that, or make it an easy feature like adding plugins!

Installing a JavaDoc using one click would be very comfortable  - and I don't think it would be too difficult(?)...

From nbusers (about installing JavaDoc):

> The configuration steps are just futsy perhaps.  It would be nice if
> there was a simple way to go to a platform configuration and say,
> download the JavaDocs for me and install the configuration that NB
> needs to use it.  One click shopping is always a good deal  :-)
Comment 3 fishtoprecords 2009-01-07 21:35:59 UTC 
Yes, please. It has to be much easier. For some reason, every time I install a new version of Netbeans, it stops
working. And since I don't do it often, it takes hours to get it right. The "show javadoc" command is great feature. But
only when its working
Comment 4 Petr Dvorak 2009-01-08 12:12:24 UTC 
OK, I will just write the steps here, so that someone who found this issue because he was looking for "why the hell it
doesn't work" can find the answer (I assume you use JDK6, JDK5 is analogic):

1. Download a ZIP with JavaDoc for JDK6 - start here: http://java.sun.com/javase/downloads/index.jsp and look for "Java
SE 6 Documentation"
2. Start NetBeans IDE
3. Invoke "Tools>Java Platforms", select the JDK 1.6 platform in the left panel
4. Choose "JavaDoc" tab in the right panel
5. Click "Add ZIP/Folder" button and select the just downloaded ZIP file in the open file dialog (confirm OFD)
6. Click "Close" in "Java Platform Manager" dialog

That should be it...
Comment 5 Jan Pokorsky 2009-01-12 13:43:58 UTC 
fishtoprecords: the java platform manager supports auto-detection of existing platform javadoc. You only need to extract
javadoc.zip to ${JAVA_HOME} as described at http://java.sun.com/javase/6/webnotes/install/jdk/install-docs.html.
Comment 6 Jan Becicka 2011-01-13 13:05:33 UTC 
Please follow instructions in help. Sections "Adding Javadoc to a Project" and "Adding the JDK Javadoc to the IDE"
if those instructions does not work, please file a bug.