Re: Man-pages for the fglrx Debian package

[Daniel Leidert <daniel dot leidert dot spam at gmx dot net>]

Am Samstag, den 19.11.2005, 14:43 +0100 schrieb Flavio Stanchina:
> Daniel Leidert wrote:
> > > Why does xmllint have to download two dozen files from oasis-open.org?
> > Because I wrote that the DTD can be found at there :)
>
> Now I upgraded docbook-xml to version 4.4 and xsltproc finds almost
> everything locally. I commented out xmllint.
>
> > It is only a validator for my usage. So you can comment out the xmllint
> > line. Or I can change to
> >
> > /usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd
> >
> > which is part of docbook-xml. But the location can differ from
> > distribution to distribution. That's the reason for using an online-DTD.
>
> Hm. What about using that path and letting the other distributions fix
> theirs if they really want to use these manpages. ;)

Ok. Done.

> I think I'll do that and build-depend on docbooc-xml >= 4.4.

But there is a little problem. Please have a look at the head of
fglrx.4x.xml. The current stylesheet does not allow the output of one
<term> below another other one in a <varlistentry> without having a
linespace. The only alternative I know is, to make every FSAAMSPosXx and
FSAAMSPosYy an own entry.

> > ATM they are based on the command line output of the apps. I hope, ATI
> > is fine with that and we can extend these man-pages.
>
> I hope too. :)
>
> I'm integrating the man pages with my packages; it's going well, but
> lintian gives me this warning:
>   W: fglrx-driver: manpage-has-errors-from-man \
>     usr/share/man/man4/fglrx.4x.gz /tmp/zmanzYhQYa:44: \
>     warning: can't find numbered character 174
>
> Character 174 is the "registered" symbol. This is an interesting problem:
> apparently, xsltproc is producing ISO 8859-1 encoded man pages, but a few
> lines after the (R) symbol it outputs "&#8482;" for the (TM) symbol.

I think, I will remove these symbols for the moment. It seems, that the
stylesheets do not handle them smoothly.

> How do we tell xsltproc that it needs to output either UTF-8 or US-ASCII
> with "strange" characters removed?
>
> > > Attached is a fix for a couple of typos I spotted.
>
> Note that aticonfig.1x.xml has the same indentation problem in the SEE ALSO
> section.

Thanks. Fixed.

Regards, Daniel