Opened 15 years ago
Closed 14 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: | master |
| 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 by , 15 years ago
| Owner: | changed from to |
|---|
comment:2 by , 15 years ago
| Resolution: | → fixed |
|---|---|
| Status: | new → closed |
This seem OK to me. Good work Olivier. Good thought with the xml validator make check rule you added.
comment:3 by , 14 years ago
| Milestone: | PostGIS 1.5.2 → PostGIS 2.0.0 |
|---|---|
| Resolution: | fixed |
| Status: | closed → reopened |
| Version: | 1.5.X → trunk |
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 by , 14 years ago
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 by , 14 years ago
FWIW my make comments gives mathml errors, but I've been ignoring them since they haven't affected the output.
comment:6 by , 14 years ago
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 by , 14 years ago
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 by , 14 years ago
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 by , 14 years ago
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:11 by , 14 years ago
| Resolution: | → fixed |
|---|---|
| Status: | reopened → closed |
The make comments works for me now too without error.
Note:
See TracTickets
for help on using tickets.
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.