<Swing Dev> Resend JDK 9 RFR of JDK-8076422: Fix missing doclint warnings in javax.swing.border

Sergey Bylokhov Sergey.Bylokhov at oracle.com
Tue Apr 7 13:10:04 UTC 2015


Hi, Joe.
On 02.04.15 19:07, joe darcy wrote:
>>> +     * Returns the font of the component.
>>> +     * @return the font of the component
>>> +     * @param c the component
>>> +     */
> After a closer look at the code, this javadoc seems to more accurately 
> describe the behavior of the method:
>
> +    /**
> +     * Returns the font of the title (if present), otherwise returns
> +     * the font of the component (if present), otherwise returns a
> +     * plain dialog font.
> +     * @return the font of the title or component or a plain font
> +     * @param c the component
> +     */
>
> How does that sound?
I think this documentation contains too many details of implementation. 
The simple variant is preferable.

>
> Thanks,
>
> -Joe


-- 
Best regards, Sergey.




More information about the swing-dev mailing list