From c1e14dffeb135d36af9141ff0b633263fe9e9884 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=89ric=20Araujo?= Date: Wed, 15 Dec 2010 22:07:54 +0000 Subject: Merged revisions 87283 via svnmerge from svn+ssh://pythondev@svn.python.org/python/branches/py3k MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ........ r87283 | eric.araujo | 2010-12-15 23:06:35 +0100 (mer., 15 déc. 2010) | 2 lines Add disclaimer about MinGW compat in distutils docs (#6007). Patch by Chris Lambacher. ........ --- Doc/install/index.rst | 39 +++++++++++++++++++++++---------------- 1 file changed, 23 insertions(+), 16 deletions(-) diff --git a/Doc/install/index.rst b/Doc/install/index.rst index 525a3ef..43286ac 100644 --- a/Doc/install/index.rst +++ b/Doc/install/index.rst @@ -926,15 +926,34 @@ section :ref:`inst-config-files`.) GNU C / Cygwin / MinGW ^^^^^^^^^^^^^^^^^^^^^^ -These instructions only apply if you're using a version of Python prior to -2.4.1 with a MinGW prior to 3.0.0 (with binutils-2.13.90-20030111-1). - This section describes the necessary steps to use Distutils with the GNU C/C++ compilers in their Cygwin and MinGW distributions. [#]_ For a Python interpreter that was built with Cygwin, everything should work without any of these following steps. -These compilers require some special libraries. This task is more complex than +Not all extensions can be built with MinGW or Cygwin, but many can. Extensions +most likely to not work are those that use C++ or depend on Microsoft Visual C +extensions. + +To let Distutils compile your extension with Cygwin you have to type:: + + python setup.py build --compiler=cygwin + +and for Cygwin in no-cygwin mode [#]_ or for MinGW type:: + + python setup.py build --compiler=mingw32 + +If you want to use any of these options/compilers as default, you should +consider writing it in your personal or system-wide configuration file for +Distutils (see section :ref:`inst-config-files`.) + +Older Versions of Python and MinGW +"""""""""""""""""""""""""""""""""" +The following instructions only apply if you're using a version of Python +inferior to 2.4.1 with a MinGW inferior to 3.0.0 (with +binutils-2.13.90-20030111-1). + +These compilers require some special libraries. This task is more complex than for Borland's C++, because there is no program to convert the library. First you have to create a list of symbols which the Python DLL exports. (You can find a good program for this task at @@ -964,18 +983,6 @@ If your extension uses other libraries (zlib,...) you might have to convert them too. The converted files have to reside in the same directories as the normal libraries do. -To let Distutils compile your extension with Cygwin you now have to type :: - - python setup.py build --compiler=cygwin - -and for Cygwin in no-cygwin mode [#]_ or for MinGW type:: - - python setup.py build --compiler=mingw32 - -If you want to use any of these options/compilers as default, you should -consider to write it in your personal or system-wide configuration file for -Distutils (see section :ref:`inst-config-files`.) - .. seealso:: -- cgit v0.12