From: David Abrahams (dave_at_[hidden])
Date: 2005-08-05 11:16:41
Anthony Williams <anthony_w.geo_at_[hidden]> writes:
> David Abrahams <dave_at_[hidden]> writes:
>> Anthony Williams <anthony_w.geo_at_[hidden]> writes:
>>> BTW, Dave, it's probably worth running Tidy over the HTML, since it picks up a
>>> few things, such as nested <a> tags, and id's that clash with name's
>>> (e.g. table-of-contents is both an id on a DIV, and a name on an A tag, which
>>> is not allowed)
>> Nothing I can do about it other than try to fix docutils, and every
>> time I've reported that tidy complains about something docutils
>> generates the docutils people have told me that tidy is wrong. So, I
>> don't want to seem uncooperative or like I don't care about validity,
>> but I hope you'll understand when I say "be my guest and report the
>> problems to docutils if you think you know the HTML rules well
>> enough." I sure don't.
> I certainly understand. If I believed my tool was right and another tool
> complained, I'd blame the other tool, too.
> However, I happen to agree with tidy, so I think it's worth giving feedback to
> the docutils people. Do you mean the project at docutils.sourceforge.net?
Yes. There's a gmane reflector for their lists.
> Where's the source code for these web pages, and how do I run docutils on it?
> Is it nicely in CVS with a bjam script?
Yes. libs/parameter/doc. Use
bjam --v2 html
Don't forget to configure docutils in your user-config.jam. Mine
using docutils : c:/src/docutils ;
> What do I need (other than docutils) to build it?
-- Dave Abrahams Boost Consulting www.boost-consulting.com
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk