<Swing Dev> RFR: 8264218: Public method javax.swing.JMenu.setComponentOrientation() has no spec [v5]

Thu Apr 8 00:42:16 UTC 2021

On Thu, 8 Apr 2021 00:16:29 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> The behavior is not a javadoc bug. If a method is overridden with no specified change in behavior, the method will be documented in the "Methods Declared In ..." list at the end of the main summary table.

If it is not a bug it is necessary to update the javadoc spec:
https://docs.oracle.com/en/java/javase/16/docs/specs/javadoc/doc-comment-spec.html
It currently states that in such use-case the spec should be copied, and it also states that "{@inheritDoc}" must force the doc to be copied as well.

Anyway this issue can be closed as not a bug.

-------------

PR: https://git.openjdk.java.net/jdk/pull/3213