Code::Blocks - User contributions [en]

Installing MinGW with Vista

2008-10-31T13:06:46Z

Dgg32: /* Compiler */

[[Category:User Documentation]]
--[[User:Darthdespotism|Darthdespotism]] 07:23, 29 June 2007 (UTC)
== Before we start ==

Before starting to install MinGW under Windows Vista there are some things to remember:

* MinGW '''must''' be located on the same partition as the files you want to compile
* There may be issues if you don't install MinGW in the toplevel folder (e.g. C:\MinGW) but in some folder (e.g. C:\Compilers\MinGW). There is a possible solution to this problem (see the "Troubleshooting" section at the bottom of this page).

For this HOWTO I used some Conventions:

* I assumed you are going to install in C:, if you want to install on another partition (which may be clever as the sources must be on the same partition) you'll have to modifie the path acordingly
* I used ''MinGW-Version'' to indicate that you must use your Version of MinGW here. As you can see on my pictures it is for me 4.2.0 and for those who downloaded on [http://mingw.org http://mingw.org] it is most probably 3.4.2

Just one thing left: I've done this under Vista Business and a friend of mine reported it working with Home Premium. I hope it works on the other versions, too.

== Getting MinGW ==
First of all you need the MinGW Compiler to be installed. I used the installer but all methods desciribed under [[MinGW installation]] should work fine. You may althoug want to upgrade your Version of MinGW to 4.* though. When you finished installing the basic MinGW we'll start making it work with Windows Vista. (Note: There is no need to set any %PATH% - variables when you use only Codeblocks, this is the way I'll focuse on)

== Actual Setup ==

=== Executeables ===
If you haven't already done it it is time to install and start Code::Blocks. It's a good idea to create a sample "console application" so you have a basic "Hello world" to test your progress. As I first tried to run "Compile" without any Modifications I got the following Error:

-------------- Build: Debug in test --------------- 
Compiling: main.cpp 
mingw32-g++.exe: CreateProcess: No such file or directory 
Process terminated with status 1 (0 minutes, 0 seconds) 
0 errors, 0 warnings

This doesn't tell us very much. The problem here actually is, that MinGW is unable to find its helper executeables, in this case cc1plus.exe. To fix this go to your "Settings" -> "Compiler and Debugger" -> "Toolchain executeables" -> "Additional paths" and add there the Directory "C:\MinGW\libexec\gcc\mingw32\''MinGW-Version'' where ''MinGW-Version'' is the Version of MinGW you are using. If you use a unmodified Version this is most probably 3.4.2, as I have the newer 4.2.0 I use this.

[[Image:mingw_vista_01.png]][[Image:mingw_vista_02.png]]

Let's try to compile again and see the progress.

=== Compiler ===

Hm still doesn't work, but the error changed:

-------------- Build: Debug in test --------------- 
Compiling: main.cpp 
C:\Users\Christoph\Projects\test\main.cpp:1:20: error: iostream: No such file or directory 
C:\Users\Christoph\Projects\test\main.cpp: In function 'int main()': 
C:\Users\Christoph\Projects\test\main.cpp:7: error: 'cout' was not declared in this scope 
C:\Users\Christoph\Projects\test\main.cpp:7: error: 'endl' was not declared in this scope 
Process terminated with status 1 (0 minutes, 1 seconds) 
3 errors, 0 warnings

So MinGW is not able to find <iostream>. Let's tell him where to search:

Still in the Compiler and Debugger dialogue go to "Search directories" -> "Compiler" and add:

C:\MinGW\include\ 
C:\MinGW\include\c++\''MinGW-Version'' 
C:\MinGW\include\c++\''MinGW-Version''\backward 
C:\MinGW\include\c++\''MinGW-Version''\mingw32 
C:\MinGW\lib\gcc\mingw32\''MinGW-Version''\include 

There are not necessarily all of them needed, but these are the directories MinGW searches in normally.

Try again to compile. The compiler should now execute normally, but there is a Linker error left:

=== Linker ===

Linking console executable: bin\Debug\test.exe 
ld: cannot find -lgcc 
Process terminated with status 1 (0 minutes, 1 seconds) 
1 errors, 0 warnings 

So we apparently need to tell MinGW where to search for it's librarys. This is again done by adding some "Search directories", but now we use the section "Linker"

: C:\MinGW\lib\gcc\mingw32\''MinGW-Version''

Try to compile, it should work.

[[Image:mingw_vista_03.png]][[Image:mingw_vista_04.png]]

