Discussion:
nb7: problem with javadoc of a library
mholste
2011-01-12 16:26:33 UTC
Permalink
Hi *,
this seems to be an old and known problem, but nonetheless I couldn't find a solution yet:
I would like to display the javadocs of a library while working with the editor. Ok, my solution is to start the library manager and add the javadocs to the library that is shown here. So far, so good. When working in the editor afterwards and using the library, I see this odd message: 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.
Hm, but I added it in the Library Manager shortly before. I also shut down the IDE and startet it again after adding the javadocs.
Maybe this is important: The javadocs are placed in a zip file...
I am using NB7 on OSX. Does anyone know this problem and maybe even a solution for this? Or does anyone know what I am doing wrong at this point?
Any help is greatly appreciated!
Regards, Michael
Humage
2011-01-12 19:19:12 UTC
Permalink
It might be worth mentioning to make sure that the directory structure in the zip file is correct.
For instance, my Beans Binding library have the following configuration:

Classpath: C:\Program Files\NetBeans 7.0 Beta\java\modules\ext\beansbinding-1.2.1.jar
Sources:
Javadoc: C:\Program Files\NetBeans 7.0 Beta\java\docs\beansbinding-1.2.1-doc.zip

When I use [url=http://www.7-zip.org/]7Zip[url] to explore the zip file noted by the Javadoc entry and I've attached what I found.
If this is not working out, you can always reference an online source of the javadoc for your library. (If it is available), via the 'Add URL...'
Out of curiosity, are you working on a Java Project or a NetBeans Module Project?
If the later, I had to do some funky linking when it came to adding a library to the nbm project. As it would only add libraries as wrapped jar files. When I did that, I had to re-specify where the javadocs were located for that jar.

Hope this helps. Happy Coding
Sizzle




Attachments:
Loading Image...
mholste
2011-01-12 19:52:15 UTC
Permalink
Well, maybe a few words concerning the folders of this library: I downloaded the javadocs seperately, and as I nearly always do this, I use to put the javadocs in a seperate folder that is not linked in any way to the original location of the library. So, is it important now to place the javados in a special relation to the library?
Thx, Michael
Humage
2011-01-12 20:21:27 UTC
Permalink
..is it important now to place the javados in a special relation to the library?
No. Where you store your javadoc files is in no way related to the location that you store your jar files.
When you add a jar file dependency to your project, you're allowed to 'Edit' that entry and specify both the source files (if they exist) and/or the javadoc folder/zip.

As you can see from the attachments, the javadoc is in a completely different place than the source and library files.

Hope this helps.




Attachments:
Loading Image...
Loading Image...

Loading...