Document building Boost for Windows 64-bit

[anonymous]

http://www.boost.org/doc/tools/build/doc/html/bbv2/reference/tools.html#id2566888 documents the various Boost build switches but does not include specific command-line examples.

It isn't immediately clear how to build Boost for debug, release, 32-bit, 64-bit modes.

[cowwoc@…]

Sorry, I was the author. I forgot to log in.

[Vladimir Prus]

To use 64-bit compilation you should:
Configure you compiler as usual. If you provide a path to the compiler explicitly, provide the path to the 32-bit compiler. If you try to specify the path to any of 64-bit compilers, configuration will not work.
When compiling, use address-model=64, to generate AMD64 code.
To generate IA64 code, use architecture=ia64

Can you clarify what is lacking in the above description. As for debug and release mode, I think that: http://www.boost.org/boost-build2/doc/html/bbv2/advanced/invocation.html

Is clear on that.

[anonymous]

I think you should provide a sample command-line for each section. The documentation talks about different command-line options in a piece-meal fashion but it's not clear what the end result should look like.

[Vladimir Prus]

I have now added a mention of address-model to http://www.boost.org/boost-build2/doc/html/bbv2/advanced/invocation.html. I am not sure what "sample command-line for each section" might be there -- given that some examples are given and address-model is just one of many other features, and it does not make sense to give an example for every feature. I think this is now as close to good as we can get.