Picky Parser and Doc Bugs

[Ali Abdin <aliabdin aucegypt edu>]

Okay - while I was debugging gnome-db2html2, I discovered something.
Apparently the parser (from libxml) is VERY picky :) If you find something
like this:
<!DOCTYPE Book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN" [] >

then please change it to the following:
<!DOCTYPE Book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN" []>

(notice the extra space between ']' and '>' at the end)

If you do not do this then xmlSAXUserParseFile returns an integer less than
zero (an error) and thus gnome-db2html2 dies/aborts

DV: Is the parser supposed to be this picky? 
DV: I also get the following: XML-CRITICAL **: SystemLiteral " or ' expected -
I have no idea why this happens - can you fill us in?

Also - for all documentation I get the following:
XML-CRITICAL **: xmlParseExternalID: PUBLIC, no URI
(note: this is a non-fatal error - libxml gracefully handles it)

Should we have the DTD's online with a URI pointing to them? I think we're
supposed to (as specificed in the XML specifications) - so is it valid
Docbook/XML? Shall we add it to the GDP webpage and update the docs?

Another point - XML parser also complains if you have typo mismtaches between
tags - i.e. I found in my doc (glife.sgml) that I opened with <Book> and
closed with </book>. So if you find something like that please correct it
(Note: this is a non-fatal-error - libxml can gracefully handle it)

I found these bugs by turning on 'ERROR_OUTPUT' in gnome-db2html2 :) 

Uggh - also it appears that gnome-db2html2 does not support the 'menuchoice'
or 'guisubmenu' tag - Uggh. I'll look into it.

Regards,
Ali Abdin