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

joe darcy joe.darcy at oracle.com
Tue Apr 7 15:51:10 UTC 2015


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?

-Joe




More information about the swing-dev mailing list