RFR [9] 8132877: docs: replace <tt> tags (obsolete in html5) for java.naming

Martin Buchholz martinrb at google.com
Mon Aug 3 18:26:02 UTC 2015

Bhavesh, it would be good if jep 224 said what to do with the many legacy
<tt> tags.  Best practice seems to be to convert to {@code ...} if possible
and appropriate, else to <code>, <kbd>, or <samp>, as given by

On Mon, Aug 3, 2015 at 10:21 AM, Alexander Stepanov <
alexander.v.stepanov at oracle.com> wrote:

> Sorry, at the moment I can say only that  <tt> is deprecated in HTML5:
> http://www.html-5.com/changes/deprecated/
> "Here is a list of deprecated HTML tags to avoid using" - that's was the
> main motivation.
> As I know, in future(?) the documentation should be HTML5-compliant:
> http://openjdk.java.net/jeps/224 (but it is outside of my competence,
> sorry).

More information about the core-libs-dev mailing list