Re: [boost] Boost.Test documentation update; alpha release

From: Gennadiy Rozental (rogeeff_at_[hidden])
Date: 2007-08-13 23:11:35

"John Maddock" <john_at_[hidden]> wrote in message 
news:00c201c7dcc5$799e6440$14120952_at_fuji...
> Gennadiy Rozental wrote:
>> Hi,
>>
>> I've finally been able to produce alpha release of completely reworked
>> BoostBook based documentation for Boost.Test library. It's still not
>> ready for release and I expect significant changes in both L&F (once
>> I apply latest IBD based style) and content (some articles still 
>> missing).
>> But it's in a shape close to what I would like it to be.
>>
>>  I would really appreciate any comments to both content (language
>> including) and style. I realize it might not be small undertaking so
>> if you have time for just part of it, please post comments as well.
>>
>> The release is available here:
>>
>> patmedia.net/~rogeeff/html/index.html
>
> Looks nice, I did notice:
>
> #include <execution_monitor.hpp>
>
> which is surely not correct?  Should it be  #include
> <boost/test/execution_monitor.hpp> ?

fixed

> Also from a quick look through I had trouble finding the section I most 
> use:
> the test macro reference.  I eventually found
> http://patmedia.net/~rogeeff/html/utf/testing-tools/reference.html,

How would you like me to make it easier to find?

> some
> kind of overview of the test macros available would be very helpful IMO 
> (or
> maybe I missed it?), as this is basically the "meat" of the library.

Doesn't this page

http://www.patmedia.net/~rogeeff/html/utf/testing-tools.html

fit the bill?

> I'm not sure how that reference page would work as a PDF either?

I plan to use regular boostBook like reference. I am not planning to support 
PDF output in first cut.

Gennadiy