From: David B. Held (dheld_at_[hidden])
Date: 2002-11-01 13:55:59
Alisdair Meredith wrote:
> However, the XML representation of '<' and '>' leaves a lot to be
> desired if you want to store code-samples in the XML documentation.
> Particularly unfortunate given the frequency of these symbols in C++
> in general, and the boost libraries in particular.
As someone who spent a few days writing documentation for a Boost
library and having to contend with just this issue, I can't agree more.
I personally dislike "smart" *ML editors, and prefer to write all the
code by hand (I don't like how verbose many of the editors are in the
generated code...if I liked verbose code, I would be using VB or Ada ;).
P.S. I like the documentation discussion, but hope that some consensus
is reached soon, so I know what tools to look for and learn.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk