BoostWindowsQuickRef - Revision history

Ravenspoint: fix path change commands

2014-04-06T15:33:39Z

fix path change commands

Ravenspoint: /* Build Boost */

2014-03-28T17:18:29Z

Build Boost

Ravenspoint: /* Frequently Asked Questions */

2014-03-28T16:03:23Z

Frequently Asked Questions

Thistleknot: /* Include Boost headers and link with Boost libraries */

2012-10-12T09:35:38Z

Include Boost headers and link with Boost libraries

Thistleknot: /* Include Boost headers and link with Boost libraries */

2012-10-12T09:16:01Z

Include Boost headers and link with Boost libraries

Thistleknot: /* Test boost installation */

2012-10-12T09:15:40Z

Test boost installation

Thistleknot: /* Test boost installation */

2012-10-12T09:15:19Z

Test boost installation

Gring: Added that you can use bootstrap.bat to build bjam.exe

2012-05-13T18:32:42Z

Added that you can use bootstrap.bat to build bjam.exe

Alpha: Spelling.

2012-02-12T19:04:51Z

Spelling.

MortenMacFly: /* Add Boost search directories to your project */

2012-02-11T14:53:29Z

Add Boost search directories to your project

@@ Line 32: / Line 32: @@
 * Open up a command prompt for building. If you are using MinGW/GCC, simply use the standard Windows command shell (open the Start menu, click "Run...", enter "cmd" and hit OK). If you are using MSVC, you should use the special command shell which sets up the correct environment variables for you. If you use a version of MSVC which required you to download the Platform SDK separately, ensure that whichever command environment you use includes the Platform SDK tools and paths as well as the standard compiler tools and paths.
 * Ensure that Boost Jam is in the PATH environment variable (where <path> is the path you unpacked Boost Jam to):
-  set PATH=<path>\boost-jam-3.1.18-1-ntx86;%PATH%
+  PATH <path>\boost-jam-3.1.18-1-ntx86;%PATH%
 * Ensure that the compiler is in the PATH environment variable:
-  set PATH="C:\Program Files (x86)\CodeBlocks\MinGW\bin";%PATH%
+  PATH C:\Program Files (x86)\CodeBlocks\MinGW\bin;%PATH%
 * Change to the Boost sources directory (where <path> is the path you unpacked the Boost sources to):
   cd /D <path>\boost_1_47_0

@@ Line 33: / Line 33: @@
 * Ensure that Boost Jam is in the PATH environment variable (where <path> is the path you unpacked Boost Jam to):
   set PATH=<path>\boost-jam-3.1.18-1-ntx86;%PATH%
 * Change to the Boost sources directory (where <path> is the path you unpacked the Boost sources to):
   cd /D <path>\boost_1_47_0

← Older revision		Revision as of 16:03, 28 March 2014
Line 84:		Line 84:
	'''Do I need to link with a library for every Boost component I use?'''		'''Do I need to link with a library for every Boost component I use?'''

