[pypy-svn] r38245 - pypy/dist/pypy/doc
antocuni at codespeak.net
antocuni at codespeak.net
Fri Feb 9 13:58:33 CET 2007
Author: antocuni
Date: Fri Feb 9 13:58:32 2007
New Revision: 38245
Modified:
pypy/dist/pypy/doc/getting-started.txt
Log:
Some notes on how to translate pypy under windows, based on the
docstring of goal/win32/gc_patch_windows.py
Modified: pypy/dist/pypy/doc/getting-started.txt
==============================================================================
--- pypy/dist/pypy/doc/getting-started.txt (original)
+++ pypy/dist/pypy/doc/getting-started.txt Fri Feb 9 13:58:32 2007
@@ -601,6 +601,111 @@
python translate.py targetrpystone
+Translating PyPy under Windows
+++++++++++++++++++++++++++++++
+
+PyPy can be translated also under Windows. We have tested the
+translation toolchain using Visual Studio .NET 2003. It could be
+possible that it works also with other configurations: if you succeed
+to compile PyPy with a C compiler other that Visual Studio .NET 2003,
+please report us.
+
+To build pypy-c you first need a PyPy compatible version of the Boehm
+collector for Windows and Visual Studio .NET 2003. You can either
+`build your own copy`_ or download a `pre-compiled binary package`_.
+
+.. _`build your own copy`:
+
+How to build the Boehm collector
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First of all, download the official `Boehm collector suite`_. At
+the time of writing (2007-02-09) this contains version gc6.7.
+
+Unpack this folder somewhere, for instance to ``d:\tmp``. Change to
+this folder and copy the file ``NT_THREADS_MAKEFILE`` to
+``Makefile``::
+
+ d:
+ cd \tmp\gc6.5
+ copy NT_THREADS_MAKEFILE Makefile
+
+This file is the general-purpose gc dll makefile. For some internal
+reasons, this file's defaults are bad for PyPy. The early
+initialisation in DllMain() inhibits the changes necessary for
+PyPy. Use this script to do a patch: (assuming that you have
+``d:\pypy\dist\pypy\translator\goal`` -- please change the command
+according to the location of your PyPy installation)::
+
+ python d:\pypy\dist\pypy\translator\goal\win32\gc_patch_windows.py
+
+Now, your makefile is patched a little bit. See gc_patch_windows.py_
+for more details.
+
+Now you need to build your gc, either as a debug or as a release
+build. First of all, make sure that you have your environment prepared.
+Please note that you will need to use Microsoft's cmd, as cygwin bash
+doesn't correctly handle the batch file in the next step.
+
+With my setup, I have to do::
+
+ c:\Program Files\Microsoft Visual Studio .NET 2003\Vc7\bin\vcvars32.bat
+
+After that, you can either build a release or a debug gc.
+
+After a successful build, you need to enable ``gc_pypy.dll`` for your
+compiler. There are many ways to install this. The following
+recommendation just works without changing your environment
+variables. I think this is the easiest way possible, but this is a
+matter of taste. What I did is::
+
+ nmake CFG="gc - Win32 Release"
+
+After the build, you will find the ``gc_pypy.dll`` and ``gc_pypy.lib``
+files in the Release folder.
+
+Copy the file ``gc_pypy.dll`` to ``c:\windows\system32`` or any other
+folder that is always in your PATH variable.
+
+Also, copy ``gc_pypy.lib`` to (in my case) ``c:\Program files\Microsoft
+Visual Studio .NET 2003\Vc7\lib``.
+
+Finally, copy ``d:\tmp\gc6.7\include`` to ``c:\Program
+files\Microsoft Visual Studio .NET 2003\Vc7\include`` and rename this
+folder to ``gc``, so that ``gc/gc.h`` is valid.
+
+In case of a debug build also copy ``gc_pypy.pdb`` to your lib
+folder. This allows you to use source-level debugging.
+
+Summary transcript of the steps involved (please adjust paths)::
+
+ d:
+ cd \tmp\gc6.7
+ copy NT_THREADS_MAKEFILE Makefile
+ python d:\pypy\dist\pypy\translator\goal\win32\gc_patch_windows.py
+ "c:\Program files\Microsoft Visual Studio .NET 2003\Vc7\bin\vcvars32.bat"
+ nmake CFG="gc - Win32 Release"
+ copy Release\gc_pypy.dll c:\windows\system32
+ copy Release\gc_pypy.lib "c:\Program files\Microsoft Visual Studio .NET 2003\Vc7\lib"
+ mkdir "c:\Program files\Microsoft Visual Studio .NET 2003\Vc7\include\gc"
+ copy include "c:\Program files\Microsoft Visual Studio .NET 2003\Vc7\include\gc"
+
+.. _`pre-compiled binary package`:
+
+Installing the pre-compiled Boehm collector
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First, download and extract the file `gc-windows.zip`_. Then, copy the
+file ``gc_pypy.dll`` to ``c:\windows\system32`` or any other folder that is
+always in your PATH variable.
+
+Also, copy ``gc_pypy.lib`` to (in my case) ``c:\Program files\Microsoft
+Visual Studio .NET 2003\Vc7\lib``.
+
+Finally, copy the ``gc`` directory to ``c:\Program files\Microsoft
+Visual Studio .NET 2003\Vc7\include``.
+
+
.. _`translate PyPy with the thunk object space`:
Translating with the thunk object space
@@ -792,6 +897,7 @@
.. _trace: http://codespeak.net/pypy/dist/pypy/objspace/trace.py
.. _flow: http://codespeak.net/pypy/dist/pypy/objspace/flow/
.. _translator.py: http://codespeak.net/pypy/dist/pypy/translator/translator.py
+.. _gc_patch_windows.py: http://codespeak.net/pypy/dist/pypy/translator/goal/win32/gc_patch_windows.py
.. _mailing lists: contact.html
.. _documentation: index.html
.. _unit tests: coding-guide.html#test-design
@@ -799,5 +905,7 @@
.. _`directory reference`: index.html#directory-reference
.. _`Boehm-Demers-Weiser garbage collector`: http://www.hpl.hp.com/personal/Hans_Boehm/gc/
+.. _`Boehm collector suite`: http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc.tar.gz
+.. _`gc-windows.zip`: http://codespeak.net/~antocuni/gc-windows.zip
.. include:: _ref.txt
More information about the Pypy-commit
mailing list