Re: [Boost-build] "Testing" section in doc for unit-test

Subject: Re: [Boost-build] "Testing" section in doc for unit-test
From: Edward Diener (eldiener_at_[hidden])
Date: 2010-10-06 14:25:43

On 10/6/2010 1:16 PM, Vladimir Prus wrote:
> On Wednesday, October 06, 2010 20:38:50 Edward Diener wrote:
>> On 10/6/2010 1:57 AM, Gevorg Voskanyan wrote:
>>> Edward Diener wrote:
>>>> To: boost-build_at_[hidden]
>>>> Sent: Wed, October 6, 2010 7:40:18 AM
>>>> Subject: [Boost-build] "Testing" section in doc for unit-test
>>>>
>>>> The "Testing" section in the Boost Build doc, which supposedly explains
>>>> the built-in rule called 'unit-test', is completely blank. Is
>>>> 'unit_test' operable as a built-in rule and, if so, how does it work  ?
>>>
>>> Edward,
>>>
>>> To my knowledge unit-test is deprecated, and it is advised to use the
>>> 'run' rule instead.
>>
>
>> And the 'run' rule is documented where ?
>
> At
> http://www.boost.org/boost-build2/doc/html/bbv2/builtins/testing.html

That's nice but it is missing from the list of built-in rules in the 
Reference at 
http://www.boost.org/doc/tools/build/doc/html/bbv2/reference/rules.html.

My frustration with the Boost Build docs is with the Reference. Anybody 
seeing a rule in a jamfile should be able to find its explanation in the 
Boost Build reference. Likewise for features and tools. If it is not a 
built-in rule, feature, or tool, but is distributed as part of a tool in 
the boost\tools\build\v2\tools directory, it should also be documented 
somewhere so programmers who have to use Boost Build can actually use it.