diff options
author | Martin v. Löwis <martin@v.loewis.de> | 2004-12-30 10:44:32 (GMT) |
---|---|---|
committer | Martin v. Löwis <martin@v.loewis.de> | 2004-12-30 10:44:32 (GMT) |
commit | 658b50f579d78f078ca66c41038bc9a927840ec0 (patch) | |
tree | 6dcb2c689c1ac3410e47a11e6f416ae7a512ea02 /Doc | |
parent | ee1d24703ffc0ef91ca43a71fb691255e18e162e (diff) | |
download | cpython-658b50f579d78f078ca66c41038bc9a927840ec0.zip cpython-658b50f579d78f078ca66c41038bc9a927840ec0.tar.gz cpython-658b50f579d78f078ca66c41038bc9a927840ec0.tar.bz2 |
Update to VC 7.1. Will backport to 2.4.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/ext/windows.tex | 108 |
1 files changed, 54 insertions, 54 deletions
diff --git a/Doc/ext/windows.tex b/Doc/ext/windows.tex index 46767fa..9dc7a58 100644 --- a/Doc/ext/windows.tex +++ b/Doc/ext/windows.tex @@ -39,10 +39,11 @@ Python extensions written in C or \Cpp. To build extensions using these instructions, you need to have a copy of the Python sources of the same version as your installed Python. You will need Microsoft Visual \Cpp{} ``Developer Studio''; project -files are supplied for V\Cpp{} version 6, but you can use older -versions of V\Cpp. The example files described here are distributed -with the Python sources in the \file{PC\textbackslash -example_nt\textbackslash} directory. +files are supplied for V\Cpp{} version 7.1, but you can use older +versions of V\Cpp. Notice that you should use the same version of +V\Cpp that was used to build Python itself. The example files +described here are distributed with the Python sources in the +\file{PC\textbackslash example_nt\textbackslash} directory. \begin{enumerate} \item @@ -57,9 +58,9 @@ example_nt\textbackslash} directory. \item \strong{Open the project}\\ - From V\Cpp, use the \menuselection{File \sub Open Workspace} + From V\Cpp, use the \menuselection{File \sub Open Solution} dialog (not \menuselection{File \sub Open}!). Navigate to and - select the file \file{example.dsw}, in the \emph{copy} of the + select the file \file{example.sln}, in the \emph{copy} of the \file{example_nt} directory you made above. Click Open. \item @@ -69,18 +70,17 @@ example_nt\textbackslash} directory. \begin{enumerate} \item Select a configuration. This step is optional. Choose - \menuselection{Build \sub Select Active Configuration} and - select either \guilabel{example - Win32 Release} or - \guilabel{example - Win32 Debug}. If you skip this step, + \menuselection{Build \sub Configuration Manager \sub Active + Solution Configuration} and select either \guilabel{Release} + or\guilabel{Debug}. If you skip this step, V\Cpp{} will use the Debug configuration by default. \item Build the DLL. Choose \menuselection{Build \sub Build - example_d.dll} in Debug mode, or \menuselection{Build \sub - Build example.dll} in Release mode. This creates all - intermediate and result files in a subdirectory called either - \file{Debug} or \file{Release}, depending on which - configuration you selected in the preceding step. + Solution}. This creates all intermediate and result files in + a subdirectory called either \file{Debug} or \file{Release}, + depending on which configuration you selected in the preceding + step. \end{enumerate} \item @@ -129,7 +129,7 @@ Hello, world Now your options are: \begin{enumerate} - \item Copy \file{example.dsw} and \file{example.dsp}, rename + \item Copy \file{example.sln} and \file{example.vcproj}, rename them to \file{spam.*}, and edit them by hand, or \item Create a brand new project; instructions are below. \end{enumerate} @@ -142,62 +142,62 @@ Hello, world little file with only two lines. An alternative approach is to forget about the \file{.def} file, and add the option \programopt{/export:initspam} somewhere to the Link settings, by - manually editing the setting in Project Options dialog). + manually editing the setting in Project Properties dialog). \item \strong{Creating a brand new project}\\ - Use the \menuselection{File \sub New \sub Projects} dialog to - create a new Project Workspace. Select \guilabel{Win32 Dynamic-Link - Library}, enter the name (\samp{spam}), and make sure the - Location is set to the \file{spam} directory you have created - (which should be a direct subdirectory of the Python build tree, a - sibling of \file{Include} and \file{PC}). Select Win32 as the - platform (in my version, this is the only choice). Make sure the - Create new workspace radio button is selected. Click OK. - - Now open the \menuselection{Project \sub Settings} dialog. You - only need to change a few settings. Make sure All Configurations - is selected from the Settings for: dropdown list. Select the - C/\Cpp{} tab. Choose the Preprocessor category in the popup menu - at the top. Type the following text in the entry box labeled - \guilabel{Additional include directories}: + Use the \menuselection{File \sub New \sub Project} dialog to + create a new Project Workspace. Select \guilabel{Visual C++ + Projects/Win32/ Win32 Project}, enter the name (\samp{spam}), and + make sure the Location is set to parent of the \file{spam} + directory you have created (which should be a direct subdirectory + of the Python build tree, a sibling of \file{Include} and + \file{PC}). Select Win32 as the platform (in my version, this is + the only choice). Make sure the Create new workspace radio button + is selected. Click OK. + + You should now create the file \file{spam.def} as instructed in + the previous section. Add the source files to the project, using + \menuselection{Project \sub Add Existing Item}. Set the pattern to + \code{*.*} and select both \file{spam.c} and \file{spam.def} and + click OK. (Inserting them one by one is fine too.) + + Now open the \menuselection{Project \sub spam properties} dialog. + You only need to change a few settings. Make sure \guilable{All + Configurations} is selected from the \guilable{Settings for:} + dropdown list. Select the C/\Cpp{} tab. Choose the General + category in the popup menu at the top. Type the following text in + the entry box labeled \guilabel{Additional Include Directories}: \begin{verbatim} ..\Include,..\PC \end{verbatim} - Then, choose the Input category in the Link tab, and enter + Then, choose the General category in the Linker tab, and enter \begin{verbatim} ..\PCbuild \end{verbatim} - in the text box labelled \guilabel{Additional library path}. + in the text box labelled \guilabel{Additional library Directories}. Now you need to add some mode-specific settings: - Select \guilabel{Win32 Release} in the \guilabel{Settings for} + Select \guilabel{Release} in the \guilabel{Configuration} dropdown list. Choose the \guilabel{Link} tab, choose the - \guilabel{Input Category}, and append \code{pythonXY.lib} to the - list in the \guilabel{Object/library modules} box. - - Select \guilabel{Win32 Debug} in the \guilabel{Settings for} - dropdown list, and append \code{pythonXY_d.lib} to the list in the - \guilabel{Object/library modules} box. Then click the C/\Cpp{} - tab, select \guilabel{Code Generation} from the - \guilabel{Category} dropdown list, and select \guilabel{Debug - Multithreaded DLL} from the \guilabel{Use run-time library} dropdown - list. - - Select \guilabel{Win32 Release} again from the \guilabel{Settings - for} dropdown list. Select \guilabel{Multithreaded DLL} from the - \guilabel{Use run-time library:} dropdown list. - - You should now create the file \file{spam.def} as instructed in the - previous section. Then chose the \menuselection{Insert \sub Files - into Project} dialog. Set the pattern to \code{*.*} and select - both \file{spam.c} and \file{spam.def} and click OK. (Inserting - them one by one is fine too.) + \guilabel{Input} category, and append \code{pythonXY.lib} to the + list in the \guilabel{Additional Dependencies} box. + + Select \guilabel{Debug} in the \guilabel{Configuration} dropdown + list, and append \code{pythonXY_d.lib} to the list in the + \guilabel{Additional Dependencies} box. Then click the C/\Cpp{} + tab, select \guilabel{Code Generation}, and select + \guilabel{Multi-threaded Debug DLL} from the \guilabel{Runtime + library} dropdown list. + + Select \guilabel{Release} again from the \guilabel{Configuration} + dropdown list. Select \guilabel{Multi-threaded DLL} from the + \guilabel{Runtime library} dropdown list. \end{enumerate} |