=== Trouble shooting ===

If this does not work out for you there is some advice to figure it out on your own:

* If there is a file not found by MinGW use your search function to look for it, and add it where it belongs
** If it's an executeable (.exe) add it to the "additional paths" under "toolchain executeables"
** If it's a header (.h, .hpp or without extension) add it to "compiler" under "search directories"
** If it's a library (.o, .a) add it to "linker" under "search directories"
* Compile with the -v flag. You can do this by simply adding -v to "Build options" -> "Compiler" -> "Other options"
* Try entering the complete path to each program (for example, changing "mingw32-g++.exe" to "D:\toolkits\MinGW513\bin\mingw32-g++.exe"). This may allow projects to be compiled, regardless of which partition and folder MinGW is installed to. See [/index.php/topic,6422.0.html this forum thread] for more details.
--------------------------------------------

== '''An Easy Fix''' ==

I have been using this fix that was made available in the Mingw-Users list, by a kind a person. It works fine without having to do any abnormal modifications to your CodeBlocks setups.

----------------------------------
If it helps anyone else, I took the three patched drivers that Danny
posted (gcc, g++, collect2) and copied them to their various aliases
(e.g. c++, mingw-g++, etc) and put them in the appropriate directory
structure, and made it a tarball:

http://dessent.net/tmp/gcc-vista-3.4.5-20060117-1.tar.gz

$ tar ztvf gcc-vista-3.4.5-20060117-1.tar.gz
-rwxr-xr-x brian/None 86016 2007-05-18 18:41 bin/c++.exe
-rwxr-xr-x brian/None 86016 2007-05-18 18:41 bin/g++.exe
-rwxr-xr-x brian/None 83456 2007-05-18 18:40 bin/gcc.exe
-rwxr-xr-x brian/None 86016 2007-05-18 18:41 bin/mingw32-c++.exe
-rwxr-xr-x brian/None 86016 2007-05-18 18:41 bin/mingw32-g++.exe
-rwxr-xr-x brian/None 83456 2007-05-18 18:40 bin/mingw32-gcc-3.4.5
-rwxr-xr-x brian/None 83456 2007-05-18 18:40 bin/mingw32-gcc.exe
-rwx------ brian/None 85504 2007-05-18 18:41
libexec/gcc/mingw32/3.4.5/collect2.exe

If you unpack this in your MinGW root folder (e.g. /mingw) just like all
the other gcc-foo tarballs it should install the files in all the right
places. I tested this on a Vista copy running VMware and it worked fine
for compiling and linking C and C++.

