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

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. 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.) * 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 ?) Thanks, Stefan

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

Rene Rivera wrote:
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.
Yes, I'm aware of this danger. But since my system (Fedora Core 5) contains boost libraries (release 1.33, I think) all without the 'mt' tag, and as I thought at least some would be compiled with multithread support, I concluded something was wrong. (Writing these lines I realize I'm still not sure I understand what 'multithread support' actually means in this context.) Thanks for the clarification !
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.
Ah, I see. But that shouldn't be a reason not to document it somewhere on boost.org, should it ? ;-) Thanks, Stefan
participants (2)
-
Rene Rivera
-
Stefan Seefeld