commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gilles <>
Subject [Math] Javadoc with Java 8 (Was: svn commit: r1591664 [2/2] - ...)
Date Thu, 01 May 2014 20:31:24 GMT

I don't like most of the changes performed on the Javadoc; most of them
are going in the wrong direction IMHO, the most severe being the use of
HTML "entities" rather than using MathJax.[1]

Last time I checked W3C was trying to make HTML a valid XML language;
now from what I read in this commit, Java 8 insists on being invalid
Since when was it decided to comply with Java 8 despite that it does 
seem to be an obvious move?

Until there is agreement on a way out, I think that we should have
followed the route proposed here:
(i.e. disable the enforcement of the new rules).


[1] I stress, again, that IMO Javadoc must mostly be kept readable by

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message