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

[Kevin Rushforth]

On Thu, 1 Apr 2021 12:41:14 GMT, Prasanta Sadhukhan <psadhukhan at openjdk.org> wrote:

>> The method is also present in the Java 8:
>> https://docs.oracle.com/javase/8/docs/api/javax/swing/JMenu.html#setComponentOrientation-java.awt.ComponentOrientation-
>
> I guess openjdk shows file history from 7u23 onwards IIRC so not sure why it is showing "Initial load" and not who/what removed it. Maybe the spec wordings actually was not there but some javadoc trickery was adding the javadoc comment in to the spec document seeing it's overidden from JComponent....
> I am not sure what needs to be done here...

The `javadoc` tool (or the standard doclet) used to automatically copy the description from the superclass, and it seems that it no longer does. Perhaps @jonathan-gibbons could comment on this change?

@prsadhuk You could always add `@inheritDoc` like this:

/**
 * {@inheritDoc}
 */

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

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