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

[joe darcy]

Hi Brian,

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>".

HTH,

-Joe


On 5/24/2016 11:44 AM, Brian Burkhalter wrote:
> Hi Joe,
>
> At new line 1902 and elsewhere, is <em/> preferable to <i/> in 
> general? (Not a question pertaining only to this change.)
>
> +1
>
> Brian
>
> On May 24, 2016, at 11:28 AM, joe darcy <joe.darcy at oracle.com 
> <mailto:joe.darcy at oracle.com>> wrote:
>
>> The javadoc of the java.math package has various locations where the 
>> @jls, @apiNote, etc. javadoc tags could be used. Those tags should be 
>> used as appropriate. Please review the webrev below which makes those 
>> updates along with some typo fixes:
>>
>> http://cr.openjdk.java.net/~darcy/8157724.0/ 
>> <http://cr.openjdk.java.net/%7Edarcy/8157724.0/>
>