JDK 9 RFR of JDK-8157724: Improve javadoc tag usage in java.math

[joe darcy]

Hi Brian,

We don't apply a policy consistently, but I did another pass on 
BigDecimal and BigInteger to be more consistent:

     http://cr.openjdk.java.net/~darcy/8157724.1

This also includes an additional @jls tag in BigInteger to the 
arithmetic operations in JLS and a @see from BigDecimal's sqrt method to 
the BigInteger method.

Thanks,

-Joe


On 5/24/2016 12:07 PM, Brian Burkhalter wrote:
> Hi Joe,
>
> Yes, that is useful. I had not recalled seeing the emphasis tag before 
> so I was curious as to the policy.
>
> Thanks,
>
> Brian
>
> On May 24, 2016, at 11:59 AM, joe darcy <joe.darcy at oracle.com 
> <mailto:joe.darcy at oracle.com>> wrote:
>>
>> As I understand it, if one is being pedantic about HTML tags, "<em>" 
>> is more of a semantic tag while "<i>" is purely typographical so 
>> there are cases where "<i>" should not be replaced by "<em>".
>>
>> On 5/24/2016 11:44 AM, Brian Burkhalter wrote:
>>>
>>> At new line 1902 and elsewhere, is <em/> preferable to <i/> in 
>>> general? (Not a question pertaining only to this change.)
>