Author: pedronis
Date: Wed Feb 14 16:45:18 2007
New Revision: 38847
Modified:
pypy/dist/pypy/doc/translation.txt
Log:
a disclamair about the described approach to external functions.
Modified: pypy/dist/pypy/doc/translation.txt
==============================================================================
--- pypy/dist/pypy/doc/translation.txt (original)
+++ pypy/dist/pypy/doc/translation.txt Wed Feb 14 16:45:18 2007
@@ -848,6 +848,13 @@
External Function Calls
=======================
+*Warning* This approach while is still used at the moment by PyPy to
+expose native operations (like ``os.read``, ``os.write``) is going to be
+phased out. It has shown to be to cumbersome in practice. An approach
+based on `rctypes`_ should replace it.
+
+.. _rctypes: rctypes.html
+
There are some functions that we don't want to implement in Python for various
reasons (e.g. if they need to make calls into the OS). These can be
implemented by writing backend code by hand that either implements the