Subject: Re: [boost] Building 'stage' by default
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
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk