commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Luc Maisonobe <Luc.Maison...@free.fr>
Subject Re: [math] UTF-8 characters in javadoc comments
Date Wed, 14 Nov 2012 07:48:13 GMT
Le 14/11/2012 07:53, Sébastien Brisard a écrit :
> Hi,

Hi Sébastien,

> since the pom specifies the encoding of our source files as well as the
> generated HTML files of the Javadoc, it occured to me that it is possible
> to use UTF-8 characters in the Javadoc comments.
> I think using Γ instead of &Gamma;, or ≤ instead of &le; increases
> readability of the source files. However, to the best of my knowledge,
> UTF-8 characters are not used in our source files. Is there a reason for
> this? Do you object to my using these in the Gamma and Beta classes?

I strongly second this idea! UTF-8 is really the way to go and I am not
aware of any system that would not support it by now.
We need however to make sure that the web page we produce[1] is able to
display it correctly, i.e. they must have character encoding set to
UTF-8. From what I recall, there was once a problem with maven generated
sites that were declared latin-1 encoded even if it was not true.

best regards,
Luc

[1] or will produce in our new svnpubsub or CMS, see my other message today

> 
> Best regards,
> Sébastien
> 


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


Mime
View raw message