Poorly formed HTML in Xerces-C documentation pages? (fwd)

[Dirk-Willem van Gulik <di...@webweaving.org>]

FYI and persual. (Jesse; you might want to subscribed to this mailing
list if you have an interest in these matters).

	Dw

---------- Forwarded message ----------
Date: Thu, 18 May 2000 16:00:23 -0400
From: Jesse Pelton <js...@PKC.com>
To: "'apache@apache.org'" <ap...@apache.org>
Subject: Poorly formed HTML in Xerces-C documentation pages?

I'm not sure whether this is the best place to direct this comment to, but I
couldn't find anything better.

Many of the Xerces-C documentation pages appear to be poorly formed HTML.
They display badly in Opera 4 beta 4, so I ran one
(http://xml.apache.org/xerces-c/apiDocs/class_dom_domimplementation.html)
through the W3C's HTML validation service (http://validator.w3.org/), and it
reported many errors. Some of the errors should not affect formatting, but
some look like they might. I haven't the time to do a complete analysis of
such large and complex pages, but I thought you should know of the problem.
(I assume it's a problem in Doc++.) I've also reported it to Opera, in case
part or all of the problem is on their end.

IE 5 and Navigator 4.72 display the pages fine. Mozilla does better than
Opera, but it's not perfect. It could be that the HTML is fine and Opera and
Mozilla are broken, or it could be that IE and Navigator are simply covering
up defects in the markup. (IE's laxity is infamous.)

Jesse Pelton
PKC Corporation