−	No. Only some of the Boost components require pre-compilation and additional linked-in code. You can even skip building Boost altogether, if you'll only need components without a link-time library. If you want to know whether a specific component requires a pre-built library, just try including the header(s) without making any linker additions. If you get undefined reference errors, you'll need to add the component's library. Boost maintains a [http://www.boost.org/doc/libs/1_47_0/more/getting_started/windows.html#header-only-libraries list] of which libraries require pre-compilation. (An undefined reference error including <tt>WSA</tt> requires the windows sockets ~~library~~, <tt>ws2_32</tt>.)	+	No. Only some of the Boost components require pre-compilation and additional linked-in code. You can even skip building Boost altogether, if you'll only need components without a link-time library. If you want to know whether a specific component requires a pre-built library, just try including the header(s) without making any linker additions. If you get undefined reference errors, you'll need to add the component's library. Boost maintains a [http://www.boost.org/doc/libs/1_47_0/more/getting_started/windows.html#header-only-libraries list] of which libraries require pre-compilation. (An undefined reference error including <tt>WSA</tt> requires the windows sockets libraries, <tt>ws2_32</tt> and <tt>wsock32</tt>.)

@@ Line 71: / Line 71: @@
 settings compiler & debugger linker settings add
-example:" f:\codeblocks\lib\*.a
+examples: (order does matter)
 == Test boost installation==

@@ Line 68: / Line 68: @@
 * In your project's build options, highlight the root of your project, select the "Linker settings" tab, and add "<tt>boost_*-mgwXX-mt-1_47</tt>" to your Link libraries
 For example, use "<tt>#include <boost/filesystem.hpp></tt>", "<tt>boost_filesystem-mgw45-mt-1_47</tt>" and "<tt>boost_system-mgw45-mt-1_47</tt>" to use boost.filesystem.
 == Test boost installation==

← Older revision		Revision as of 09:15, 12 October 2012
Line 72:		Line 72:
	After the installation, you can use these [http://beans.seartipy.com/2006/03/16/how-to-test-c-boost-installation/ two examples] to test whether your boost installation and the configuration of your Code::Blocks are successful. If it fails, [/index.php/topic,15164.0.html this post] may have some useful information.		After the installation, you can use these [http://beans.seartipy.com/2006/03/16/how-to-test-c-boost-installation/ two examples] to test whether your boost installation and the configuration of your Code::Blocks are successful. If it fails, [/index.php/topic,15164.0.html this post] may have some useful information.

		+	settings compiler & debugger linker settings add
		+
		+	example:" f:\codeblocks\lib\*.a

	== Frequently Asked Questions ==		== Frequently Asked Questions ==

← Older revision		Revision as of 18:32, 13 May 2012
Line 16:		Line 16:

	You also need to download Boost Jam in order to build Boost. The current stable release of Boost Jam is '''3.1.18'''. [http://sourceforge.net/projects/boost/files/boost-jam/3.1.18/boost-jam-3.1.18-1-ntx86.zip Click here to download Boost Jam for Windows] (boost-jam-3.1.18-1-ntx86.zip; 121.4 KB).		You also need to download Boost Jam in order to build Boost. The current stable release of Boost Jam is '''3.1.18'''. [http://sourceforge.net/projects/boost/files/boost-jam/3.1.18/boost-jam-3.1.18-1-ntx86.zip Click here to download Boost Jam for Windows] (boost-jam-3.1.18-1-ntx86.zip; 121.4 KB).
		+
		+	Note: Downloading precompiled bjam seems to be an outdated method.
		+	To build bjam from source, use bootstrap.bat from Boost base directory.
		+	Bootstrap.bat assumes you are using msvc compiler, to use Gcc, type "bootstrap.bat gcc"

	'''It is highly recommended that you unpack both archives to paths without spaces.''' You should choose a volume with at least 1.5 GB of free space. Typically, the Boost sources and Boost Jam are unpacked in separate locations, ending up with "<path>\boost_1_47_0" and "<path>\boost-jam-3.1.18-1-ntx86".		'''It is highly recommended that you unpack both archives to paths without spaces.''' You should choose a volume with at least 1.5 GB of free space. Typically, the Boost sources and Boost Jam are unpacked in separate locations, ending up with "<path>\boost_1_47_0" and "<path>\boost-jam-3.1.18-1-ntx86".

@@ Line 6: / Line 6: @@
 '''Important Requirements:'''
 * '''Windows compiler''' - You need to have correctly installed the free [http://www.mingw.org/ MinGW/GCC] compiler or one of [http://msdn.microsoft.com/vstudio/ Microsoft's compilers] (the [http://msdn.microsoft.com/vstudio/express/ Express editions] are free, but you must also install the [http://www.microsoft.com/downloads/details.aspx?familyid=0baf2b35-c656-4969-ace8-e4c0c0716adb Platform SDK]). The [https://www.codeblocks.org/downloads/5#windows latest stable release of Code::Blocks] includes a MinGW-bundled version which includes all necessary packages; or, if you install it by hand, you need at least the gcc-core, gcc-g++, binutils, w32api, and mingw32-make packages. Also, ensure that the folder containing the compiler executables (typically C:\Program Files\CodeBlocks\bin) is in your [http://vlaurie.com/computers2/Articles/environment.htm#editing Windows PATH environment variable].
-* '''Recent version of Code::Blocks''' - You need to have successfully installed and run a recent version of Code::Blocks -- either [https://www.codeblocks.org/downloads/5#windows the latest stable release] or [/index.php/board,20.0.html a recent nightly build].
+* '''Recent version of Code::Blocks''' - You need to have successfully installed and run a recent version of Code::Blocks – either [https://www.codeblocks.org/downloads/5#windows the latest stable release] or [/index.php/board,20.0.html a recent nightly build].
@@ Line 48: / Line 48: @@
 * In the "base" field of the Builtin fields section, browse for the base of your Boost installation -- the path you specified in the --prefix option of the build command
 <!-- * In the "include" field, browse for the "include\boost-1_47" subfolder of your Boost installation -- it should be the path in the "base" field with "\include\boost-1_42" tacked on. Not valid anymore. -->
-* In the "lib" field, brows for the "stage\lib" subfolder of your Boost installation -- it should be the path in the "base" field with "\stage\lib" tacked on. (This is the folder that contains either multiple <tt>lib*.a</tt> or <tt>*.lib</tt> files.)
+* In the "lib" field, browse for the "stage\lib" subfolder of your Boost installation -- it should be the path in the "base" field with "\stage\lib" tacked on. (This is the folder that contains either multiple <tt>lib*.a</tt> or <tt>*.lib</tt> files.)
 * Hit the Close button to save your global variable

@@ Line 55: / Line 55: @@
 * Highlight the root of your project in the tree on the left side of the Project build options window
 * Select the "Search directories" tab
-* With the "Compiler" subtab selected, click the Add button, enter "<tt>$(#boost)</tt>" (without the quotes), and hit OK
+* With the "Compiler" subtab selected, click the Add button, enter "<tt>$(#boost.include)</tt>" (without the quotes), and hit OK
 ''If you are using the bundled version of MinGW with Code::Blocks, and you used your C::B installation in the --prefix option as recommended, the following step is unnecessary''
 * With the "Linker" subtab selected, click the Add button, enter "<tt>$(#boost.lib)</tt>" (without the quotes), and hit OK