diff --git a/getting_started/detail/release-variables.rst b/getting_started/detail/release-variables.rst index c43e8ab..6a00983 100644 --- a/getting_started/detail/release-variables.rst +++ b/getting_started/detail/release-variables.rst @@ -6,7 +6,7 @@ .. for each new release of Boost. .. |boost-version-number| replace:: 65 -.. |boost_ver| replace:: ``boost_1_65_0`` -.. |boost_ver-bold| replace:: **boost_1_65_0** +.. |boost_ver| replace:: ``boost_1_65_1`` +.. |boost_ver-bold| replace:: **boost_1_65_1** -.. _sf-download: http://www.boost.org/users/history/version_1_65_0.html +.. _sf-download: http://www.boost.org/users/history/version_1_65_1.html diff --git a/getting_started/index.html b/getting_started/index.html index 90db3cb..73a8597 100644 --- a/getting_started/index.html +++ b/getting_started/index.html @@ -3,7 +3,7 @@
- +Use the latest version of this Getting Started guide
The Boost website version of this Getting Started guide may have updated information, such as the location of additional installers diff --git a/getting_started/unix-variants.html b/getting_started/unix-variants.html index e134805..82b2a27 100644 --- a/getting_started/unix-variants.html +++ b/getting_started/unix-variants.html @@ -3,7 +3,7 @@
- +The most reliable way to get a copy of Boost is to download a -distribution from SourceForge:
+distribution from SourceForge:Download boost_1_65_0.tar.bz2.
+Download boost_1_65_1.tar.bz2.
In the directory where you want to put the Boost installation, execute
-tar --bzip2 -xf /path/to/boost_1_65_0.tar.bz2 +tar --bzip2 -xf /path/to/boost_1_65_1.tar.bz2
Other Packages
RedHat, Debian, and other distribution packagers supply Boost library packages, however you may need to adapt these @@ -81,7 +81,7 @@ creators usually choose to break Boost up into several packages, reorganize the directory structure of the Boost distribution, and/or rename the library binaries.1 If you have any trouble, we suggest using an official Boost distribution -from SourceForge.
+from SourceForge.This is a sketch of the resulting directory structure:
-boost_1_65_0/ .................The “boost root directory” +boost_1_65_1/ .................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_65_0) is +
The path to the boost root directory (often /usr/local/boost_1_65_1) is sometimes referred to as $BOOST_ROOT in documentation and mailing lists .
The first thing many people want to know is, “how do I build Boost?” The good news is that often, there's nothing to build.
-Nothing to Build?
Most Boost libraries are header-only: they consist entirely of header files containing templates and inline functions, and @@ -246,7 +246,7 @@ int main()
Now, in the directory where you saved example.cpp, issue the following command:
-c++ -I path/to/boost_1_65_0 example.cpp -o example +c++ -I path/to/boost_1_65_1 example.cpp -o example
To test the result, type:
@@ -277,7 +277,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_65_0 +$ cd path/to/boost_1_65_1 $ ./bootstrap.sh --helpSelect your configuration options and invoke ./bootstrap.sh again @@ -328,7 +328,7 @@ the directory where you want Boost.Build to be installed
First, find the toolset corresponding to your compiler in the following table (an up-to-date list is always available in the Boost.Build documentation).
-+Note
If you previously chose a toolset for the purposes of building b2, you should assume it won't work and instead @@ -426,7 +426,7 @@ b2 --build-dir=b please see the Boost.Build documentation.
For example, your session might look like this:
-$ cd ~/boost_1_65_0 +$ cd ~/boost_1_65_1 $ b2 --build-dir=/tmp/build-boost toolset=gcc stageThat will build static and shared non-debug multi-threaded variants of the libraries. To build all variants, pass the additional option, “--build-type=complete”.
@@ -437,7 +437,7 @@ $ b2 --build-dir=/tmp/build-boost toolset=gcc library binaries in the stage/lib/ subdirectory of the Boost tree. To use a different directory pass the --stagedir=directory option to b2. -+Note
b2 is case-sensitive; it is important that all the parts shown in bold type above be entirely lower-case.
@@ -455,7 +455,7 @@ be interested in:- choosing a specific build variant by adding release or debug to the command line.
-+Note
Boost.Build can produce a great deal of output, which can make it easy to miss problems. If you want to make sure @@ -542,14 +542,14 @@ project.
You can specify the full path to each library:
-$ c++ -I path/to/boost_1_65_0 example.cpp -o example \ +$ c++ -I path/to/boost_1_65_1 example.cpp -o example \ ~/boost/stage/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_65_0 example.cpp -o example \ +$ c++ -I path/to/boost_1_65_1 example.cpp -o example \ -L~/boost/stage/lib/ -lboost_regex-gcc34-mt-d-1_36As you can see, this method is just as terse as method A for one @@ -715,7 +715,7 @@ mailing list.
- Boost.Build mailing list
- Index of all Boost library documentation
-+Onward
Good luck, and have fun!
diff --git a/getting_started/windows.html b/getting_started/windows.html index 4ff1b03..4c46ca1 100644 --- a/getting_started/windows.html +++ b/getting_started/windows.html @@ -3,7 +3,7 @@ - +Boost Getting Started on Windows @@ -14,7 +14,7 @@ -+A note to Cygwin and MinGW users
If you plan to use your tools from the Windows command prompt, you're in the right place. If you plan to build from the Cygwin @@ -61,7 +61,7 @@ not supported—they may or may not work.
1 Get Boost
The most reliable way to get a copy of Boost is to -download boost_1_65_0.7z or boost_1_65_0.zip and unpack it to install a complete Boost +download boost_1_65_1.7z or boost_1_65_1.zip and unpack it to install a complete Boost distribution.1
@@ -71,7 +71,7 @@ distribution.12 The Boost Distribution
This is a sketch of the resulting directory structure:
-boost_1_65_0\ .................The “boost root directory” +boost_1_65_1\ .................The “boost root directory” index.htm .........A copy of www.boost.org starts here boost\ .........................All Boost Header files lib\ .....................precompiled library binaries @@ -116,7 +116,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_65_0) is +
- @@ -154,7 +154,7 @@ contains a subset of the Boost documentation. Start with
The path to the boost root directory (often C:\Program Files\boost\boost_1_65_1) is sometimes referred to as $BOOST_ROOT in documentation and mailing lists .
3 Header-Only Libraries
The first thing many people want to know is, “how do I build Boost?” The good news is that often, there's nothing to build.
-+Nothing to Build?
Most Boost libraries are header-only: they consist entirely of header files containing templates and inline functions, and @@ -228,7 +228,7 @@ int main() }
Copy the text of this program into a file called example.cpp.
-+Note
To build the examples in this guide, you can use an Integrated Development Environment (IDE) like Visual Studio, or @@ -256,7 +256,7 @@ cd path\to\some\directory
followed by Return. For example,
-cd C:\Program Files\boost\boost_1_65_0 +cd C:\Program Files\boost\boost_1_65_1Long commands can be continued across several lines by typing a caret (^) at the end of all but the last line. Some examples @@ -281,7 +281,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_65_0
+C:\Program Files\boost\boost_1_65_1
In Configuration Properties > C/C++ > Precompiled Headers, change @@ -319,7 +319,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_65_0 path\to\example.cpp +cl /EHsc /I path\to\boost_1_65_1 path\to\example.cppTo test the result, type:
@@ -387,7 +387,7 @@ the directory where you want Boost.Build to be installedFirst, find the toolset corresponding to your compiler in the following table (an up-to-date list is always available in the Boost.Build documentation).
-+Note
If you previously chose a toolset for the purposes of building b2, you should assume it won't work and instead @@ -488,8 +488,8 @@ b2 --build-dir=b please see the Boost.Build documentation.
For example, your session might look like this:3
-C:\WINDOWS> cd C:\Program Files\boost\boost_1_65_0 -C:\Program Files\boost\boost_1_65_0> b2 ^ +C:\WINDOWS> cd C:\Program Files\boost\boost_1_65_1 +C:\Program Files\boost\boost_1_65_1> b2 ^ More? --build-dir="C:\Documents and Settings\dave\build-boost" ^ More? --build-type=complete msvc stage@@ -506,7 +506,7 @@ list. library binaries in the stage\lib\ subdirectory of the Boost tree. To use a different directory pass the --stagedir=directory option to b2. -+Note
b2 is case-sensitive; it is important that all the parts shown in bold type above be entirely lower-case.
@@ -524,7 +524,7 @@ be interested in:- choosing a specific build variant by adding release or debug to the command line.
-+Note
Boost.Build can produce a great deal of output, which can make it easy to miss problems. If you want to make sure @@ -607,7 +607,7 @@ build settings. whose compile configuration is compatible with the rest of your project. -
+Auto-Linking
Most Windows compilers and linkers have so-called “auto-linking support,” which eliminates the second challenge. Special code in @@ -628,7 +628,7 @@ earlier:
select Properties from the resulting pop-up menu- In Configuration Properties > Linker > Additional Library Directories, enter the path to the Boost binaries, -e.g. C:\Program Files\boost\boost_1_65_0\lib\.
+e.g. C:\Program Files\boost\boost_1_65_1\lib\.- From the Build menu, select Build Solution.
@@ -638,15 +638,15 @@ e.g. C:\Program Files\boosFor example, we can compile and link the above program from the Visual C++ command-line by simply adding the bold text below to the command line we used earlier, assuming your Boost binaries are -in C:\Program Files\boost\boost_1_65_0\lib:
+in C:\Program Files\boost\boost_1_65_1\lib:-cl /EHsc /I path\to\boost_1_65_0 example.cpp ^ - /link /LIBPATH:C:\Program Files\boost\boost_1_65_0\lib +cl /EHsc /I path\to\boost_1_65_1 example.cpp ^ + /link /LIBPATH:C:\Program Files\boost\boost_1_65_1\lib6.3 Library Naming
-+Note
If, like Visual C++, your compiler supports auto-linking, you can probably skip to the next step.
@@ -785,7 +785,7 @@ mailing list.- Boost.Build mailing list
- Index of all Boost library documentation
-+Onward
Good luck, and have fun!
@@ -797,7 +797,7 @@ mailing list.[1] We recommend -downloading boost_1_65_0.7z and using 7-Zip to decompress +downloading boost_1_65_1.7z and using 7-Zip to decompress it. We no longer recommend .zip files for Boost because they are twice as large as the equivalent .7z files. We don't recommend using Windows' built-in decompression as it can be painfully slow for large archives.