GNOME Bugzilla – Bug 404020
docs don't validate
Last modified: 2007-02-10 11:49:37 UTC
I'm trying to migrate gnome-games to gdu, but the docs don't validate which causes distcheck to fail. Here are the ones I've tried so far: glines: make check xmllint --noout --noent --path C:./C --xinclude --postvalid ./C/glines.xml ./C/glines.xml:174: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (screenshot title ) ./C/glines.xml:193: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (screenshot title ) ./C/glines.xml:236: element table: validity error : Element table content does not follow the DTD, expecting ((title , titleabbrev?) , indexterm* , (graphic+ | mediaobject+ | tgroup+)), got (tgroup title ) ./C/glines.xml:314: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (mediaobject title ) ./C/glines.xml:334: element table: validity error : Element table content does not follow the DTD, expecting ((title , titleabbrev?) , indexterm* , (graphic+ | mediaobject+ | tgroup+)), got (tgroup title ) Document ./C/glines.xml does not validate and also: db2omf: Could not construct the OMF maintainer element. Add an author, corpauthor, editor, othercredit, or publisher element with the role attribute set to "maintainer" to glines.xml. --- for same-gnome: xmllint --noout --noent --path C:./C --xinclude --postvalid ./C/same-gnome.xml ./C/same-gnome.xml:76: element revdescription: validity error : Element revdescription content does not follow the DTD, expecting (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 | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | procedure | anchor | bridgehead | remark | highlights | indexterm)+, got (para para revremark ) ./C/same-gnome.xml:107: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (screenshot title ) ./C/same-gnome.xml:120: element figure: validity error : Element figure content does not follow the DTD, expecting ((title , titleabbrev?) , (literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (screenshot title ) ./C/same-gnome.xml:132: element table: validity error : Element table content does not follow the DTD, expecting ((title , titleabbrev?) , indexterm* , (graphic+ | mediaobject+ | tgroup+)), got (tgroup ) ./C/same-gnome.xml:132: element table: validity error : No declaration for attribute align of element table ./C/same-gnome.xml:148: element inlineequation: validity error : Element inlineequation content does not follow the DTD, expecting (alt? , (graphic+ | inlinemediaobject+)), got (CDATA) ./C/same-gnome.xml:148: element inlineequation: validity error : Element inlineequation content does not follow the DTD, expecting (alt? , (graphic+ | inlinemediaobject+)), got (CDATA superscript) Document ./C/same-gnome.xml does not validate and db2omf: Could not construct the OMF maintainer element. Add an author, corpauthor, editor, othercredit, or publisher element with the role attribute set to "maintainer" to same-gnome.xml. --- for gnect: xmllint --noout --noent --path C:./C --xinclude --postvalid ./C/gnect.xml ./C/gnect.xml:314: element menuchoice: validity error : Element menuchoice content does not follow the DTD, expecting (shortcut? , (guibutton | guiicon | guilabel | guimenu | guimenuitem | guisubmenu | interface)+), got (shortcut guimenuitem CDATA) Document ./C/gnect.xml does not validate and db2omf: Could not construct the OMF maintainer element. Add an author, corpauthor, editor, othercredit, or publisher element with the role attribute set to "maintainer" to gnect.xml. as well as problems with the mdash and hellip entities.
Done glines: the titles for all the screenshots, tables etc were in the wrong place. 2007-02-04 Joachim Noreiko <jnoreiko@yahoo.com> * C/glines.xml: fixed validation errors. #404020 added "maintainer" role to the publisher removed version number from title * ChangeLog: Added in anticipation of conversion to gnome-doc-utils
Done same-gnome. Same thing -- added a ChangeLog.
I've done gnect up to a point -- the mdash and hellip depend on bug 403950. Though I really would recommend killing the entire section '2.2. Menus'. A tedious tour through the menus is completely pointless. That would solve the immediate problem, as the mdashes occur only there. As for the hellip, I'm pretty sure that the Style Guide says that an ellipsis on a menu command should not be included when referring to it.
2007-02-10 Joachim Noreiko <jnoreiko@yahoo.com> * C/gnect.xml: removed mostly pointless Menus section; replaced with short section describing useful commands. This removes XML entities, fixing #404020 Closing as fixed. Reopen if I've missed anything :)