Documentation errors against docbook 4.3 dtd

[colivier]

cd docs
make check

installation.xml:279: element command: validity error : Element emphasis is not declared in command list of possible children
                  <term><command>--prefix=<emphasis>PREFIX</emphasis></command></term>
                                                                               ^
installation.xml:301: element command: validity error : Element emphasis is not declared in command list of possible children
                  <term><command>--with-pgconfig=<emphasis>FILE</emphasis></command></term>
                                                                                    ^
installation.xml:315: element command: validity error : Element emphasis is not declared in command list of possible children
                  <term><command>--with-geosconfig=<emphasis>FILE</emphasis></command></term>
                                                                                      ^
installation.xml:329: element command: validity error : Element emphasis is not declared in command list of possible children
                  <term><command>--with-projdir=<emphasis>DIR</emphasis></command></term>
                                                                                  ^
using_postgis_dataman.xml:368: element listitem: validity error : Element listitem 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 | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+, got (CDATA)
he best solution, in terms of performance and functionality available.</listitem


...

[colivier]

Fix as r5466 (lot of small changes)

I keep this ticket open till Regina and/or Kevin could have a look on the resulted doc.

[kneufeld]

This seem OK to me. Good work Olivier. Good thought with the xml validator make check rule you added.

[colivier]

installation.xml:11: element note: validity error : Element note content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | 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 | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA)
 support is currently optional, but in final release it will be required.</note>
                                                                               ^
using_postgis_dataman.xml:143: element listitem: validity error : Element listitem 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 | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+, got (CDATA para )
		</listitem>
		           ^
using_postgis_dataman.xml:147: element listitem: validity error : Element listitem 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 | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+, got (CDATA para )
		</listitem>
		           ^
using_postgis_dataman.xml:152: element listitem: validity error : Element listitem 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 | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+, got (CDATA para )
		</listitem>
		           ^
reference_accessor.xml:783: element listitem: validity error : Element listitem 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 | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+, got (CDATA)
                    <listitem>GEOMETRYCOLLECTION</listitem>
                                                           ^
reference_accessor.xml:784: element listitem: validity error : Element listitem 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 | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+, got (CDATA)
               <listitem>MULTI{POINT,POLYGON,LINESTRING,CURVE,SURFACE}</listitem
                                                                               ^
reference_accessor.xml:785: element listitem: validity error : Element listitem 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 | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+, got (CDATA)
                    <listitem>COMPOUNDCURVE</listitem>
                                                      ^
reference_accessor.xml:793: element note: validity error : Element note content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | 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 | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA varname CDATA)
                </note>
                       ^
reference_processing.xml:2253: element entry: validity error : Element informalfigure is not declared in entry list of possible children
					</entry>
					        ^
reference_processing.xml:2263: element entry: validity error : Element informalfigure is not declared in entry list of possible children
					</entry>
					        ^
reference_processing.xml:2306: element entry: validity error : Element informalfigure is not declared in entry list of possible children
					</entry>
					        ^
reference_processing.xml:2316: element entry: validity error : Element informalfigure is not declared in entry list of possible children
					</entry>
					        ^
reference_raster.xml:374: element refentry: validity error : Syntax of value for attribute id of refentry is not valid
	<refentry id="RT_PostGIS_Raster_Lib_Build_Date()">
	                                                 ^
reference_raster.xml:531: element ulink: validity error : No declaration for attribute href of element ulink
rmat as commonly seen in a <ulink href="http://en.wikipedia.org/wiki/World_file"
                                                                               ^
reference_raster.xml:531: element ulink: validity error : Element ulink does not carry attribute url
en in a <ulink href="http://en.wikipedia.org/wiki/World_file">world file</ulink>
                                                                               ^
reference_raster.xml:816: element note: validity error : Element note content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | 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 | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA)
n error will be raised if you give just the x column for a skewed raster.</note>
                                                                               ^
reference_raster.xml:890: element note: validity error : Element note content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | 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 | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA)
		An error will be raised if you give just the y row for a skewed raster.</note>
		                                                                             ^
reference_raster.xml:1385: element note: validity error : Element note content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | 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 | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA)
				</note>
				       ^
reference_raster.xml:2414: element note: validity error : Element note content does not follow the DTD, expecting (title? , (calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | 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 | sidebar | anchor | bridgehead | remark | indexterm | beginpage)+), got (CDATA)
					different from ST_ConvexHull which does not floor.</note>
					                                                         ^
faq_raster.xml:229: element xref: validity error : Element xref was declared EMPTY this one has content
r to the list of <xref linkend="RT_reference">documented raster functions</xref>

[kneufeld]

I update Docbook to 4.5 (from 4.3) and MathML to 2.0 (from 1.1Rc1) r6165

This seems to solve all of these errors (at least on the buildbot machine we are using to generate the docs. Make check now doesn't complain at all.

Olivier, can you verify?

[robe]

FWIW my make comments gives mathml errors, but I've been ignoring them since they haven't affected the output.

[kneufeld]

Still? I no longer get any mathml errors when running "make comments". I just upgraded the software running on the buildbot as well, maybe that has something to do with it.

[robe]

Not still. Now. I never got those errors before until the last week or so.

Can't recall when it started happening -- I think when you went happy with MathML :)

[robe]

Actually kevin -- nevermind for now. I haven't tested since your last commit and see you committed a fix about an hour ago. I'll let you know at my next compile cycle if I still get errors.

[kneufeld]

Yeah, I know what you mean. About two weeks ago something changed and I started getting a bunch of mathml warnings as well. I'm not sure, but my guess is that DOCTYPE we were calling, (1.1CR1 dbmathml.dtd) changed somehow. Internally it's now wrapping MATHML 2.0 which I thought it wasn't before.

I see that they just released MathML3 on Oct 21 ( http://www.w3.org/TR/MathML/). Maybe the site is still in flux.

In any case, I'm hoping the changes I just made will solve the mathml problems we were having.

[colivier]

Yeap, the make check is Ok for me, Good work Kevin !

[robe]

The make comments works for me now too without error.