Boost logo

Boost :

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, gregod at, cpdaniel at, john at