Anthony Williams <anthony_w.geo@yahoo.com> writes:
David Abrahams <dave@boost-consulting.com> writes:
Anthony Williams <anthony_w.geo@yahoo.com> 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 says: using docutils : c:/src/docutils ;
What do I need (other than docutils) to build it?
Nothing. -- Dave Abrahams Boost Consulting www.boost-consulting.com