[pypy-svn] r16730 - pypy/release/0.7.x/pypy/doc

[cfbolz at codespeak.net]

Author: cfbolz
Date: Sat Aug 27 12:49:20 2005
New Revision: 16730

Modified:
   pypy/release/0.7.x/pypy/doc/getting-started.txt
Log:
added the text that you see after translation of PyPy was successful


Modified: pypy/release/0.7.x/pypy/doc/getting-started.txt
==============================================================================
--- pypy/release/0.7.x/pypy/doc/getting-started.txt	(original)
+++ pypy/release/0.7.x/pypy/doc/getting-started.txt	Sat Aug 27 12:49:20 2005
@@ -386,7 +386,7 @@
 compiled and executed.
 
 translating the PyPy interpreter
-++++++++++++++++++++++++++++++++
+--------------------------------
 
 Not for the faint of heart nor the owner of a very old machine: you can
 translate the whole of PyPy to low level C code. This is the largest and
@@ -400,18 +400,34 @@
 ``-t_lowmem`` With this option the whole process should be runnable on a
 machine with 512Mb of RAM. If the translation is finished running and after
 you closed the graph you will be greeted by the friendly prompt of a PyPy
-executable that is not running on top of CPython any more.
+executable that is not running on top of CPython any more::
 
-Moving around in the resulting flow graph is difficult because of the sheer
-size of the result. For this reason, the debugger prompt you get at 
-the end has been enhanced with commands to facilitate locating functions and
-classes. Type ``help graphs`` for a list of the new commands.  Help is also
-available on each of these new commands.
+    Running!
+    debug: entry point starting
+    debug:  argv -> ./pypy-c
+    importing code
+    calling code.interact()
+    Python 2.4.1 (pypy 0.7.0 build) on linux2
+    Type "help", "copyright", "credits" or "license" for more information.
+    (InteractiveConsole)
+    >>>> 1 + 1
+    2
+    >>>> 
+
+If you exit the interpreter you get a pygame window with all the flowgraphs
+plus a pdb prompt. Moving around in the resulting flow graph is difficult
+because of the sheer size of the result. For this reason, the debugger prompt
+you get at the end has been enhanced with commands to facilitate locating
+functions and classes. Type ``help graphs`` for a list of the new commands.
+Help is also available on each of these new commands.
 
 The ``translate_pypy`` script itself takes a number of options controlling
 what to translate and how.  See ``translate_pypy.py -h``. Some of the more
 interesting options are:
 
+   * ``-text``: don't show the flowgraph after the translation is done. This
+     is useful if you don't have pygame installed.
+
    * ``-llvm``: produce code for LLVM_ instead of for C. One of the biggest
      things not working there is threading.
 
@@ -419,7 +435,8 @@
      our own reference counting implementation.
 
 
-Try out::
+You can also use the translate_pypy.py script to try out several smaller
+programs, e.g. a slightly changed version of Pystone::
 
     cd pypy/translator/goal
     python translate_pypy.py targetrpystone
@@ -428,6 +445,7 @@
 
     python translate_pypy.py targetrpystone2
 
+
 .. _`start reading sources`: 
 
 Where to start reading the sources