Re: V2 documentation feedback from a newbie

From: Zbynek Winkler (zwin_at_[hidden])
Date: 2004-01-23 06:51:18

Vladimir Prus wrote:
> Hi Samuel,
> 
> 
>>I'm finally taking some time to use Boost.Buildv2 for some of my projects.
>>I do not have much v1 experience (except for making boost test Jamfiles),
>>but I thought it could be a good idea to go directly for v2 (is it ?) 

I did and so far I am happy :-)

>>Also, it wasnt clear to me at first what other directories a bjam
>>invocation in my directory would depend on.
>>The fact a project root's boost-build.jam has to point to a certain
>>boost_build_root directory (namely $boost_root/tools/build/v2) should have
>>been a sufficient hint, but not at the time when I worked my way through my
>>first contact with Boost.Build, and actually it didnt break the vague
>>mystery surrounding all Boost.Build until a few hours later. Maybe I'm
>>dumb :)
> 
> 
> Why did you wonder what directories bjam invocation depends on? I'm just 
> trying to figure out what exactly should be put to docs.

My guess would be that we wonder about what the tools we use do because after 
all - we all programmers, right? :-) I ask myself - do I want to use something 
the does some "magic"? No. Because what happens when I am stuck with it and it 
stops doing the "right" kind of magic?

>>It would be a good time to state that the jam files in this directory
>>hierarchy are well commented and are the ultimate place to go to when you
>>don't understand something with Boost.Build.
> 
> Cool! I'll sure add this too ;-)

It took me a quite time to find that out. It would be definitively helpful to 
know.

Zbynek

-- 
http://zw.matfyz.cz/ http://robotika.cz/
Faculty of Mathematics and Physics, Charles University, Prague, Czech Republic