Re: [Boost-build] build documentation flaws

Subject: Re: [Boost-build] build documentation flaws
From: Vladimir Prus (vladimir_at_[hidden])
Date: 2008-11-05 04:32:26

Jürgen Hunold wrote:

> Hi Daniel !
> 
> An'n Mittwoch 05 November 2008 hett Daniel Krügler schreven:
>> Jürgen Hunold wrote:
> 
>> This surprises me, because
>>
>> http://www.boost.org/doc/libs/1_37_0/more/getting_started/windows.html#invo
>>ke-bjam
>>
>> gives this example of a bjam invokation:
>>
>> bjam --build-dir=build-directory --toolset=toolset-name
>> --build-type=complete stage
>>
>> Mind to explain?
> 
> This is because of compatibility to V1. And obsoleted. So it is a
> documentation bug. Plain Boost.Build options are without "--".
> See "link=static" for example :-))

Well, I think it's explicitly introduced in V2 :-( The real problem is
that now, both --toolset= and toolset= are allowed, which makes people
try to use --variant=debug and --link=static which are not allowed. So,
we want people to forgot --toolset=xxx is allowed. I meant to fix the
getting started for 1.37, but missed the deadline.

- Volodya