Re: [boost] [boost.build]: docs for the --layout option

From: Rene Rivera (grafik.list_at_[hidden])
Date: 2006-04-17 21:33:15

Stefan Seefeld wrote:
> I'v just built boost using
> 
> 'bjam -sBUILD="release <threading>multi" --layout=system'
> 
> and I notice that all library names contain an 'mt' tag, which
> I thought would be suppressed with the --layout=system option.
> Unfortunately, I'm unable to find documentation for the --layout
> option, so I can't verify whether I remembered it wrongly.

You are remembering incorrectly, it only removes the version numbers 
and toolset names from the libraries. Anything else would cause 
conflicts with the different types of libraries that can be built.

> Thus I have two questions:
> 
> * Where can I find complete documentation for options such as
>    --layout ? (I'm not even sure this is part of bjam, or boost.build,
>    or something entirely different.)

Hm, there's no "complete" documentation for that option. It's only part 
of the boost-root/Jamfile, so it's neither part of bjam of boost.build.

> * What is the correct use of --layout, and what does it actually do ?
>    Shouldn't 'mt' be suppressed, too ? (Did the actual behavior change
>    recently ?)

 From the brief "bjam --help" description:

--layout=<layout>       Determines what kind of build layout to use.
                         This allows one to control the naming of the
                         resulting libraries, and the locations of the
                         installed files. Default is 'versioned'.
                         Possible values:

                         versioned - Uses the Boost standard names
                         which include version number for Boost the
                         release and version and name of the
                         compiler as part of the library names. Also
                         installs the includes to a versioned
                         sub-directory.

                         system - Builds an install without the
                         Boost standard names, and does not install
                         includes to a versioned sub-directory. This
                         is intended for system integrators to build
                         for packaging of distributions.

-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo