diff --git a/more/getting_started/index.html b/more/getting_started/index.html index 2f60d00baa..07428bdf08 100644 --- a/more/getting_started/index.html +++ b/more/getting_started/index.html @@ -14,6 +14,13 @@ +
Use the latest version of this Getting Started guide
+The Boost website version of this Getting Started guide may +have undated information, such as the location of additional installers +or improved installation procedures, so you might want use that version +if you've got an Internet connection available.
+Welcome to the Boost libraries! By the time you've completed this diff --git a/more/getting_started/index.rst b/more/getting_started/index.rst index 23bfa7bd0b..d12b400670 100644 --- a/more/getting_started/index.rst +++ b/more/getting_started/index.rst @@ -12,6 +12,16 @@ __ ../../index.htm +.. Admonition:: Use the latest version of this Getting Started guide + + The `Boost website version of this Getting Started guide`_ may + have undated information, such as the location of additional installers + or improved installation procedures, so you might want use that version + if you've got an Internet connection available. + + .. _`Boost website version of this Getting Started guide`: + http://www.boost.org/doc/libs/1_36_0/more/getting_started/index.html + Welcome ------- diff --git a/more/getting_started/unix-variants.html b/more/getting_started/unix-variants.html index 91a29ff9af..0830ef15f8 100644 --- a/more/getting_started/unix-variants.html +++ b/more/getting_started/unix-variants.html @@ -63,12 +63,12 @@
The most reliable way to get a copy of Boost is to download a distribution from SourceForge:
Download boost_1_35_0.tar.bz2.
+Download boost_1_36_0.tar.bz2.
In the directory where you want to put the Boost installation, execute
-tar --bzip2 -xf /path/to/boost_1_35_0.tar.bz2 +tar --bzip2 -xf /path/to/boost_1_36_0.tar.bz2
This is a sketch of the resulting directory structure:
-boost_1_35_0/ .................The “boost root directory” +boost_1_36_0/ .................The “boost root directory” index.htm .........A copy of www.boost.org starts here boost/ .........................All Boost Header files @@ -136,7 +136,7 @@ anything you can use in these directories.
It's important to note the following:
The path to the boost root directory (often /usr/local/boost_1_35_0) is +
The path to the boost root directory (often /usr/local/boost_1_36_0) is sometimes referred to as $BOOST_ROOT in documentation and mailing lists .
Now, in the directory where you saved example.cpp, issue the following command:
-c++ -I path/to/boost_1_35_0 example.cpp -o example +c++ -I path/to/boost_1_36_0 example.cpp -o example
To test the result, type:
@@ -261,7 +261,7 @@ you'll need to acquire library binaries.Issue the following commands in the shell (don't type $; that represents the shell's prompt):
-$ cd path/to/boost_1_35_0 +$ cd path/to/boost_1_36_0 $ ./configure --helpSelect your configuration options and invoke ./configure again @@ -425,9 +425,14 @@ bjam --build-dir=
For example, your session might look like this:
-$ cd ~/boost_1_35_0 +$ cd ~/boost_1_36_0 $ bjam --build-dir=/tmp/build-boost --toolset=gcc stage+That will build static and shared non-debug multi-threaded variations of the libraries. To build all variations:
++$ cd ~/boost_1_36_0 +$ bjam --build-dir=/tmp/build-boost --toolset=gcc --build-type=complete stage +
@@ -533,15 +538,15 @@ project.
You can specify the full path to each library:
-$ c++ -I path/to/boost_1_35_0 example.cpp -o example \ - ~/boost/lib/libboost_regex-gcc34-mt-d-1_35.a +$ c++ -I path/to/boost_1_36_0 example.cpp -o example \ + ~/boost/lib/libboost_regex-gcc34-mt-d-1_36.aYou can separately specify a directory to search (with -Ldirectory) and a library name to search for (with -llibrary,2 dropping the filename's leading lib and trailing suffix (.a in this case):
-$ c++ -I path/to/boost_1_35_0 example.cpp -o example \ - -L~/boost/lib/ -lboost_regex-gcc34-mt-d-1_35 +$ c++ -I path/to/boost_1_36_0 example.cpp -o example \ + -L~/boost/lib/ -lboost_regex-gcc34-mt-d-1_36As you can see, this method is just as terse as method A for one library; it really pays off when you're using multiple diff --git a/more/getting_started/unix-variants.rst b/more/getting_started/unix-variants.rst index c8b1db13b9..0a734e034f 100644 --- a/more/getting_started/unix-variants.rst +++ b/more/getting_started/unix-variants.rst @@ -142,6 +142,13 @@ For example, your session might look like this: $ cd ~/|boost_ver| $ bjam **--build-dir=**\ /tmp/build-boost **--toolset=**\ gcc stage +That will build static and shared non-debug multi-threaded variations of the libraries. To build all variations: + +.. parsed-literal:: + + $ cd ~/|boost_ver| + $ bjam **--build-dir=**\ /tmp/build-boost **--toolset=**\ gcc **--build-type=**\ complete stage + .. include:: detail/build-from-source-tail.rst .. include:: detail/link-head.rst diff --git a/more/getting_started/windows.html b/more/getting_started/windows.html index 32d61f77d3..beb71e6465 100644 --- a/more/getting_started/windows.html +++ b/more/getting_started/windows.html @@ -69,7 +69,7 @@ them yourself. To complete this tutorial, you'll need to at least install the Boost.Regex binaries when given the option.
If you're using an earlier version of Visual Studio or some other compiler, or if you prefer to build everything yourself, you can -download boost_1_35_0.exe and run it to install a complete Boost +download boost_1_36_0.exe and run it to install a complete Boost distribution.1
@@ -79,7 +79,7 @@ distribution.12 The Boost Distribution
This is a sketch of the resulting directory structure:
-boost_1_35_0\ .................The “boost root directory” +boost_1_36_0\ .................The “boost root directory” index.htm .........A copy of www.boost.org starts here boost\ .........................All Boost Header files lib\ .....................precompiled library binaries @@ -124,7 +124,7 @@ anything you can use in these directories.It's important to note the following:
-
The path to the boost root directory (often C:\Program Files\boost\boost_1_35_0) is +
- @@ -248,7 +248,7 @@ cd path\to\some\directory
The path to the boost root directory (often C:\Program Files\boost\boost_1_36_0) is sometimes referred to as $BOOST_ROOT in documentation and mailing lists .
followed by Return. For example,
-cd C:\Program Files\boost\boost_1_35_0 +cd C:\Program Files\boost\boost_1_36_0
Long commands can be continued across several lines by typing a caret (^) at the end of all but the last line. Some examples @@ -273,7 +273,7 @@ select Properties from the resulting pop-up menu
In Configuration Properties > C/C++ > General > Additional Include Directories, enter the path to the Boost root directory, for example
-C:\Program Files\boost\boost_1_35_0
+C:\Program Files\boost\boost_1_36_0
In Configuration Properties > C/C++ > Precompiled Headers, change @@ -311,7 +311,7 @@ Visual Studio compiler. In that window, set the to a suitable location for creating some temporary files and type the following command followed by the Return key:
-cl /EHsc /I path\to\boost_1_35_0 path\to\example.cpp +cl /EHsc /I path\to\boost_1_36_0 path\to\example.cpp
To test the result, type:
@@ -342,7 +342,7 @@ you'll need to acquire library binaries.5.1 Install Visual Studio (2005 or .NET 2003) Binaries
The installer supplied by Boost Consulting will download and install pre-compiled binaries into the lib\ subdirectory of the -boost root, typically C:\Program Files\boost\boost_1_35_0\lib\. If you installed +boost root, typically C:\Program Files\boost\boost_1_36_0\lib\. If you installed all variants of the Boost.Regex binary, you're done with this step. Otherwise, please run the installer again and install them now.
@@ -491,8 +491,8 @@ bjam --build-dir=For example, your session might look like this:4
-C:\WINDOWS> cd C:\Program Files\boost\boost_1_35_0 -C:\Program Files\boost\boost_1_35_0> bjam ^ +C:\WINDOWS> cd C:\Program Files\boost\boost_1_36_0 +C:\Program Files\boost\boost_1_36_0> bjam ^ More? --build-dir="C:\Documents and Settings\dave\build-boost" ^ More? --toolset=msvc stage@@ -620,7 +620,7 @@ earlier: select Properties from the resulting pop-up menu
-cl /EHsc /I path\to\boost_1_35_0 example.cpp ^ - /link /LIBPATH: C:\Program Files\boost\boost_1_35_0\lib +cl /EHsc /I path\to\boost_1_36_0 example.cpp ^ + /link /LIBPATH: C:\Program Files\boost\boost_1_36_0\lib