(That's for 3.4.5 only.)

BoostWindowsQuickRef

2008-10-31T12:01:22Z

Dgg32: /* Test boost installation */

[[Category:User Documentation]]
'''''A beginner's quick reference for setting up Boost with Code::Blocks in Windows''''' 
Supported compilers: MinGW or MSVC

'''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].

== Download Boost ==
You can download the Boost source code and compile it yourself, or, ''only if you are using MSVC 2003 (7.1) or later'', you can use a web-based installer to download pre-built libraries.

=== Boost Source Code ===
The Boost libraries are distributed as source code archived in .7z, .tar.bz2, .tar.gz, or .zip format; choose whichever archive format is easiest for you to unpack. The current stable release of Boost is '''1.36.0'''. [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041&release_id=619445 Click here to browse the Boost 1.36.0 downloadable files]. You can check [http://www.boost.org/users/download/ the Boost download page] to see if a newer stable version is available.

You also need to download Boost Jam in order to build Boost. The current stable release of Boost Jam is '''3.1.16'''. [http://downloads.sourceforge.net/boost/boost-jam-3.1.16-1-ntx86.zip Click here to download Boost Jam for Windows] (boost-jam-3.1.16-1-ntx86.zip; 115 KB).

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

=== Boost Installer for MSVC 2003 (7.1) or later ===
BoostPro Computing distributes a free web-based installer that will download and install prebuilt versions of the Boost libraries for MSVC. [http://www.boostpro.com/products/free Click here to browse the BoostPro Free Downloads]. The amount of space used by the installation varies depending on which libraries and variants you choose.

== Build Boost ==
''This step is unnecessary if you are using the '''BoostPro installer''' ''

* 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.16-1-ntx86;%PATH%
* Change to the Boost sources directory (where <path> is the path you unpacked the Boost sources to):
cd <path>\boost_1_36_0
* Execute the build command. The recommended command to use for '''MinGW/GCC''' is (where <installpath> is where you want the Boost headers and libraries; typically C:\Program Files\CodeBlocks):
bjam --toolset=gcc "--prefix=<installpath>" install
* The recommended command to use for '''MSVC''' is (where <installpath> is where you want the Boost headers and libraries):
bjam --toolset=msvc "--prefix=<installpath>" install
* This step will generally take 5-20 minutes, depending on the capabilities of your PC.
* The above commands will build release, multithreaded, DLL versions of the Boost libraries. If you want other variants, add --build-type=complete to the command line. This will take a much longer amount of time to build.

== Add Boost to an existing project in Code::Blocks ==
The Boost libraries are usable in nearly any Code::Blocks project. You can create a new project that will use Boost or open an existing project. With your project open, perform these steps.

=== Set up a Code::Blocks global variable for Boost ===
This step only needs to be performed once, after which the global variable you've created will be available for any project.
* Open the Settings menu and select "Global variables..."
* Click the "New" button next to the Current variable list, specify a name like "boost", and hit OK
* 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_36" subfolder of your Boost installation -- it should be the path in the "base" field with "\include\boost-1_36" tacked on.
* Hit the Close button to save your global variable

=== Add Boost search directories to your project ===
* Right-click your project's name in the Projects section of the Management window and select "Build options..."
* 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 "$(#boost.include)" (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 "$(#boost.lib)" (without the quotes), and hit OK

=== Include Boost headers and link with Boost libraries ===
Your project is now ready to use the Boost libraries. For each library you want to use, do the following:
* #include <boost/*.hpp> in your source file
* In your project's build options, highlight the root of your project, select the "Linker settings" tab, and add "boost_*-mgw34-mt-1_36" to your Link libraries
For examle, use "#include <boost/filesystem.hpp>", "boost_filesystem-mgw34-mt-1_36.lib" and "boost_system-mgw34-mt-1_36.lib" to use boost.filesystem.

== Test boost installation==
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.

== Frequently Asked Questions ==

No Frequently Asked Questions (or Frequently Given Answers) have been entered yet.

BoostWindowsQuickRef

2008-10-31T12:00:48Z

Dgg32: /* Test boost installation */

[[Category:User Documentation]]
'''''A beginner's quick reference for setting up Boost with Code::Blocks in Windows''''' 
Supported compilers: MinGW or MSVC

'''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].

== Download Boost ==
You can download the Boost source code and compile it yourself, or, ''only if you are using MSVC 2003 (7.1) or later'', you can use a web-based installer to download pre-built libraries.

