{@inheritDoc} from JDK

I want to use {@inheritDoc} when the superclass comes from the JDK, so I can augment the JDK documentation with my own.  This tag works if the superclass is one of my own, but not if it's in the JDK.  I specified the “-link” option in the Javadoc dialog to point to the online Oracle documentation for the JDK, so links to JDK documentation from my Javadoc work fine, but {@ inheritDoc} does nothing because (I guess) it actually needs the superclass source code, not just its Javadoc.  My JDK installation has the src.zip file, which I unzipped, but that doesn't help.

In the Javadoc dialog, I tried specifying a -source option in the command line to point to the unzipped JDK source directory, but this fails with an error message saying that I have more than one -source option.  I guess that's because IntelliJ puts such an option in the temp file it creates for javadoc.  I’m sure I could fix this if I could get hold of this temp file and edit it, but it exists only fleetingly for the duration of the javadoc command.

The only workaround I can think of is to add the entire JDK source as a module to my project, but that seems like overkill.

1 comment
Comment actions Permalink

Morrie, that is indeed not possible now. Please vote for http://youtrack.jetbrains.net/issue/IDEA-78788
Thank you


Please sign in to leave a comment.