javadoc style question
Jonathan Gibbons
jonathan.gibbons at oracle.com
Mon Nov 10 17:17:36 UTC 2014
This page is notable for having unusually long text (paragraphs) for
these tags instead of the normally shorter text (phrases). That makes
the different format more than usually obvious.
-- Jon
On 11/10/2014 07:26 AM, Kumar Srinivasan wrote:
> Curiosity question: But why only this specific page ? All other pages
> look ok ?
>
> Kumar
>
>
> On 11/7/2014 2:04 PM, Bhavesh Patel wrote:
>> Yes. It does look different. There is no particular reason for the
>> difference that I can think of. This is a part of the 2 different UI
>> styles that Jeff Hoffman's team designed and was approved by Mark.
>> But I think it should be using the standard serif font. I will file
>> it as a P4 RFE.
>>
>> Regards,
>> Bhavesh.
>>
>> ----- Original Message -----
>> From: jonathan.gibbons at oracle.com
>> To: javadoc-dev at openjdk.java.net
>> Sent: Friday, November 7, 2014 11:01:47 AM GMT -08:00 US/Canada Pacific
>> Subject: javadoc style question
>>
>> Bhavesh,
>>
>> Check out this page:
>> http://docs.oracle.com/javase/8/docs/api/java/lang/reflect/InvocationHandler.html#invoke-java.lang.Object-java.lang.reflect.Method-java.lang.Object:A-
>>
>>
>> Look at the large paragraphs for the Parameters, Returns and Throws
>> sections.
>>
>> Is there are good reason why the paragraph bodies are in monospace
>> format? Would it make more sense to use the standard serif body font
>> here?
>>
>> Is this worth an RFE in JBS?
>>
>> -- Jon
>
More information about the javadoc-dev
mailing list