From 1bb3254d4d3195aeaa050004a89f552195e4c65b Mon Sep 17 00:00:00 2001 From: Dave Abrahams Date: Sun, 29 Dec 2002 16:53:48 +0000 Subject: [PATCH] Check in changes from Brett Calcott [SVN r16716] --- doc/building.html | 61 ++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 60 insertions(+), 1 deletion(-) diff --git a/doc/building.html b/doc/building.html index 000aeb3e..45951aa8 100644 --- a/doc/building.html +++ b/doc/building.html @@ -50,6 +50,8 @@
Building your Extension Module
Build Variants
+ +
Building Using the Microsoft Visual Studio IDE
@@ -308,6 +310,63 @@ bjam -sTOOLS=Python.h, or you will have link incompatibilities.

+ +

Building Using the Microsoft Visual + Studio IDE

+ +

For the those of you who feel more comfortable in the IDE + world, a workspace and project file have been included in the libs/python/build/visual_studio + subdirectory. It builds release and debug versions of the + Boost.Python libraries and places them and the same directory as + Jamfile build does, though the intermediate object files are + placed in a different directory. The files have been created using + Microsoft Visual C++ version 6, but they should work for later + versions as well. You will need to tell the IDE where to find the + Python Include/ and Libs/ directories. + Under Tools>Options>Directories, add an entry for the + Python include dir (i.e. c:/Python22/Include), and + one for the Lib (i.e. c:/Python/Libs. Make sure it + is Libs with an "s" and not just + Lib). + +

Using the IDE for you own projects

+ +

Building your own projects using the IDE is slightly more + complicated. Firstly, you need to make sure that the project you + create as the right kind. It should be a "Win32 Dynamic-Link + Library". The default one that Visual Studio 6 creates needs + some modifications: turn on RTTI, and change the debug and release + builds to use the respective debug and release Multithreaded DLL + versions. You should probably turn off incremental linking too -- + I believe it a bit flaky. If you do this, then change the "Debug + Info" to "Program Database" to get rid of the Edit and Continue + warning. +

+ +

You'll need to add the Boost root directory under + Tools>Options>Directories to get your code compiling. To + make it link, add the above boost_python.dsp file to your + workspace, and make your project depend upon it (under + Project>Dependencies). You should be able to build now. +

+ +

Lastly, go to the Project Settings>Debug Page and add + the Python.exe as the executable for the project. + Set a startup directory, and make sure that your current project's + output dll, the boost_python.dll and the + python22.dll are on the current PATH. + If you have a python script that tests your dll, then add it in + the "Program Arguments". Now, if all went well, you + should be able to hit the Run (F5) button, and debug your code. +

+ +
+The Visual Studio project files are graciously contributed and +maintained by Brett +Calcott. +
+

© Copyright David Abrahams 2002. Permission to copy, use, modify, @@ -316,7 +375,7 @@ bjam -sTOOLS= -

Updated: O8 October, 2002 (David Abrahams)

+

Updated: 29 December, 2002 (David Abrahams)