[pypy-svn] r38845 - pypy/dist/pypy/doc/config

[cfbolz at codespeak.net]

Author: cfbolz
Date: Wed Feb 14 16:37:14 2007
New Revision: 38845

Modified:
   pypy/dist/pypy/doc/config/translation.backendopt.remove_asserts.txt
   pypy/dist/pypy/doc/config/translation.backendopt.txt
   pypy/dist/pypy/doc/config/translation.cc.txt
   pypy/dist/pypy/doc/config/translation.debug.txt
   pypy/dist/pypy/doc/config/translation.fork_before.txt
   pypy/dist/pypy/doc/config/translation.insist.txt
   pypy/dist/pypy/doc/config/translation.instrument.txt
   pypy/dist/pypy/doc/config/translation.instrumentctl.txt
   pypy/dist/pypy/doc/config/translation.profopt.txt
   pypy/dist/pypy/doc/config/translation.vanilla.txt
   pypy/dist/pypy/doc/config/translation.withsmallfuncsets.txt
Log:
document a couple of more options


Modified: pypy/dist/pypy/doc/config/translation.backendopt.remove_asserts.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.backendopt.remove_asserts.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.backendopt.remove_asserts.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1 @@
+Remove assertion errors from the flowgraphs, which might give small speedups.

Modified: pypy/dist/pypy/doc/config/translation.backendopt.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.backendopt.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.backendopt.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1,5 @@
+This group contains options about various backend optimization passes. Most of
+them are described in the `EU report about optimization`_
+
+.. _`EU report about optimization`: http://codespeak.net/pypy/extradoc/eu-report/D07.1_Massive_Parallelism_and_Translation_Aspects-2006-12-15.pdf
+

Modified: pypy/dist/pypy/doc/config/translation.cc.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.cc.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.cc.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1 @@
+Specify which C compiler to use.

Modified: pypy/dist/pypy/doc/config/translation.debug.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.debug.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.debug.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1,2 @@
+Record extra debugging information during annotation. This leads to slightly
+less obscure error messages.

Modified: pypy/dist/pypy/doc/config/translation.fork_before.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.fork_before.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.fork_before.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1,4 @@
+This is an option mostly useful when working on the PyPy toolchain. If you use
+it, translate.py will fork before the specified phase. If the translation
+crashes after that fork, you can fix the bug in the toolchain, and continue
+translation at the fork-point.

Modified: pypy/dist/pypy/doc/config/translation.insist.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.insist.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.insist.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1,4 @@
+Don't stop on the first `rtyping`_ error. Instead, try to rtype as much as
+possible and show the collected error messages in the end.
+
+.. _`rtyping`: ../rtyper.html

Modified: pypy/dist/pypy/doc/config/translation.instrument.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.instrument.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.instrument.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1 @@
+internal option

Modified: pypy/dist/pypy/doc/config/translation.instrumentctl.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.instrumentctl.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.instrumentctl.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1 @@
+internal option

Modified: pypy/dist/pypy/doc/config/translation.profopt.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.profopt.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.profopt.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1,3 @@
+Use GCCs profile-guided optimizations. This option specifies the the arguments
+with which to call pypy-c to gather profile data. Example:
+"-c 'from richards import main;main(); from test import pystone; pystone.main()'"

Modified: pypy/dist/pypy/doc/config/translation.vanilla.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.vanilla.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.vanilla.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1,2 @@
+Try to make the resulting compiled program as portable (=moveable to another
+machine) as possible. Which is not much.

Modified: pypy/dist/pypy/doc/config/translation.withsmallfuncsets.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.withsmallfuncsets.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.withsmallfuncsets.txt	Wed Feb 14 16:37:14 2007
@@ -0,0 +1,3 @@
+Represent function sets smaller than this option's value as an integer instead
+of a function pointer. A call is then done via a switch on that integer, which
+allows inlining etc. Small numbers for this can speed up PyPy (try 5).