Subject: | Wrong entities in Pod::XML output |
It seems that Pod::XML uses standard HTML entities for non-ASCII
characters. This is not correct for XML output, as there are no
entities predefined in XML (except lt,gt,amp and a few others).
There are some solutions for this problem:
* Do not use entities at all, but use characters in the encoding
specified in the XML preamble;
* Define all entities you are using; or
* use numeric entities like Ä or ÿ
I find the last solution the best and easiest.
You can check XML validity with xmllint from libxml2. For example, this
is the output from a Pod containing a lot of german umlauts (The tail +2
is necessary because of a bug reported before):
$ pod2xml < /home/e/eserte/src/bbbike/doc/tests.pod | tail +2 | xmllint
-
-:18: parser error : Entity 'auml' not defined
Progressbar wächst in vernünftigen Schritten.
^
-:18: parser error : Entity 'uuml' not defined
Progressbar wächst in vernünftigen Schritten.
^
-:21: parser error : Entity 'ouml' not defined
Hauptfenster öffnet sich. Das Fenster sollte möglichst
groß sein
^
-:21: parser error : Entity 'ouml' not defined
...
Regards,
Slaven