Re: [Boost-build] build documentation flaws

Subject: Re: [Boost-build] build documentation flaws
From: Jürgen Hunold (juergen.hunold_at_[hidden])
Date: 2008-11-05 04:27:59

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 :-))

> > This works only for toolsets with autodetection. That would be gcc and
> > msvc. I think that all other toolsets have to be configured in
> > user-config.jam or site-config.jam.
> >
> > Then specifing "toolset=whateveryounameit" should work.
>
> OK, thanks. Obviously I misunderstood
>
> http://www.boost.org/doc/libs/1_37_0/doc/html/jam/building.html
>
> table 29.1, which says "The supported toolsets, and wether they are
> auto-detected[..]:"

This is for _building_ bjam and not for using Boost.Build ;-))
Those are two different things :-((

> The table contains e.g. darwin and I miss the definition of
> auto-detection. Maybe something like: Where "Common install locations"
> is defined?

For the toolsets of Boost.Build see
http://www.boost.org/doc/libs/1_37_0/doc/html/bbv2/reference.html#bbv2.reference.tools

where "darwin" seems to be missing. Ouch.
So you have to look at tools/build/v2/tools/darwin.jam for the details...

Yours,

Jürgen

-- 
* Dipl.-Math. Jürgen Hunold       ! Ingenieurgesellschaft für 
* voice: ++49 511 262926 57       ! Verkehrs- und Eisenbahnwesen mbH  
* fax  : ++49 511 262926 99       ! Lister Straße 15
* juergen.hunold_at_[hidden]        ! www.ivembh.de
* 
* Geschäftsführer:                ! Sitz des Unternehmens: Hannover
* Prof. Dr.-Ing. Thomas Siefer    ! Amtsgericht Hannover, HRB 56965
* PD Dr.-Ing. Alfons Radtke       !