[Boost-build] bootstrap documentation...

Subject: [Boost-build] bootstrap documentation...
From: Jurko Gospodnetiæ (jurko.gospodnetic_at_[hidden])
Date: 2012-09-13 00:51:13

   Hi all.

   This is a bit edited forward of an e-mail correspondence I received a 
few days ago from Ronan Trépos:

> I'm using MinGW and I finally succeded in building boost
>
> Using these commands, it worked:
>
> bootstrap mingw
> .\b2 toolset=gcc variant=release link=shared install
>
> I first relied onto the index.html > Getting Started documentation
> provided into boost_1_51. It simply says :
>
> bootstrap
> .\b2
>
> I think (up to you of course) b2 is well documented by e.g. b2 --help
> but documentation on bootstrap was more difficult to get (or maybe I am
> missing something else).

   I have not found bootstrap.bat options documented or referenced 
anywhere. From looking at the source, it just passes any received 
options on to the internal worker Boost Build build.bat script. I guess 
the most important option there is selecting the toolset to be used for 
building Boost Jam.

   Could someone add a reference to this effect in the getting started 
documentation? I looked into adding it myself but do not really know how 
the documentation toolchain works.

   One smell I can sense here: bootstrap.sh does not do any option 
forwarding here and expects build.sh to correctly auto-detect the 
toolset used and report it back, so there is a bit of a different 
behaviour here for Windows and non-Windows systems.

   Hope this helps.

   Best regards,
     Jurko Gospodnetiæ