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

[cfbolz at codespeak.net]

Author: cfbolz
Date: Thu Feb 15 17:07:51 2007
New Revision: 38911

Modified:
   pypy/dist/pypy/doc/translation.txt
Log:
link to some options


Modified: pypy/dist/pypy/doc/translation.txt
==============================================================================
--- pypy/dist/pypy/doc/translation.txt	(original)
+++ pypy/dist/pypy/doc/translation.txt	Thu Feb 15 17:07:51 2007
@@ -570,13 +570,16 @@
 likely. Also objects that have a finalizer cannot be allocated on the stack,
 since the finalizer might resurrect the object.
 
-The resulting performance improvements by this optimization were quite
-poor. We think that this is due to the fact that the Boehm garbage
+The resulting performance improvements by this optimization were not as big
+we hoped. We think that this is due to the fact that the Boehm garbage
 collector becomes slower when the stack is bigger, thus compensating
 any speed improvement achieved by having faster allocation. We did not
 implement stack allocation with any of the other GCs that PyPy can
 use.
 
+Enable this optimization with :config:`translation.backendopt.mallocs`.
+
+
 The Stackless Transform
 -----------------------
 
@@ -587,6 +590,8 @@
 implement `coroutines, greenlets and tasklets`_ as an application
 level feature for the Standard Interpreter.
 
+Enable the stackless transformation with :config:`translation.stackless`.
+
 .. _`coroutines, greenlets and tasklets`: stackless.html
 
 .. _`preparing the graphs for source generation`:
@@ -645,6 +650,9 @@
 For a quite detailed description of how memory management and garbage collection
 are performed in PyPy, see the `Technical report`_ about this topic (section 4.2).
 
+You can choose which garbage collection strategy to use with
+:config:`translation.gc`.
+
 .. _`Technical report`: http://codespeak.net/pypy/extradoc/eu-report/D07.1_Massive_Parallelism_and_Translation_Aspects-2006-12-15.pdf
 
 .. _C:
@@ -689,6 +697,8 @@
 
 .. _LLVM:
 
+Use the :config:`translation.backend` option to choose which backend to use.
+
 The LLVM Back-End
 -----------------