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

[pedronis at codespeak.net]

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