Re: makeinfo --docbook outputs invalid XML

[Simon Josefsson]

Some further details on the problem below.

Using sample.texi from the "Short sample" node in the texinfo
documentation (after adding a @top to get it compile at all) the
following XML output is generated:

<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<book lang="en">
 <title>Sample Manual 1.0</title>
 <bookinfo>
  <abstract>
   <para>
This is a short example of a complete Texinfo file.
   </para>
   <para>
Copyright (C) 2002 Free Software Foundation, Inc.

   </para>
   <para>

   </para></abstract></bookinfo>
 <chapter id="Top">
  <title>sample</title>
 <bookinfo>
  <abstract>
   <para>
This is a short example of a complete Texinfo file.
   </para>
   <para>
Copyright (C) 2002 Free Software Foundation, Inc.
</chapter>
 <chapter id="First-Chapter">
  <title>First Chapter</title>
...

The problem seems to the <bookinfo> in the "Top" chapter.  I'm not
sure why a "Top" chapter would be necessary at all in docbook.
Removing this chapter makes the docbook tools accept it correctly.

If @ifnotdocbook or @ifnotxml existed, it would be easy to solve this
in the texi file, but right now it seems impossible to generate
correct Docbook files.

IMHO the best would be if @ifnotdocbook and @ifnotxml were added, and
makeinfo were made to not generate the top chapter as well.

Simon Josefsson <address@hidden> writes:

> Using sample.texi file from the Texinfo manual works badly with
> makeinfo --docbook.  After lots of manual editing of the XML file I
> got something that compiled, but I guess this should ideally be fixed
> in makeinfo (I think it is a makeinfo bug, not a sample.texi bug).
>
> Or are my docbook tools too old?  Texinfo is 4.2.
>
> bash-2.05b$ makeinfo --docbook sample.texi
> bash-2.05b$ docbook2pdf sample.xml
> Using catalogs: /etc/sgml/catalog
> Using stylesheet: /usr/share/sgml/docbook/utils-0.6.11/docbook-utils.dsl#print
> Working on: /home/jas/src/libgsasl/doc/sample.xml
> jade:/home/jas/src/libgsasl/doc/sample.xml:14:14:E: document type does not 
> allow element "BLOCKQUOTE" here; assuming missing "PARA" start-tag
> jade:/home/jas/src/libgsasl/doc/sample.xml:38:10:E: document type does not 
> allow element "BOOKINFO" here
> jade:/home/jas/src/libgsasl/doc/sample.xml:48:14:E: document type does not 
> allow element "BLOCKQUOTE" here; assuming missing "PARA" start-tag
> jade:/home/jas/src/libgsasl/doc/sample.xml:66:9:E: end tag for "ABSTRACT" 
> omitted, but its declaration does not permit this
> jade:/home/jas/src/libgsasl/doc/sample.xml:39:2: start tag was here
> jade:/home/jas/src/libgsasl/doc/sample.xml:66:9:E: end tag for "BOOKINFO" 
> omitted, but its declaration does not permit this
> jade:/home/jas/src/libgsasl/doc/sample.xml:38:1: start tag was here
> jade:/home/jas/src/libgsasl/doc/sample.xml:66:9:E: end tag for "CHAPTER" 
> which is not finished
> bash-2.05b$ docbook2pdf --version
> DocBook-utils version 0.6.11 (jw version 1.1)
> bash-2.05b$