On Thu, 1 Apr 2021 12:42:19 GMT, Alexey Ivanov <aiva...@openjdk.org> wrote:
>> A public overriding method
>> JMenu.setComponentOrientation(java.awt.ComponentOrientation)
>> has no spec.
>> Added spec for the method.
>
> src/java.desktop/share/classes/javax/swing/JMenu.java line 1269:
>
>> 1267: * </ul>
>> 1268: * @see java.awt.ComponentOrientation
>> 1269: */
>
> Shall it just use `{@inheritDoc}`?
> The javadoc generated in 7 and 8 does exactly this.
>
> However, the new text explicitly mentions that this method changes not only
> orientation of this component but also of the associated popup menu.
>
> I do not think the description of the parameter has to list all the values of
> `ComponentOrientation`, these are the only publicly available values any way.
> If a value is added in the future, the javadoc will become incorrect.
It is done similarly in JScrollPane which I used here...maybe there also it's
an oversight then..
I will update to use @inheritdoc in this spec ...
-------------
PR: https://git.openjdk.java.net/jdk/pull/3213
