[pypy-svn] r37000 - pypy/dist/pypy/doc

arigo at codespeak.net arigo at codespeak.net
Fri Jan 19 16:07:07 CET 2007


Author: arigo
Date: Fri Jan 19 16:07:04 2007
New Revision: 37000

Modified:
   pypy/dist/pypy/doc/_ref.txt
   pypy/dist/pypy/doc/extcompiler.txt
Log:
Add an introduction paragraph to extcompiler.txt.


Modified: pypy/dist/pypy/doc/_ref.txt
==============================================================================
--- pypy/dist/pypy/doc/_ref.txt	(original)
+++ pypy/dist/pypy/doc/_ref.txt	Fri Jan 19 16:07:04 2007
@@ -54,6 +54,7 @@
 .. _`pypy/module/readline`: ../../pypy/module/readline
 .. _`objspace/`:
 .. _`pypy/objspace`: ../../pypy/objspace
+.. _`pypy/objspace/cpy`: ../../pypy/objspace/cpy
 .. _`objspace/dump.py`: ../../pypy/objspace/dump.py
 .. _`objspace/flow/`: ../../pypy/objspace/flow
 .. _`objspace/logic.py`: ../../pypy/objspace/logic.py

Modified: pypy/dist/pypy/doc/extcompiler.txt
==============================================================================
--- pypy/dist/pypy/doc/extcompiler.txt	(original)
+++ pypy/dist/pypy/doc/extcompiler.txt	Fri Jan 19 16:07:04 2007
@@ -21,7 +21,16 @@
 Understanding the ext compiler 
 ----------------------------------
 
-PyPy provides a generic way to write modules for all Python
+In regular Python, the ability for users to write external modules is of
+great importance.  These external modules must be written in C, which is
+both an advantage - it allows access to external C libraries, low-level
+features, or raw performance - and an inconvenience.  In the context of
+PyPy the greatest drawback of hard-coded C external modules is that
+low-level details like multithreading (e.g. locks) and memory management
+must be explicitly written in such a language, which would prevent the
+same module from being used in several different versions of pypy-c.
+
+PyPy provides instead a generic way to write modules for all Python
 implementations: the so-called *mixed module* approach.  A single mixed
 module is implemented as a set of Python source files, making a
 subpackage of the `pypy/module/`_ package.  While running PyPy, each of
@@ -263,4 +272,10 @@
 .. _`installation notes`: rctypes.html#installation
 
 
+Implementation of the ext compiler
+-----------------------------------------------
+
+XXX no documentation available yet, see `pypy/objspace/cpy`_.
+
+
 .. include:: _ref.txt



More information about the Pypy-commit mailing list