[Boost-build] what is correct bjam option for build dir outside source dir

From: Dennis Cote (dennis.cote_at_[hidden])
Date: 2008-01-30 18:49:01

Hi,

I'm trying to build boost 1_34_1 using boost-jam-3.1.16-1-ntx86 on Win 
XP with the Borland C++ 5.8.2 (BDS 2006 C++ Compiler).

The documentation at 
http://www.boost.org/more/getting_started/windows.html shows the command:

bjam --build-dir=build-directory --toolset=toolset-name stage

in section 5.2.4 Invoke bjam.

This says to use an option --build-dir to specify a build directory 
where boost.build will place all intermediate files.

When I use bjam --help, it displays online help that shows an option 
--builddir (note, no dash between build and dir).

I have tried using both option alternatives (i.e. with and without the 
dash), but bjam always creates the bin.v2 and stage directories inside 
the boost source directory (which is the current directory) when I use 
these commands.

cd \boost\boost_1_34_1
bjam --build-dir=\boost\build --toolset=borland-5.8.2 stage > build_log
or
bjam --builddir=\boost\build --toolset=borland-5.8.2 stage > build_log

The beginning of my build log file is:

Building Boost.Regex with the optional Unicode/ICU support disabled.
Please refer to the Boost.Regex documentation for more information
(don't panic: this is a strictly optional feature).
...patience...
...patience...
...found 5759 targets...
...updating 2548 targets...
MkDir1 bin.v2
MkDir1 bin.v2\libs
MkDir1 bin.v2\libs\test
MkDir1 bin.v2\libs\test\build
MkDir1 bin.v2\libs\test\build\borland-5.8.2

I have an environment variable BOOST_BUILD_PATH set to C:\boost\build as 
well (probably left over from earlier attempts to build boost libs).

My directory structure is:

/boost
        /boost_1_34_1
        /build
        /boost-jam-3.1.16-1-ntx86

So finally my question, what is the correct way to specify that all 
intermediate files (and I believe the stage directory as well) should go 
into /boost/build?

Thanks for any advice or assistance you can offer.

Dennis Cote