Re: makeinfo --docbook outputs invalid XML

[Karl Berry]

Hi Simon,

    (after adding a @top to get it compile at all) 

Ah, thanks.  I've fixed this in the manual.

    The problem seems to the <bookinfo> in the "Top" chapter.  

With makeinfo 4.3 (and the current source), there is no second
<bookinfo>, and there is no chapter id="Top" -- I believe Feloy has made
some fixes for this.  You can get the current source from
http://savannah.gnu.org/projects/texinfo.

Is there an easy way to validate a docbook document?

See below for the source and output I tested with.  (I added more text
to the top node to be clear on which output came from which input.)

    I'm not sure why a "Top" chapter would be necessary at all in docbook.

If there's additional text there, it seems like it could be useful.

    If @ifnotdocbook or @ifnotxml existed

Actually, @ifxml and @ifnotxml do exist, although they weren't mentioned
in the `Conventions' node.  I added them there.  I agree that
@if{,not}docbook should exist too, but I don't want to implement that
change right now, since there hasn't been any other need for it.  (And
the whole output structure of makeinfo should be revisited anyway.)

Thanks,
karl


\input texinfo   @c -*-texinfo-*-
@c %**start of header
@setfilename sample.info
@settitle Sample Manual 1.0
@c %**end of header
@copying
This is a short example of a complete Texinfo file, version 1.0.

Copyright @copyright{} 2002 Free Software Foundation, Inc.
@end copying
@titlepage
@title Sample Title

@c The following two commands start the copyright page.
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@c Output the table of contents at the beginning.
@contents

@ifnottex
@node Top
@top Short Sample

This is the top node.
@insertcopying
@end ifnottex

@menu
* First Chapter::    The first chapter is the
                    only chapter in this sample.
* Index::            Complete index.

@end menu

@node First Chapter
@chapter First Chapter

@cindex chapter, first

This is the first chapter.
@cindex index entry, another

Here is a numbered list.

@enumerate
@item
This is the first item.

@item
This is the second item.
@end enumerate

@node Index
@unnumbered Index

@printindex cp

@bye

$ ../src/makeinfo/makeinfo -o - --docbook   shortsample.tex
<!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, version 1.0.
   </para>

   <para>
Copyright &copy; 2002 Free Software Foundation, Inc.
   </para></abstract></bookinfo>
 <chapter id="Top">
  <title>Short Sample</title>
  <para>
This is the top node.

  <abstract>
   <para>
This is a short example of a complete Texinfo file, version 1.0.
   </para>

   <para>
Copyright &copy; 2002 Free Software Foundation, Inc.
  </para>
</chapter>
 <chapter id="First-Chapter">
  <title>First Chapter</title>
  <para><indexterm role="cp"><primary>chapter, first</primary></indexterm>
This is the first chapter.
<indexterm role="cp"><primary>index entry, another</primary></indexterm>
Here is a numbered list.
  </para>
  <orderedlist numeration="arabic">
   <listitem>
    <para>
This is the first item.
    </para>
</listitem>
   <listitem>
    <para>
This is the second item.
    </para></listitem></orderedlist>
</chapter><index id="Index">
  <title>Index</title>
  <indexdiv>
   <title>C</title>
   <indexentry>
    <primaryie>chapter, first, see <xref 
linkend="First-Chapter"></primaryie></indexentry></indexdiv>
  <indexdiv>
   <title>I</title>
   <indexentry>
    <primaryie>index entry, another, see <xref 
linkend="First-Chapter"></primaryie></indexentry></indexdiv></index></book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-indent-step:1
sgml-indent-data:nil
End:
-->