Re: Problem in the man xml files.

On Sat, 17 Sep 2005, Yuri Kozlov wrote:

> Hello.
> The result of generation
> xsltproc --nonet /host/p3/b/docbook-xsl-1.69.1/manpages/docbook.xsl id.1.xml
> is not correct:
> ..
> .SH "FILES"
> .TP
> \fI/etc/group\fR
> group account information.TP
> \fI/etc/passwd\fR
> user account information.SH "SEE ALSO"
> ..
> This happens in the
>  <refsect1 id='files'>
>    <title>FILES</title>
>    <variablelist>
>      <varlistentry>
>        <term><filename>/etc/group</filename></term>
>        <listitem>group account information</listitem>
>      </varlistentry>
>      <varlistentry>
>        <term><filename>/etc/passwd</filename></term>
>        <listitem>user account information</listitem>
>      </varlistentry>
>    </variablelist>
>  </refsect1>
>
> Contens of the <listitem> must be in a <para> tags:
> <listitem><para>group account information</para></listitem>
>
> I can not found whats a docbook standard said, but its worked.

I know about this. Also I know this workaroud.

This is bug in XML DTD files content or in XSLT sheets. If current shadow 
XML are files incorrect and must have this additional <para></para> it 
must be reported by XML parser (basing on DTD). If XML DTD is correct 
something must be fixed in XSLT sheets first.
I'm still not adding this <para></para> because it will be plain hiding 
some real bug on XML DTD or XSLT sheets side (or even XML parser).
I'm waiting for some neccessary solution on XML/XSLT level.

Anyway using docbook-xsl-1.69.0 generates correct roff files (in sense man
roff syntax). Yes .. worse look&feel but correct syntax :)

kloczek
-- 
-----------------------------------------------------------
*Ludzie nie majÂą problemĂłw, tylko sobie sami je stwarzajÂą*
-----------------------------------------------------------
Tomasz KÂłoczko, sys adm @zie.pg.gda.pl|*e-mail: [email protected]*