Re: [jamboost] [BBv2 docs editorial] Installation

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-09-20 17:50:43

Zbynek Winkler wrote:
> Andrey Melnikov wrote:
> 
> 
>>>>Go to the 
>>>> Boost.Build root directory and run bjam --version. You should see:
>>>> 
>>>> Boost.Build V2 (Milestone N)
>>>> Boost.Jam xx.xx.xx 
>>>>
>>>> where N is the version of Boost.Build you're using.
>>>> 
>>>>
>>
>>IMO we can omit this step at all. Or we can add it to a more 
>>comprehensive Installation Troubleshooting guide. We should follow the 
>>80/20 rule - 80% of users will need only 20% of the documentation.
>> 
>>
> 
> IMO it is a necesity. I remember when I was installing bb2 for the first 
> time, this wasn't in the documentation, so I never verified that bjam 
> can find the bb2 files (which it could not - surprise!). I just went to 
> an example project, run bjam and got a horribly looking back-trace, 
> never knowing what went wrong.
> 
I don't understand how these paragraphs can help you. N isn't mentioned 
any more, and it isn't clear for what do you need to run this bjam 
--version and why do you need to know "the version you're using".

Andrey