Re: [boost] Building 'stage' by default

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 
set).

> 	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 
'<inst-libs>'.
""

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