<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 16:06:07 UTC 2015


On 07.04.15 18:51, joe darcy wrote:
> Hello Sergey,
>
> On 4/7/2015 6:10 AM, Sergey Bylokhov wrote:
>> 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.
>>
>>
>
> So
>
>     "Returns the title font of the component"
>
> for the main text?
"Returns default font of the titled border", because titled border it is 
not a component.
>
> -Joe
>


-- 
Best regards, Sergey.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/swing-dev/attachments/20150407/7ce0788e/attachment.html>


More information about the swing-dev mailing list