From: Paul A Bristow (pbristow_at_[hidden])
Date: 2007-03-09 04:29:30
>[mailto:boost-bounces_at_[hidden]] On Behalf Of Gennadiy Rozental
>Sent: 08 March 2007 20:15
>Subject: Re: [boost] Copy editing documentation
>"Nava Whiteford" <nwhiteford_at_[hidden]> wrote in message
>> I'd be interested in hearing your views. As an aside could the class
>> documentation not be generated directly from the source
> using something like Doxygen?
>I personally don't like docs produced using Doxygen (or
>similar). They still
>require considerable effort and in most cases look like
>than users guide/tutorial.
Strongly agree - OK for reference but using Doxygen usually deludes the programmer that he has done all he needs to - so there is no
"How to /How do I ..." content. Most people 'get it' much for quickly from examples - and only occasionally need reference info.
--- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow_at_[hidden]
Boost list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk