[NETBEANS-2101] Can't attach javadoc to jar file (No javadoc for <...>.jar available)

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 9.0
• Component/s: java - Javadoc, platform - Help System, projects - Libraries
• Labels: documentation usability

Environment

From NetBeans About:
Product Version: Apache NetBeans IDE 9.0 (Build incubator-netbeans-release-334-on-20180708)
Java: 10.0.2; Java HotSpot(TM) 64-Bit Server VM 10.0.2+13
Runtime: Java(TM) SE Runtime Environment 10.0.2+13
System: Windows 10 version 10.0 running on amd64; Cp1251; ru_RU (nb)
User directory: C:\Users\Mingun\AppData\Roaming\NetBeans\9.0
Cache directory: C:\Users\Mingun\AppData\Local\NetBeans\Cache\9.0

• Assignee: Unassigned
• Reporter: Mingun
• Created: 09/Feb/19 20:23
• Updated: 09/Feb/19 20:29

Description

I try to study NetBeans and I want to receive JavaDoc for its components. Carrying out the tutorial https://platform.netbeans.org/tutorials/nbm-visual_library3.html, I saw that for modules there is no documentation. Therefore I tried to add it, but at me it did not turn out.

At first I tried to find the plugin with NetBeans API documentation which existed for version 8.x, but it is missing for version 9.0.

Then I tried to load documentation, following by link Attach Javadoc... from the hint and having pressed the button Download. However never downloaded:

Then I tried to attach Javadoc ZIP archive, however I did not find it anywhere on the netbeans site. It in general exists?

Then I tried to attach online documentation, having pressed the button Add URL... and having entered https://bits.netbeans.org/9.0/javadoc/org-netbeans-api-visual. This operation was performed successfully, however documentation to classes did not appear, and moreover, even an opportunity to enter something else was gone from the hint as now the link Attach Javadoc... was gone:

At the same time at the time of a hint popup the following information logged to IDE Log:

WARNING [org.netbeans.modules.java.source.JavadocHelper]: JavadocForBinaryQuery.Result: class org.netbeans.modules.java.j2seplatform.queries.QueriesCache$Javadoc returned non-folder URL: https://bits.netbeans.org/9.0/javadoc/org-netbeans-api-visual, ignoring

So questions:

1. Why it is not possible to load documentation automatically? It in general is possible? From where does it try to be loaded? In IDE Log there is no information on that from where there is an attempt to load it
2. Where to take javadoc archive of NetBeans modules, it is desirable to all in one archive at once? How then to attach it?
3. How to remove the incorrect reference to javadoc? Where to be stored information on allegedly existence of javadoc? Ok, find that. Need to remove file <NetBeans User directory from About>/config/Preferences/org/netbeans/modules/java/j2seplatform/Javadoc.properties and restart IDE
4. What path must be entered in Add URL...?
5. How to open the Select Javadoc (2. Try download.png) window not from the hint?