[boost] Re: Reference documentation: one approach

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 ;).

Dave

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.