missing ERRORS

Bert Vermeulen <[email protected]> Wed, 19 Jan 2005 16:55:07 +0100
Newsgroups gmane.text.docbook.docbook2x.general
Message-ID <[email protected]>
Hi,

I'm having some problems with docbook2x "disappearing" the ERRORS
section of manpages. Here's a sample:

The definition of the error codes:
-------------------------------------------
<refentry id="libssh2errorcodes">
[...refmeta section...]

<formalpara>
<title>Error codes</title>
<para>
<variablelist>

<varlistentry id="libssh2errorsocketnone">
    <term><errorname>LIBSSH2_ERROR_SOCKET_NONE</errorname></term>
    <listitem><para><errortext>The socket is
invalid.</errortext></para></listitem>
</varlistentry>

[...more varlistentries...]

</variablelist>
</para>
</formalpara>
</refentry>
-------------------------------------------

Using an error code:
-------------------------------------------
<refsect1>
<title>Errors</title>
<para>
<itemizedlist>
<listitem><para><link
linkend="libssh2erroralloc">LIBSSH2_ERROR_ALLOC</link></para></listitem><listitem><para><link linkend="libssh2errorsocketsend">LIBSSH2_ERROR_SOCKET_SEND</link></para></listitem><listitem><para><link linkend="libssh2errorsockettimeout">LIBSSH2_ERROR_SOCKET_TIMEOUT</link></para></listitem><listitem><para><link linkend="libssh2errorsftpprotocol">LIBSSH2_ERROR_SFTP_PROTOCOL</link></para></listitem></itemizedlist>
</para>
</refsect1>
-------------------------------------------


The problem is, docbook2x-man generates an empty bullet for each of the
error codes. Here's a generated man page:
-------------------------------------------
.SH ERRORS
.TP 0.2i
\(bu
.TP 0.2i
\(bu
.TP 0.2i
\(bu
.TP 0.2i
\(bu
.PP
-------------------------------------------

So it looks like docbook2x-man is ignoring the definitions, somehow. Any
ideas on what may cause this?

Incidentally, it appears the "errortext" element is not supported. This
is a docbook 4.2 feature, so I assume the package just doesn't support
that version of the docbook spec yet. I've attached a small patch to
this mail which adds this element in (processing the above without the
patch makes docbook2x bomb out, otherwise).


-- 
Bert Vermeulen
sip    |
email  | [email protected]
jabber |
docbook2x-errortext (text/plain, 383 B)
--- inline.xsl.orig	2005-01-19 15:25:38.000000000 +0100
+++ inline.xsl	2005-01-19 15:26:00.000000000 +0100
@@ -160,6 +160,10 @@
   <xsl:call-template name="inline-plain"/>
 </xsl:template>
 
+<xsl:template match="errortext">
+  <xsl:call-template name="inline-plain"/>
+</xsl:template>
+
 <xsl:template match="errortype">
   <xsl:call-template name="inline-plain"/>
 </xsl:template>