OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: DOCBOOK: <type> and <link> in <funcsynopsis>


Dear DocBook users:

Consider the following DocBook <funcsynopsis>:

    <funcsynopsis>
      <funcsynopsisinfo>
        #include &lt;Support.h&gt;
      </funcsynopsisinfo>
      <funcprototype>
        <funcdef>
          <link linkend="Const-Text"><type>Const_Text</type></link>
          <function>Status_To_Text</function>
        </funcdef>
        <paramdef>
          <link linkend="Status"><type>Status</type></link>
          <parameter>status</parameter>
        </paramdef>
      </funcprototype>
    </funcsynopsis>

Looks good to me except that Jade gives me errors like

jade:support.sgml:181:19:E: document type does not allow element "TYPE"
here; assuming missing "FUNCTION" start-tag
jade:support.sgml:183:21:E: end tag for "FUNCTION" omitted, but OMITTAG
NO was specified
jade:support.sgml:181:14: start tag was here
jade:support.sgml:185:40:E: document type does not allow element "LINK"
here; missing one of "PARAMETER", "REPLACEABLE", "FUNCPARAMS" start-tag

I consider the exclusion of <link> (and <xref>) and <type> (especially)
in <funcdef> and <paramdef> to be a bug.   A type is almost always the
first part of these elements and sometimes refers to a type definition
in another part of the document.

Thanks,
Eric.



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC