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 229190 - Add "download source" option to "attach javadoc" dialog
Summary: Add "download source" option to "attach javadoc" dialog
Status: RESOLVED WONTFIX
Alias: None
Product: projects
Classification: Unclassified
Component: Maven (show other bugs)
Version: 7.4
Hardware: PC Windows 8 x64
: P3 normal (vote)
Assignee: Tomas Stupka
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-04-30 06:46 UTC by akobberup
Modified: 2016-07-07 08:37 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 akobberup 2013-04-30 06:46:18 UTC 
When writing some code that uses a library that is set up as a dependency via maven, and ctrl+space clicking to show the javadoc, it some times states that javadoc is not fetched.

Then an option is shown to download javadoc - and in some cases this does the trick automatically, however most times it just open a dialog where you can specify the location of the javadoc.

It would be awesome if the dialog also had an option to "get the sources" as doing so also gives the javadoc that were the point of the request.

Currently you have to ctrl click on a class from the library to open the (decompiled)source, and in that view you can click "download source", and then you also have the javadoc.
Comment 1 Milos Kleint 2013-04-30 07:45:32 UTC 
unfortunately the UI to set javadoc is generic (not located in maven sources) and only shows if the background maven check for javadoc download failed for some reason. There is a similar feature for sources generated for .class files. It says "Attach Sources", here again we attempt a background download and if it fails the general UI kicks in.

in maven specific ui, you can right click on Dependencies node to have javadoc/sources downloaded or you can change the global settings to always attempt javadoc/source download on IDE restart.
Comment 2 akobberup 2013-04-30 07:56:35 UTC 
Ah - thanks I had not seen those general settings.

The reason for this report also were that while this way of getting the sources in order to get the javadoc may be easy enough for experienced users, newcommers may not feel the same way. 

I were just thinking if anything should/could be done for those creating for example a new project using hibernate, and while maven gets the hibernate jar files, they are repeatedly asked to supply the javadoc themselves (and that javadoc may not be available as a independent zip file).

I just thought it may make sense to try to help them getting the docs as easy as possible - maby if javadoc download fail, the source should be fetched? That could be an option?.
Comment 3 Martin Balin 2016-07-07 08:37:42 UTC 
This old bug may not be relevant anymore. If you can still reproduce it in 8.2 development builds please reopen this issue.

Thanks for your cooperation,
NetBeans IDE 8.2 Release Boss