On Thursday 30 January 2003 11:05 am, David Abrahams wrote:
> > [Yes, I'm beginning to sound like a broken record, but I really
> > don't think we should ever be generating documentation directly from
> > C++ code.]
>
> I can't see any relevance. Care to explain?
I stated that _very_ poorly. I meant that I don't believe we should be writing
HTML directly: not by ourselves for documentation, and not with C++ code for
regression tests. As soon as we put data into HTML, we've lost most of the
structure of the data. With documentation, losing structure means that it is
harder to cross-reference information or pick out the most important
information for a particular task; with the regression tests, we lose the
ability to easily generate other kinds of regression test tables because all
of the structure of the data was thrown out when the C++ program ended. I
also find tweaking the HTML output from C++ code to be an unnecessarily
time-consuming process.
Doug
_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
