Boost logo

Boost :

Subject: Re: [boost] Building 'stage' by default
From: dherring_at_[hidden]
Date: 2008-11-24 15:06:58

On Sat, 22 Nov 2008, Vladimir Prus wrote:
> We presently have 3 ways of building C++ Boost from top-level directory:
> - with 'stage' target -- only libraries are installed
> - with 'install' target -- both libraries and headers are installed
> - with no explicit target -- everything is built, but nothing installed
> It seems to me that the first two options are what the majority of users will want,
> so some of them should be the default. I have a local patch that makes 'stage' the
> default, and additionally prints the following message:

`bjam stage` seems like a developer-only target. Following in the unix
tradition, I always do `bjam; bjam install` (with the appropriate prefix

> Performing 'stage' build by default:
> - binaries installed into 'stage/lib'
> - headers not installed, use the source tree
> Use the 'install' target for complete installation.
> This message is printed only if no explicit target is specified -- if user types
> 'stage' or 'install', it's assumed he knows what he's doing.
> Anybody has any comments on this change in defaults, or about the wording of
> the message?

Ok, 'stage' seems innocuous enough (as long as the stage path is a
subdirectory of PWD) that there's no real harm in this change.

The wording could be simplified to
Performing 'bjam stage': build and copy libraries to '<stage-lib>'
Use 'bjam install' to copy headers to '<inst-headers>' and libraries to

Where the <>s are the actual paths, something like
<stage-lib> ./stage/lib
<inst-headers> /usr/local/include/boost-1.37
<inst-libs> /usr/local/lib64

- Daniel

Boost list run by bdawes at, gregod at, cpdaniel at, john at