This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
<type> and <link> in <funcsynopsis>
- To: docbook at lists dot oasis-open dot org
- Subject: DOCBOOK: <type> and <link> in <funcsynopsis>
- From: Eric Lemings <elemings at uswest dot net>
- Date: Sun, 26 Mar 2000 09:42:27 -0700
- Reply-To: docbook at lists dot oasis-open dot org
Dear DocBook users:
Consider the following DocBook <funcsynopsis>:
<funcsynopsis>
<funcsynopsisinfo>
#include <Support.h>
</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.