[Boost-build] bjam --help not very useful

From: Christian Holmquist (c.holmquist_at_[hidden])
Date: 2008-06-04 16:54:10

Ever since started struggling with the boost build process (on
Windows), I always wondered how one is supposed to configure the
-most- important configs:

Debug or Release
Static or Dynamic
C-Runtime Static or Dynamic

Last time I did the investigation on this at work (spending numerous
days), I came up with the following build

link=static threading=multi runtime-link=shared debug release stdlib=stlport

In order to find this info, I need to go trough:

boost.org -> welcome -> getting started guide-> Getting started on MS
Windows -> 5.4 In case of build errors (assume this to always be true)
-> Boost.Build documentation -> Documentation -> Detailed reference ->
Builtin features

This list of builtin features is IMO the most important documentation
for end users that want to compile boost. To someone who's used to
configure projects trough an IDE it's not apparent what a 'builtin
feature' is, so a direct link here from the Gettings started guide
would IMO be helpful.

Taking into account that boost 1.35 only compiles Release DLL by
default on windows (the complete opposite of a default created VC
project requires), it's crucial to know how to communicate with bjam..

/ Christian