JDK 9 RFR of JDK-8172475: Remove <tt></tt> usage from Class and ClassLoader

[joe darcy]

Hi Brian,

For my rough methodology, I did a search and replace of "<tt>" with 
"{@code} and "</tt>" with "}" and then ran the docs build fixing issues 
with the {@link} with embedded {@code} until the docs build was 
successful again.

Thanks,

-Joe


On 1/9/2017 5:59 PM, Brian Burkhalter wrote:
> Hi Joe,
>
> I did not read every last line but a quick perusal does not reveal any 
> straggling teletype tags.
>
> Line 1018 of ClassLoader could use a space before the “-1:”
> 1018      *         {@code b.position()} through {@code b.position() + b.limit() -1
> The current copyright year needs to be 2017 (!).
>
> So +1 from me but I hope someone else scans it also.
>
> Brian
>
> On Jan 9, 2017, at 5:45 PM, joe darcy <joe.darcy at oracle.com 
> <mailto:joe.darcy at oracle.com>> wrote:
>
>> The javadoc for java.lang.Class and java.lang.ClassLoader has some 
>> usages of the <tt></tt> HTML tag. This tag is not part of HTML 5 and 
>> has been replaced with <code></code>. In javadoc, direct use of 
>> <tt></tt> or <code></code> is rarely necessary since the {@code } tag 
>> can be used instead. In addition, ClassLoader has multiple extraneous 
>> usage of <tt></tt> inside the target of a {@link} tag; these usages 
>> should be removed.
>>
>> Please review this webrev which addresses those issues:
>>
>>    Webrev:http://cr.openjdk.java.net/~darcy/8172475.0/ 
>> <http://cr.openjdk.java.net/%7Edarcy/8172475.0/>
>