Daniel James wrote:
On 15/08/2008, Emil Dotchevski <emil@revergestudios.com> wrote:
Clicking the XHTML 1.0 link in the documentation (which checks for conformance) seems to report errors on the pages of all of the few libraries I clicked, including the Exception library. Note that the documentation at http://svn.boost.org/svn/boost/branches/release/libs/exception/doc/boost-exc... is XHTML 1.0 compliant.
Is this a bug in documentation processing? Is there anything library authors can do to fix it?
It's because the underlying documentation is HTML and we don't really try to convert it or it's invalid XHTML and we don't do anything to fix it. Fixing this is a fairly large job, and far down on the priorities.
I'd like to second Daniel on this. Right now we are holding documentation generation together with duct tape. It took much behind the scenes work by Daniel, me, Eric Niebler, Rene, and others to get the release out. We need to smooth all that out before worrying about XHTML. --Beman