Boost logo

Boost :

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

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

Boost list run by bdawes at, gregod at, cpdaniel at, john at