GNOME Bugzilla – Bug 406816
more docs validation errors
Last modified: 2007-04-26 21:20:11 UTC
I've ported the remaining manuals to gdu for bug 398471, but they don't validate so make distcheck doesn't pass. The errors are (note that line numbers may be off a few lines, since I had to add <abstract> elements to make the docs even build; see the patch in bug 398471). blackjack: ./C/blackjack.xml:102: element revnumber: validity error : Element application is not declared in revnumber list of possible children ./C/blackjack.xml:113: element releaseinfo: validity error : Element application is not declared in releaseinfo list of possible children ./C/blackjack.xml:302: element guimenuitem: validity error : Element application is not declared in guimenuitem list of possible children gnome-sudoko is a mess: ./C/gnome-sudoku.xml:24: element article: validity error : Element article content does not follow the DTD, expecting ((title , subtitle? , titleabbrev?)? , ar ticleinfo? , tocchap? , lot* , (((calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | caution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaob ject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | msgset | procedure | sidebar | qandaset | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+ , (sect1* | refentry* | simplesect* | sec tion*)) | sect1+ | refentry+ | simplesect+ | section+) , ((toc | lot | index | glossary | bibliography) | appendix | ackno)*), got (articleinfo indexterm index term sect1 sect1 sect1 sect1 sect1 sect1 CDATA sect1 ) ./C/gnome-sudoku.xml:30: element abstract: validity error : Element abstract content does not follow the DTD, expecting (title? , (formalpara | para | simpara) +), got (CDATA) ./C/gnome-sudoku.xml:238: element sect1: validity error : Element sect1 content does not follow the DTD, expecting (sect1info? , (title , subtitle? , titleabbr ev?) , (toc | lot | index | glossary | bibliography)* , (((calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | c aution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcs ynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | blockquote | grap hic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | msg set | procedure | sidebar | qandaset | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+ , (refentry* | s ect2* | simplesect*)) | refentry+ | sect2+ | simplesect+) , (toc | lot | index | glossary | bibliography)*), got (title para para variablelist note sect3 ) ./C/gnome-sudoku.xml:314: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:314: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:322: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:322: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:339: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:356: element listitem: validity error : Element listitem content does not follow the DTD, expecting (calloutlist | glosslist | itemizedlis t | orderedlist | segmentedlist | simplelist | variablelist | caution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynop sis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfig ure | informaltable | equation | example | figure | table | msgset | procedure | sidebar | qandaset | anchor | bridgehead | remark | highlights | abstract | au thorblurb | epigraph | indexterm | beginpage)+, got (CDATA) ./C/gnome-sudoku.xml:357: element listitem: validity error : Element listitem content does not follow the DTD, expecting (calloutlist | glosslist | itemizedlis t | orderedlist | segmentedlist | simplelist | variablelist | caution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynop sis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfig ure | informaltable | equation | example | figure | table | msgset | procedure | sidebar | qandaset | anchor | bridgehead | remark | highlights | abstract | au thorblurb | epigraph | indexterm | beginpage)+, got (CDATA keycap) ./C/gnome-sudoku.xml:361: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:369: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:369: element para: validity error : Element term is not declared in para list of possible children ./C/gnome-sudoku.xml:457: element listitem: validity error : Element listitem content does not follow the DTD, expecting (calloutlist | glosslist | itemizedlis t | orderedlist | segmentedlist | simplelist | variablelist | caution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynop sis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfig ure | informaltable | equation | example | figure | table | msgset | procedure | sidebar | qandaset | anchor | bridgehead | remark | highlights | abstract | au thorblurb | epigraph | indexterm | beginpage)+, got (CDATA guibutton) ./C/gnome-sudoku.xml:458: element listitem: validity error : Element listitem content does not follow the DTD, expecting (calloutlist | glosslist | itemizedlis t | orderedlist | segmentedlist | simplelist | variablelist | caution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynop sis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfig ure | informaltable | equation | example | figure | table | msgset | procedure | sidebar | qandaset | anchor | bridgehead | remark | highlights | abstract | au thorblurb | epigraph | indexterm | beginpage)+, got (menuchoice) gnomine: ./C/gnomine.xml:136: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:153: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:172: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:246: element tip: validity error : Element tip content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | o rderedlist | segmentedlist | simplelist | variablelist | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsyn opsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | bloc kquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | procedure | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA) ./C/gnomine.xml:262: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:283: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata ) ./C/gnomine.xml:301: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:350: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:356: element tip: validity error : Element tip content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | o rderedlist | segmentedlist | simplelist | variablelist | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsyn opsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | bloc kquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | procedure | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA) ./C/gnomine.xml:410: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:411: element imagedata: validity error : Value "png" for attribute format of imagedata is not among the enumerated set ./C/gnomine.xml:422: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:423: element imagedata: validity error : Value "png" for attribute format of imagedata is not among the enumerated set ./C/gnomine.xml:433: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:434: element imagedata: validity error : Value "png" for attribute format of imagedata is not among the enumerated set ./C/gnomine.xml:470: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:471: element imagedata: validity error : Value "png" for attribute format of imagedata is not among the enumerated set ./C/gnomine.xml:481: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:482: element imagedata: validity error : Value "png" for attribute format of imagedata is not among the enumerated set ./C/gnomine.xml:510: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | prog ramlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalf igure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (imagedata title ) ./C/gnomine.xml:511: element imagedata: validity error : Value "png" for attribute format of imagedata is not among the enumerated set gtali: ./C/gtali.xml:289: element varlistentry: validity error : Element varlistentry content does not follow the DTD, expecting (term+ , listitem), got (para ) ./C/gtali.xml:332: element note: validity error : Element note content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | o rderedlist | segmentedlist | simplelist | variablelist | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsyn opsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | bloc kquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | procedure | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA) ./C/gtali.xml:336: element glossentry: validity error : Syntax of value for attribute id of glossentry is not valid ./C/gtali.xml:342: element glossentry: validity error : Syntax of value for attribute id of glossentry is not valid mahjongg: ./C/mahjongg.xml:526: element para: validity error : Element shortcut is not declared in para list of possible children ./C/mahjongg.xml:618: element link: validity error : IDREF attribute linkend references an unknown ID "info-fig2"
Created attachment 84725 [details] [review] Patch for valid DocBook in blackjack.xml Here is a patch to make blackjack.xml validate. I also removed some additional application tags (not necessary because &app; was already defined with <application>Blackjack</application>).
Created attachment 84784 [details] [review] Patch for valid DocBook in gnome-sudoku.xml I replaced some misplaced <term> by <firstterm>, but I'm not sure what the idea was using <term> in this context.
Created attachment 84788 [details] [review] Patch for valid DocBook in gnomine.xml I had to put title above images to validate. A build time directive is applicable to get this effect (titles under images: figure.title.top=0), but I don't know if the gnome-doc-utils stuff allows for this sort of per manual tweaking...
Created attachment 84793 [details] [review] Patch for valid DocBook in gtali.xml
Created attachment 84794 [details] [review] Patch for valid DocBook in mahjongg.xml And finally, this one for mahjongg manual. The info-fig2 figure doesn't exist (any more?). I simply removed the reference. Hope this helps.