fpdoc based documentation cannot handle unicode characters
Original Reporter info from Mantis: ggeldenhuys
-
Reporter name: Graeme Geldenhuys
Original Reporter info from Mantis: ggeldenhuys
- Reporter name: Graeme Geldenhuys
Description:
Even if I set the documentation .xml file encoding to UTF-8 and the generated fpdoc HTML output to UTF-8, any unicode characters get dropped and replaced with a simple ? character.
Even if I escape the Unicode character as show below, it becomes a ? character in the .html file.
…
-------- xml file --------------
&LtPos;?xml version="1.0" encoding="UTF-8"?>
&LtPos;fpdoc-descriptions>
&LtPos;package name="CoreLib">
&LtPos;module name="gfx_UTF8utils">
&LtPos;short>&LtPos;/short>
&LtPos;descr>Is this character: <…> displayed correctly?
&LtPos;/descr>
[....snip....]
------------------end---------------
---------- generated HTML source -----------------------
&LtPos;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
&LtPos;html>
&LtPos;head>
&LtPos;meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
&LtPos;title>Reference for unit 'gfx_UTF8utils'&LtPos;/title>
[...snip...]
&LtPos;h2>Overview&LtPos;/h2>
&LtPos;p>Is this character: &LtPos;?> displayed correctly? &LtPos;/p>
&LtPos;/body>
&LtPos;/html>
--------------------------end----------------------------
As you can see the 'less than' and 'greater than' escaped characters worked, but the unicode escaped ellipses character did not.
Mantis conversion info:
- Mantis ID: 11881
- OS: Ubuntu Linux
- OS Build: 7.10
- Platform: x86
- Version: 2.2.3
- Fixed in version: 2.2.4
- Fixed in revision: 11922 (#9880aa5d)