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