Update getting started

[Vladimir Prus]

In ​http://thread.gmane.org/gmane.comp.lib.boost.devel/182107/, Dave and I had a discussion about getting-started content. I think we have agreed on a few important points, which are listed below.

The kylix toolset should be removed from the table of toolsets, because it's dropped from Boost.Build years ago.

"FreeScale" should be "Freescale"

Section "5.2.2 Identify Your Toolset" should include a link to http://www.boost.org/boost-build2/doc/html/bbv2/reference/tools.html

All --toolset= should be replaced with toolset=

5.2.3 Has this command line: bjam --build-dir=build-directory --toolset=toolset-name --build-type=complete stage There should be a link to http://www.boost.org/boost-build2/doc/html/bbv2/advanced/invocation.html

5.3 If it seems like the build system can't find your compiler and/or linker, consider setting up a user-config.jam file as described in the Boost.Build documentation.

There should be a link to http://www.boost.org/boost-build2/doc/html/bbv2/advanced/configuration.html

[Dave Abrahams]

Fixed in [52035]

[Dave Abrahams]

(In [52307]) *really* fixes #2895.

[Dave Abrahams]

(In [52308]) really, really fixes #2895

[Vladimir Prus]

I've reread getting-started over, and noted a couple of additional inconsistencies. The windows getting started say, in 5.2.4 Invoke bjam

Building the special stage target places Boost library binaries in the stage\ subdirectory of your build directory.

Note the strange-looking backslash after "stage". In reality, the libraries are put to stage/lib.

Now look at 6.1 and 6.2. Both suggest to add C:\Program Files\boost\boost_1_39_0\lib to linker search path, whilst it probably would be less confusing to use C:\Program Files\boost\boost_1_39_0\stage\lib -- not added 'stage'

Also, section 5.2.4 say: For instructions on how to build only specific variants, please ask on the Boost.Build mailing list. This is probably unnecessary now that the same section gives a pointer to Boost.Build documentation, where all options of interest for building Boost are listed in a table.

[Vladimir Prus]

The necessary changes were checked in.