Ah, I see. Thanks for the info! -Kishor
From: Jonathan Gibbons [mailto:[email protected]] Sent: Friday, April 26, 2019 4:46 PM To: [email protected]; Kharbas, Kishor <[email protected]> Subject: Re: Question about @inheritDoc Kharbas, This looks like an instance of a recent change to javadoc to not repeat the documentation when it would be an exact copy of the inherited documentation. The change was made to avoid methods being spuriously documented when the method is overridden to provide a different implementation without changing the specification. If you modify the doc comment to include more text than just `{@inheritDoc}, you should see the modified documentation appearing in your generated docs. If you want the old behavior, use the following option, listed in the command line help --override-methods (detail|summary) Document overridden methods in the detail or summary sections -- Jon On 04/26/2019 04:36 PM, Kharbas, Kishor wrote: Hi! I am working on the panama project in OpenJDK where I have used @inheritDoc for the overridden methods. The generated Javadoc although does not inherit the Javadoc from superclass method. An example is, add(Vector<Integer> v) in http://hg.openjdk.java.net/panama/dev/file/54c20dc2769a/src/jdk.incubator.vector/share/classes/jdk/incubator/vector/IntVector.java line 467 overriding add(Vector<E> v) in http://hg.openjdk.java.net/panama/dev/file/54c20dc2769a/src/jdk.incubator.vector/share/classes/jdk/incubator/vector/Vector.java line 317 You can see the generated Javadoc at http://cr.openjdk.java.net/~kkharbas/vector-api/javadoc/VectorApi-JavaDoc.05/jdk.incubator.vector/jdk/incubator/vector/package-summary.html<http://cr.openjdk.java.net/%7Ekkharbas/vector-api/javadoc/VectorApi-JavaDoc.05/jdk.incubator.vector/jdk/incubator/vector/package-summary.html> Am I missing something? Any option that needs to be used while Javadoc generation? Thanks, Kishor