=== Boost Source Code ===
The Boost libraries are distributed as source code archived in .7z, .tar.bz2, .tar.gz, or .zip format; choose whichever archive format is easiest for you to unpack. The current stable release of Boost is '''1.36.0'''. [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041&release_id=619445 Click here to browse the Boost 1.36.0 downloadable files]. You can check [http://www.boost.org/users/download/ the Boost download page] to see if a newer stable version is available.

You also need to download Boost Jam in order to build Boost. The current stable release of Boost Jam is '''3.1.16'''. [http://downloads.sourceforge.net/boost/boost-jam-3.1.16-1-ntx86.zip Click here to download Boost Jam for Windows] (boost-jam-3.1.16-1-ntx86.zip; 115 KB).

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

=== Boost Installer for MSVC 2003 (7.1) or later ===
BoostPro Computing distributes a free web-based installer that will download and install prebuilt versions of the Boost libraries for MSVC. [http://www.boostpro.com/products/free Click here to browse the BoostPro Free Downloads]. The amount of space used by the installation varies depending on which libraries and variants you choose.

== Build Boost ==
''This step is unnecessary if you are using the '''BoostPro installer''' ''

* 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.16-1-ntx86;%PATH%
* Change to the Boost sources directory (where <path> is the path you unpacked the Boost sources to):
cd <path>\boost_1_36_0
* Execute the build command. The recommended command to use for '''MinGW/GCC''' is (where <installpath> is where you want the Boost headers and libraries; typically C:\Program Files\CodeBlocks):
bjam --toolset=gcc "--prefix=<installpath>" install
* The recommended command to use for '''MSVC''' is (where <installpath> is where you want the Boost headers and libraries):
bjam --toolset=msvc "--prefix=<installpath>" install
* This step will generally take 5-20 minutes, depending on the capabilities of your PC.
* The above commands will build release, multithreaded, DLL versions of the Boost libraries. If you want other variants, add --build-type=complete to the command line. This will take a much longer amount of time to build.

== Add Boost to an existing project in Code::Blocks ==
The Boost libraries are usable in nearly any Code::Blocks project. You can create a new project that will use Boost or open an existing project. With your project open, perform these steps.

=== Set up a Code::Blocks global variable for Boost ===
This step only needs to be performed once, after which the global variable you've created will be available for any project.
* Open the Settings menu and select "Global variables..."
* Click the "New" button next to the Current variable list, specify a name like "boost", and hit OK
* 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_36" subfolder of your Boost installation -- it should be the path in the "base" field with "\include\boost-1_36" tacked on.
* Hit the Close button to save your global variable

=== Add Boost search directories to your project ===
* Right-click your project's name in the Projects section of the Management window and select "Build options..."
* 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 "$(#boost.include)" (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 "$(#boost.lib)" (without the quotes), and hit OK

=== Include Boost headers and link with Boost libraries ===
Your project is now ready to use the Boost libraries. For each library you want to use, do the following:
* #include <boost/*.hpp> in your source file
* In your project's build options, highlight the root of your project, select the "Linker settings" tab, and add "boost_*-mgw34-mt-1_36" to your Link libraries
For examle, use "#include <boost/filesystem.hpp>", "boost_filesystem-mgw34-mt-1_36.lib" and "boost_system-mgw34-mt-1_36.lib" to use boost.filesystem.

== Test boost installation==
After the installation is finished, 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.

== Frequently Asked Questions ==

No Frequently Asked Questions (or Frequently Given Answers) have been entered yet.

BoostWindowsQuickRef

2008-10-31T12:00:28Z

Dgg32: /* Test boost installation */

[[Category:User Documentation]]
'''''A beginner's quick reference for setting up Boost with Code::Blocks in Windows''''' 
Supported compilers: MinGW or MSVC

'''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].

== Download Boost ==
You can download the Boost source code and compile it yourself, or, ''only if you are using MSVC 2003 (7.1) or later'', you can use a web-based installer to download pre-built libraries.

=== Boost Source Code ===
The Boost libraries are distributed as source code archived in .7z, .tar.bz2, .tar.gz, or .zip format; choose whichever archive format is easiest for you to unpack. The current stable release of Boost is '''1.36.0'''. [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041&release_id=619445 Click here to browse the Boost 1.36.0 downloadable files]. You can check [http://www.boost.org/users/download/ the Boost download page] to see if a newer stable version is available.

You also need to download Boost Jam in order to build Boost. The current stable release of Boost Jam is '''3.1.16'''. [http://downloads.sourceforge.net/boost/boost-jam-3.1.16-1-ntx86.zip Click here to download Boost Jam for Windows] (boost-jam-3.1.16-1-ntx86.zip; 115 KB).

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

=== Boost Installer for MSVC 2003 (7.1) or later ===
BoostPro Computing distributes a free web-based installer that will download and install prebuilt versions of the Boost libraries for MSVC. [http://www.boostpro.com/products/free Click here to browse the BoostPro Free Downloads]. The amount of space used by the installation varies depending on which libraries and variants you choose.

== Build Boost ==
''This step is unnecessary if you are using the '''BoostPro installer''' ''

* 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.16-1-ntx86;%PATH%
* Change to the Boost sources directory (where <path> is the path you unpacked the Boost sources to):
cd <path>\boost_1_36_0
* Execute the build command. The recommended command to use for '''MinGW/GCC''' is (where <installpath> is where you want the Boost headers and libraries; typically C:\Program Files\CodeBlocks):
bjam --toolset=gcc "--prefix=<installpath>" install
* The recommended command to use for '''MSVC''' is (where <installpath> is where you want the Boost headers and libraries):
bjam --toolset=msvc "--prefix=<installpath>" install
* This step will generally take 5-20 minutes, depending on the capabilities of your PC.
* The above commands will build release, multithreaded, DLL versions of the Boost libraries. If you want other variants, add --build-type=complete to the command line. This will take a much longer amount of time to build.

== Add Boost to an existing project in Code::Blocks ==
The Boost libraries are usable in nearly any Code::Blocks project. You can create a new project that will use Boost or open an existing project. With your project open, perform these steps.

=== Set up a Code::Blocks global variable for Boost ===
This step only needs to be performed once, after which the global variable you've created will be available for any project.
* Open the Settings menu and select "Global variables..."
* Click the "New" button next to the Current variable list, specify a name like "boost", and hit OK
* 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_36" subfolder of your Boost installation -- it should be the path in the "base" field with "\include\boost-1_36" tacked on.
* Hit the Close button to save your global variable

=== Add Boost search directories to your project ===
* Right-click your project's name in the Projects section of the Management window and select "Build options..."
* 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 "$(#boost.include)" (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 "$(#boost.lib)" (without the quotes), and hit OK

=== Include Boost headers and link with Boost libraries ===
Your project is now ready to use the Boost libraries. For each library you want to use, do the following:
* #include <boost/*.hpp> in your source file
* In your project's build options, highlight the root of your project, select the "Linker settings" tab, and add "boost_*-mgw34-mt-1_36" to your Link libraries
For examle, use "#include <boost/filesystem.hpp>", "boost_filesystem-mgw34-mt-1_36.lib" and "boost_system-mgw34-mt-1_36.lib" to use boost.filesystem.

== Test boost installation==
After the installation is finished, you can use these[http://beans.seartipy.com/2006/03/16/how-to-test-c-boost-installation/ How to Test C++ Boost Installation] two examples to test whether your boost installation and the configuration of your Code::Blocks are successful.

== Frequently Asked Questions ==

No Frequently Asked Questions (or Frequently Given Answers) have been entered yet.

BoostWindowsQuickRef

2008-10-31T11:59:49Z

Dgg32:

[[Category:User Documentation]]
'''''A beginner's quick reference for setting up Boost with Code::Blocks in Windows''''' 
Supported compilers: MinGW or MSVC

'''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].

== Download Boost ==
You can download the Boost source code and compile it yourself, or, ''only if you are using MSVC 2003 (7.1) or later'', you can use a web-based installer to download pre-built libraries.

=== Boost Source Code ===
The Boost libraries are distributed as source code archived in .7z, .tar.bz2, .tar.gz, or .zip format; choose whichever archive format is easiest for you to unpack. The current stable release of Boost is '''1.36.0'''. [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041&release_id=619445 Click here to browse the Boost 1.36.0 downloadable files]. You can check [http://www.boost.org/users/download/ the Boost download page] to see if a newer stable version is available.

You also need to download Boost Jam in order to build Boost. The current stable release of Boost Jam is '''3.1.16'''. [http://downloads.sourceforge.net/boost/boost-jam-3.1.16-1-ntx86.zip Click here to download Boost Jam for Windows] (boost-jam-3.1.16-1-ntx86.zip; 115 KB).

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

=== Boost Installer for MSVC 2003 (7.1) or later ===
BoostPro Computing distributes a free web-based installer that will download and install prebuilt versions of the Boost libraries for MSVC. [http://www.boostpro.com/products/free Click here to browse the BoostPro Free Downloads]. The amount of space used by the installation varies depending on which libraries and variants you choose.

== Build Boost ==
''This step is unnecessary if you are using the '''BoostPro installer''' ''

* 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.16-1-ntx86;%PATH%
* Change to the Boost sources directory (where <path> is the path you unpacked the Boost sources to):
cd <path>\boost_1_36_0
* Execute the build command. The recommended command to use for '''MinGW/GCC''' is (where <installpath> is where you want the Boost headers and libraries; typically C:\Program Files\CodeBlocks):
bjam --toolset=gcc "--prefix=<installpath>" install
* The recommended command to use for '''MSVC''' is (where <installpath> is where you want the Boost headers and libraries):
bjam --toolset=msvc "--prefix=<installpath>" install
* This step will generally take 5-20 minutes, depending on the capabilities of your PC.
* The above commands will build release, multithreaded, DLL versions of the Boost libraries. If you want other variants, add --build-type=complete to the command line. This will take a much longer amount of time to build.

== Add Boost to an existing project in Code::Blocks ==
The Boost libraries are usable in nearly any Code::Blocks project. You can create a new project that will use Boost or open an existing project. With your project open, perform these steps.

=== Set up a Code::Blocks global variable for Boost ===
This step only needs to be performed once, after which the global variable you've created will be available for any project.
* Open the Settings menu and select "Global variables..."
* Click the "New" button next to the Current variable list, specify a name like "boost", and hit OK
* 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_36" subfolder of your Boost installation -- it should be the path in the "base" field with "\include\boost-1_36" tacked on.
* Hit the Close button to save your global variable

=== Add Boost search directories to your project ===
* Right-click your project's name in the Projects section of the Management window and select "Build options..."
* 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 "$(#boost.include)" (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 "$(#boost.lib)" (without the quotes), and hit OK

=== Include Boost headers and link with Boost libraries ===
Your project is now ready to use the Boost libraries. For each library you want to use, do the following:
* #include <boost/*.hpp> in your source file
* In your project's build options, highlight the root of your project, select the "Linker settings" tab, and add "boost_*-mgw34-mt-1_36" to your Link libraries
For examle, use "#include <boost/filesystem.hpp>", "boost_filesystem-mgw34-mt-1_36.lib" and "boost_system-mgw34-mt-1_36.lib" to use boost.filesystem.

== Test boost installation==
After the installation is finished, 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.

== Frequently Asked Questions ==

No Frequently Asked Questions (or Frequently Given Answers) have been entered yet.

BoostWindowsQuickRef

2008-10-31T11:52:52Z

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

[[Category:User Documentation]]
'''''A beginner's quick reference for setting up Boost with Code::Blocks in Windows''''' 
Supported compilers: MinGW or MSVC

'''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].

== Download Boost ==
You can download the Boost source code and compile it yourself, or, ''only if you are using MSVC 2003 (7.1) or later'', you can use a web-based installer to download pre-built libraries.

=== Boost Source Code ===
The Boost libraries are distributed as source code archived in .7z, .tar.bz2, .tar.gz, or .zip format; choose whichever archive format is easiest for you to unpack. The current stable release of Boost is '''1.36.0'''. [http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=8041&release_id=619445 Click here to browse the Boost 1.36.0 downloadable files]. You can check [http://www.boost.org/users/download/ the Boost download page] to see if a newer stable version is available.

You also need to download Boost Jam in order to build Boost. The current stable release of Boost Jam is '''3.1.16'''. [http://downloads.sourceforge.net/boost/boost-jam-3.1.16-1-ntx86.zip Click here to download Boost Jam for Windows] (boost-jam-3.1.16-1-ntx86.zip; 115 KB).

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

=== Boost Installer for MSVC 2003 (7.1) or later ===
BoostPro Computing distributes a free web-based installer that will download and install prebuilt versions of the Boost libraries for MSVC. [http://www.boostpro.com/products/free Click here to browse the BoostPro Free Downloads]. The amount of space used by the installation varies depending on which libraries and variants you choose.

== Build Boost ==
''This step is unnecessary if you are using the '''BoostPro installer''' ''

* 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.16-1-ntx86;%PATH%
* Change to the Boost sources directory (where <path> is the path you unpacked the Boost sources to):
cd <path>\boost_1_36_0
* Execute the build command. The recommended command to use for '''MinGW/GCC''' is (where <installpath> is where you want the Boost headers and libraries; typically C:\Program Files\CodeBlocks):
bjam --toolset=gcc "--prefix=<installpath>" install
* The recommended command to use for '''MSVC''' is (where <installpath> is where you want the Boost headers and libraries):
bjam --toolset=msvc "--prefix=<installpath>" install
* This step will generally take 5-20 minutes, depending on the capabilities of your PC.
* The above commands will build release, multithreaded, DLL versions of the Boost libraries. If you want other variants, add --build-type=complete to the command line. This will take a much longer amount of time to build.

== Add Boost to an existing project in Code::Blocks ==
The Boost libraries are usable in nearly any Code::Blocks project. You can create a new project that will use Boost or open an existing project. With your project open, perform these steps.

=== Set up a Code::Blocks global variable for Boost ===
This step only needs to be performed once, after which the global variable you've created will be available for any project.
* Open the Settings menu and select "Global variables..."
* Click the "New" button next to the Current variable list, specify a name like "boost", and hit OK
* 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_36" subfolder of your Boost installation -- it should be the path in the "base" field with "\include\boost-1_36" tacked on.
* Hit the Close button to save your global variable

=== Add Boost search directories to your project ===
* Right-click your project's name in the Projects section of the Management window and select "Build options..."
* 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 "$(#boost.include)" (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 "$(#boost.lib)" (without the quotes), and hit OK

=== Include Boost headers and link with Boost libraries ===
Your project is now ready to use the Boost libraries. For each library you want to use, do the following:
* #include <boost/*.hpp> in your source file
* In your project's build options, highlight the root of your project, select the "Linker settings" tab, and add "boost_*-mgw34-mt-1_36" to your Link libraries
For examle, use "#include <boost/filesystem.hpp>", "boost_filesystem-mgw34-mt-1_36" and "boost_system-mgw34-mt-1_36" to use boost.filesystem.

== Frequently Asked Questions ==

No Frequently Asked Questions (or Frequently Given Answers) have been entered yet.