Re: how to create main-target rule? (was Re: [bbv2][doc]v2/doc/html/bbv2/tutorial/hierarchy.html jamroot?

From: David Abrahams (dave_at_[hidden])
Date: 2005-05-31 12:23:41

Vladimir Prus <ghost_at_[hidden]> writes:

> On Tuesday 31 May 2005 19:26, Larry Evans wrote:
>
>> So, tried new Jamfile.v2:
>>
>> <Jamfile.v2>
>> import type ;
>>
>> type.register OUTPUT : output ;
>
> This creates main target rule called "output", in global namespace.
>
>> rule output ( target : exe )
>> {
>> }
>
> This creates a local rule 'output', that does nothing, and hide
> the global one.
>
>
>> output test_out
>>
>> : test_exe
>>
>> ;
>
> And this does nothing. What about this:
>
> import type ;
> type.register OUTPUT : output ;
>
> import generators ;
>
> generators.register-standard $(__name__).capture-output : EXE : OUTPUT ;
>
> actions capture-output
> {
> echo "capture"
> }
>
> exe a : a.cpp ;
> output a.output : a ;
>
>
> I've tested it now and it seem to work.

Can we capture the result of this explanation in the docs somehow?
Larry, can you tell us what should be changed in the docs to avoid
this confusion, or better yet, make the change yourself?

Thanks,

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com