Opened 8 years ago

Closed 7 years ago

#471 closed defect (fixed)

Documentation errors against docbook 4.3 dtd

Reported by: colivier Owned by: colivier
Priority: medium Milestone: PostGIS 2.0.0
Component: postgis Version: trunk
Keywords: doc docbook dtd Cc:

Description

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


...

Change History (11)

comment:1 Changed 8 years ago by colivier

Owner: changed from pramsey to 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.

comment:2 Changed 8 years ago by kneufeld

Resolution: fixed
Status: newclosed

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

comment:3 Changed 7 years ago by colivier

Milestone: PostGIS 1.5.2PostGIS 2.0.0
Resolution: fixed
Status: closedreopened
Version: 1.5.Xtrunk
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>

comment:4 Changed 7 years ago by 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?

comment:5 Changed 7 years ago by robe

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

comment:6 Changed 7 years ago by 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.

comment:7 Changed 7 years ago by 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 :)

comment:8 Changed 7 years ago by 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.

comment:9 Changed 7 years ago by 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.

comment:10 Changed 7 years ago by colivier

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

comment:11 Changed 7 years ago by robe

Resolution: fixed
Status: reopenedclosed

The make comments works for me now too without error.

Note: See TracTickets for help on using tickets.