|
Boost : |
From: David Abrahams (dave_at_[hidden])
Date: 2008-08-15 19:09:01
on Fri Aug 15 2008, "Emil Dotchevski" <emil-AT-revergestudios.com> wrote:
> On Fri, Aug 15, 2008 at 8:49 AM, Beman Dawes <bdawes_at_[hidden]> wrote:
>> Daniel James wrote:
>>> 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.
>
> If we don't care whether the documentation format validates correctly,
> we should not advertise it as XHTML-conformant, and we should instruct
> documentation writers to not include any conformance claims in their
> HTML.
Seems reasonable to me. Would you like to propose a specific patch?
-- Dave Abrahams BoostPro Computing http://www.boostpro.com
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk