commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gilles <gil...@harfang.homelinux.org>
Subject Re: [Math] Javadoc with Java 8 (Was: svn commit: r1591664 [2/2] - ...)
Date Thu, 01 May 2014 22:49:53 GMT
On Fri, 02 May 2014 00:23:33 +0200, Emmanuel Bourg wrote:
> Le 01/05/2014 22:49, Thomas Neidhart a écrit :
>
>>  * escape angle brackets (<, >) with the corresponding HTML entities
>
> Actually you only need to escape '<', that may help a bit with the
> readability.

In a context where people are fairly likely write documentation
referring to generics, it's quite short-sighted to impose rules that
lead to e.g. "List&lt;String>"
IMO, that counts as _not_ readable.

Gilles


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message