apigen/apigen — Issue #68: Doc Generation breaks with Umlauts/ISO8859-1-files
Author: eth8505
Created: 2011-10-18 19:10:12+00:00
State: open

It seems that generation of docs breaks if I have umlauts (äöü) in the files (at least for me). We're (sadly) still using ISO8859-1 encoded files and have some german legacy doc blocks.

It seems that in ApiGen\Template.php:85 the Texy instance is simply created and then forgotten about, without ever worrying about the encoding of the data, hence when $this->texy-process() calls TexyUtf::toUtf($text, $this->encoding) in texy.php:501 it still uses its internal default source encoding which is utf-8. That makes the iconv() call break since it expects UTF-8 input and gets ISO-8859-1 input.

For now, it does actually help me to get rid of all the bad doc blocks from ages ago, but I thought I'd note it here anyway :)