UTF-8 for documentation

Stephan Kulow coolo at kde.org
Wed Feb 12 12:14:43 GMT 2003


Am Tuesday 11 February 2003 18:21 schrieb Thiago Macieira:
> Hello,
> 
> I have some API documentation that needs some non-Latin1 characters to be 
> displayed. I have decided to use UTF-8 for that. So 
> kdelibs/kdecore/resolver.h should be read in a UTF-8 mode. (see 
> KDE::Network::Resolver class, method normalizeDomain)
> 
> My problem is that the generated Doxygen documentation was Latin 1 only. For 
> the HTML documentation, this can be easily solved with the attached patch. 
> However, questions arise:
> 
> 1) does it break other documentation?
Our code is UTF-8 anyway - even though most don't know about it :)

> 2) how do we do it for other documentation forms (man, TeX, etc.)?
both are basicly us-ascii and can't handle unicode in general. I think we shouldn't
care too much about them. Most of our docs are non-unicode anyway.

> 3) is there a better way?
> 
> If this is the only way, I ask that this patch be committed.

I commit it.

Greetings, Stephan





More information about the kde-core-devel mailing list