[xml/sgml-pkgs] Bug#327551: xmlto: allow generation in an encoding different from the current locale

[Daniel Leidert]

Hi,

Nicolas François wrote:

> The apt-ftparchive man page is generated from an XML document. To
> translate this document, the French Tranlation Team translated the
> original XML, and then generated the man page from this translated XML
> document.
> 
> This worked nice when the man page was generated by a Franch developer
> (with an fr_FR.ISO-8859-1 locale, I supppose). But the man page of the
> package is not that nice because it was generated by a buildd, with a C
> locale (I suppose): all accents are converted to character entities (e.g.
> é), which renders the man page hardly readable. (see #327456)
> 
> The attached patch adds a --keep-encoding to xmlto, which disables the
> convertion of the XML document to the locale charmap before the xsl
> processing.

I think, your problem can be easily solved by setting the
man.charmap.use.subset parameter to zero, so it replaces all special
characters with their Groff code. See 

/usr/share/doc/docbook-xsl/doc/manpages/man.charmap.use.subset.html

Instead of adding a new switch to the xmlto script, maybe this parameter
should be set to 0 by default in xmlto to avoid such issues.

Regards, Daniel