Re: [boost] Boost 1.36.0 release notice

From: Beman Dawes (bdawes_at_[hidden])
Date: 2008-08-15 11:49:58

Daniel James wrote:
> On 15/08/2008, Emil Dotchevski <emil_at_[hidden]> 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-exception.html
>>  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