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.
Created attachment 102703 [details] API, processor, usage in dbschema module; apichanges & apisupport wiz TBD It is possible to register JavaHelp help sets in the Platform's expected location, and also run the JH search database indexer, from an annotation processor with no special support from the build system. (Unlike the current JH indexing support in the Ant harness and nbm-maven-plugin, no particular package location is assumed.) In the future this could also run various build-time validation steps as in the current CheckHelpSets - checking that XML metadata files (besides the help set master) are well-formed, even checking for broken links in HTML. The annotation should be placed on package-info.java, conventionally in the same package as the help set master file itself. The help set must be available in the sourcepath for inspection, so I am just moving the help files into the regular source tree (or for Maven it could be src/main/resources). The result is packed into the regular module JAR; there is no need for a separate docs/*.jar Class-Path extension. The patch leaves the current JHIndexer task and associated harness infrastructure intact for compatibility reasons.
Adding others to CC who have done changes to help sets in the past few months.
Jesse, are there any actions or implications for help writers in relation to this patch? Should we do anything differently? Sorry, as I do not understand how it relates to writers.
(In reply to comment #2) > are there any actions or implications for help writers in relation to this > patch? Should we do anything differently? I *think* the only implication is that help files would be in some subtree of src/, rather than javahelp/ as now, for modules making use of the annotation. I CC'd some help writers in case you can think of any particular objection to such a move - e.g. processes in use during help set authoring (beyond building the module and viewing the help set via Help > Contents) which would be broken by the new location. One minor enhancement to the annotation (and processor) which may be needed that I forgot to include in the patch so far: /** * Helpset-relative HTML filenames to exclude from indexing. */ String[] excludes() default {"credits.html"}; For some reason, every helpset seems to include a file by this name with legal junk in it, but it should not pop up in search results.
apisupport wiz can be done separately. core-main #7b11ce519c8c
(In reply to comment #4) > apisupport wiz can be done separately. core-main #d9ff8f1708d9
Integrated into 'main-golden', will be available in build *201011100000* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress) Changeset: http://hg.netbeans.org/main/rev/7b11ce519c8c User: Jesse Glick <jglick@netbeans.org> Log: #191452: @HelpSetRegistration.