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>