This document lists changes made to the NetBeans
JavaHelp module APIs. Please ask on the
mailing list if you have any questions.
Fuller descriptions of all changes can be found below (follow links).
Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.
These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:
OpenIDE-Module-Module-Dependencies: org.netbeans.modules.javahelp/1 > 1.20
HelpUtils; made by: jhavlin; issues: #234144
Provide a method for merging of a custom HelpSet object to the master helpset.
HelpSetRegistration; made by: jglick; issues: #191452
There is a new annotation to make it easier to register help sets.
Modules registering help sets in their XML layers are encouraged to migrate to the new annotation.
<helpsetref> file from your layer, move your help set files
into the project's regular source/resource root, remove
OpenIDE-Module-Requires: org.netbeans.api.javahelp.Help from your module's manifest,
add a direct dependency on this module, and add a
package-info.java with the annotation.
For Ant-based module projects,
javahelp.hs can also be removed from
Object tag can be used in HTML content to show external link in default IDE HTML browser.