Re: [PATCH] makeinfo's DocBook abstract (Was: index output)

[José Fonseca]

Philippe,

On Fri, Nov 08, 2002 at 08:53:23AM +0100, address@hidden wrote:
> En réponse à José Fonseca <address@hidden>:
> > 
> > The fact is that at this point only 4 out of 37 texinfo generated XML
> > docbooks (including huge stuff such as glibc and gcc) have bad XML
> > syntax.
> > 
> 
> I'm very glad to see that the Docbook output has such a success. Could you 
> give
> me the names of these 4 manuals? I'll try to have a look at the problems 
> causing
> the bad XML syntax.
> 

Below are all problems the problems I ran into when converting every texinfo
manual I have in my tree.


cvs.xml:15336: error: Unexpected end tag : para
cvs.xml:16727: error: Opening and ending tag mismatch: index and para

The problem is that around line 15336 there are extra PARA tags:

  </para>
</appendix> </para>
            ^^^^^^^
 <index id="Index">
  <title>Index</title>
  <para><indexterm role="cp"><primary>Index</primary></indexterm>
  ^^^^^^

g77.xml:21882: error: AttValue: ' expected
g77.xml:21883: error: Unexpected end tag : listitem
g77.xml:21886: error: AttValue: ' expected
g77.xml:21887: error: Unexpected end tag : listitem

The problem is some incomplete XREF tags:

      <para><xref linkend="<listitem>CYCLE-and-EXIT">.
                           ^
      </para></listitem></varlistentry>


gnat_ug.xml:10205: error: Opening and ending tag mismatch: para and command
gnat_ug.xml:10206: error: Unexpected end tag : command
...

The problem is some misplaced COMMAND tags:

    <para>
The Project Manager is invoked through the <command>-P     </para>
                                           ^^^^^^^^^
     <replaceable>projectfile</replaceable></command>
                                           ^^^^^^^^^^
    <para>

sed.xml:786: error: error parsing attribute name
sed.xml:786: error: docbParseStartTag: problem parsing attributes
sed.xml:786: error: Couldn't find end of Start Tag sect1
...

The problem is that a generated ID has unescaped quotes inside it:

  <sect1 id="The-"s"-Command">
                 ^^^

I think the solution shouldn't be escaping the quotes but eliminating them
completely, otherwise XSL stylesheets that use the IDs for things such as
filenames will break.


tar.xml:608: error: Unexpected end tag : para
...

The problem is that makeinfo forgets the values of several variables:

    </para>
{No value for `
    &lt;para>
op-verbose'} shows details about the results of running
^^^^^^^^^^

This only happens when generating plain XML or Docbook but not when generating
info files.


You can get the texinfo documents, the generated xml from 
http://mefriss1.swan.ac.uk/~jfonseca/devhelp/source/gnu/ . The versions of the
used packages are specified in the Makefile of each directory (e.g.
http://mefriss1.swan.ac.uk/~jfonseca/devhelp/source/gnu/cvs/Makefile .)


> In the other hand, the Docbook output lacks some important features, 
> principally
> the definition commands (@deffn and such). Did you find some manuals using 
> these
> constructs?

Perhaps the last problem above [with tar] is related with that.


Regards,

José Fonseca
__________________________________________________
Do You Yahoo!?
Everything you'll ever need on one web page
from News and Sport to Email and Music Charts
http://uk.my.yahoo.com