Re: [boost] Re: bjam docs for boost developers?

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-01-29 09:55:10

Hi Jeremy,

>> B. Version 2 has been getting ready to replace version 1 for a long
>> time now :(, and we don't want to waste time documenting version 1
> 
> How big are the differences between v1 and v2 from the user (boost
> developer)
> point of view? 

You can decide for yourself, for example by taking look at

libs/graph/test/Jamfile 

and 

libs/graph/test/Jamfile.v2

Or tests for signals library -- they illustrate the difference better.
Or tests for any other library. The primary difference is that project 
requirements are used to simplify jamfiles.

> Will some of the documentation be reusable?
> I would hope that most of it would be reusable.

At least for testing, all the rules ('compile', 'run') has the same interface 
in V2 as in V1.

>> None of that's to say that it shouldn't be better documented.
>> Clearly it should.
>>
> 
> Right.
> 
> I volunteer to edit and revise if such documentation is written up.

Hmm... despite all said above I can hardly have time to expand docs for V2 
testing system. The primary V2 docs issue for now is extender's manual and 
even that does not progress as quickly as I'd like.

- Volodya