Re: Modular Docbook v1.13 bug

[Lionel Mallet <l.mallet@xxxxxxxxxxxxx>]

Hi Norm,

On Thu, 17 Sep 1998 09:31:18 EDT, Norman Walsh <ndw@xxxxxxxxxx>  wrote:
> Odd.  Can you send me the instance that does this?

Attached is a fairly small document that yields this error. I'm sorry it comes after your latest delivery of 1.18.

Maybe the bug is fixed. I'll try 1.18 on Monday.
-- 
Lionel Mallet                           E-mail: l.mallet@xxxxxxxxxxxxx

<!DOCTYPE Reference PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
<reference id="aClass">
  <docinfo>
    <copyright>
      <year>1998</year><holder>The Open Group</holder>
    </copyright>
    <author>
      <firstname>Lionel</firstname><surname>Mallet</surname>
    </author>
    <date>March 1998</date>
  </docinfo>
  <title>#class-fqn#</title>
  <partintro>
    <title>Synopsis</title>
    <synopsis>
      #class-signature#

as &lt;emphasis&gt;#class-modifiers# class&lt;/emphasis&gt; #formatted-class-name#
(with #formatted-class-name# = &lt;type&gt;#class-name#&lt;/type&gt;)
[ &lt;emphasis&gt;extends&lt;/emphasis&gt; #formatted-extended-class-name# ]
[ &lt;emphasis&gt;implements&lt;/emphasis&gt; #formatted-implemented-classes# ]
    </synopsis>

    <para><emphasis>This section may be omitted in the case of ADL/C specifications.</emphasis></para>

    <sect1>
      <title>Description</title>
      <para>#class-description#</para>
    </sect1>

    <sect1>
      <title>See Also</title>
      <para>#see-also#</para>
      <para><emphasis>This section may be omitted when there is no
see-also entity defined</emphasis></para>

      <para><emphasis>This <ulink url="string.html">sample class
documentation</ulink> shows the layout and rendering of this
template.</emphasis></para>
    </sect1>
  </partintro>

<!-- placeholder for constructor/method -->
<!--   #nl-func*# -->

<!-- placeholder for a constructor/method -->
  <refentry id="aClass-mangled-func-signature">
    <refmeta>
      <refentrytitle>#func-signature#</refentrytitle>
    </refmeta>

    <refnamediv>
      <refname>#func--signature#</refname>
      <refpurpose>#func-purpose#</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
      <title>Synopsis</title>
      <blockquote>
	<funcsynopsis>
	  <funcprototype>
 	    <funcdef><function>#func-name#</function></funcdef>
            <paramdef>#param-type# <parameter>#param-name#</parameter></paramdef>
            <paramdef>#param-type# <parameter>#param-name#</parameter></paramdef>
<!-- (with #param-def# = <paramdef>#param-type# <parameter>#param-name#</parameter></paramdef> -->
	  </funcprototype>
	</funcsynopsis>
      </blockquote>
    </refsynopsisdiv>
    <refsect1>
      <title>Description</title>
      <para>#func-desc#</para> 
  <blockquote>
      <programlisting>
#mangled-func-signature# = #func-name#(-[1]#arg-type#)*
</programlisting>
		</blockquote>
    </refsect1>
    <refsect1>
      <title>Parameters</title>
	    <para><emphasis>
when there is no parameter, we only have <literal>&lt;para&gt;&lt;/para&gt;</literal>
or maybe we'd rather avoid that section completely?
</emphasis></para>
      <variablelist>
	<varlistentry>
	  <term><parameter>#param-name#</parameter></term>
	  <listitem>
	    <para>#param-desc#</para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </refsect1>
    <refsect1>
      <title>General Behavior</title>
      <para>#normal#</para>
      <para>#abnormal#</para>
      <para>When the function executes successfully, the following is
      true:</para>
      <itemizedlist>
	<listitem><para>#xlated-assertion#</para></listitem>
	<listitem><para>#xlated-assertion#</para></listitem>
	<listitem><para>#xlated-assertion#</para></listitem>
      </itemizedlist>
    </refsect1>
    <refsect1>
      <title>Errors</title>
      <para>If the function indicates a failure, then one or more of
      the following is true:</para>
      <itemizedlist>
	<listitem><para>#xlated-error#</para></listitem>
	<listitem><para>#xlated-error#</para></listitem>
	<listitem><para>#xlated-error#</para></listitem>
      </itemizedlist>
    </refsect1>
    <refsect1>
      <title>Semantics</title>
      <blockquote>
	<programlisting>#assertions-code#</programlisting>
      </blockquote>
    </refsect1>
  </refentry>
</reference>