So, I downloaded the NetBeans sources from Mercurial and registered the main folder containing them like this, in the NetBeans Platform Manager:
That enabled me to use the "@inheritDoc" attribute, which works in the code completion, as you can see here:
However, when I create the Javadoc, via "Generate Javadoc" on the module, the inherited Javadoc is ignored. I.e., it isn't shown. Probably because it isn't found? And even though I have set "nbplatform.default.javadoc" in the build.properties file. And the "NetBeans API Documentation" module is installed.
PS: From the mailing list today, by Florian Brunner, this does a good job of getting the links to work correctly, though the "@inheritDoc" attribute is still not resolved.
<target name="javadoc" depends="build-init,-javadoc-init">
PS to my previous PS: If you change the sourcepath in the target above, to include the sources that should have their Javadoc inherited, such as here...
...then you will have the result you required at the start of this blog entry: