[pypy-svn] r10606 - pypy/dist/pypy/documentation

[arigo at codespeak.net]

Author: arigo
Date: Thu Apr 14 12:33:10 2005
New Revision: 10606

Modified:
   pypy/dist/pypy/documentation/architecture.txt
   pypy/dist/pypy/documentation/howtopypy.txt
Log:
- mention the thunk object space in architecture.txt.
- add a link to it in howtopypy.txt.
- mention the status of our parser.


Modified: pypy/dist/pypy/documentation/architecture.txt
==============================================================================
--- pypy/dist/pypy/documentation/architecture.txt	(original)
+++ pypy/dist/pypy/documentation/architecture.txt	Thu Apr 14 12:33:10 2005
@@ -82,8 +82,8 @@
 ignorant of how to access, modify or construct objects and their
 structure and thus delegates such operations to a so called "Object Space". 
 
-XXX mention Parser and compiler (we have one available since the Berlin
-sprint but it is not integrated)
+XXX mention Parser and compiler (we have a parser module from the PyCon 2005
+sprint, but it's not used by the rest of the core)
 
 The Interpreter
 ===============
@@ -118,7 +118,7 @@
 if-statements (or rather, to be pedantic, to implement the
 conditional-branching bytecodes into which if-statements get compiled). 
 
-We currently have three working object spaces which can be plugged into
+We currently have four working object spaces which can be plugged into
 the interpreter:
 
 - The Standard Object Space, which is an almost complete implementation 
@@ -133,7 +133,12 @@
 
 - the Trace Object Space, which wraps e.g. the standard 
   object space in order to trace the execution of bytecodes, 
-  frames and object space operations. 
+  frames and object space operations.
+
+- the Thunk Object Space, which wraps another object space (e.g. the standard
+  one) and adds two capabilities: lazily computed objects (computed only when
+  an operation is performed on them), and "become", which completely and
+  globally replaces an object with another.
 
 The Standard Object Space
 =========================

Modified: pypy/dist/pypy/documentation/howtopypy.txt
==============================================================================
--- pypy/dist/pypy/documentation/howtopypy.txt	(original)
+++ pypy/dist/pypy/documentation/howtopypy.txt	Thu Apr 14 12:33:10 2005
@@ -322,9 +322,9 @@
    ``xxxobject.py`` contain respectively the definition of the type and its
    (default) implementation.
 
-*  `dist-pypy/pypy/objspace`_ contains a few other object the "thunk" one
-   the trace_ one, the flow_ one.  The latter is a relatively short piece of 
-   code that builds the control flow graphs when the interpreter runs in it.
+*  `dist-pypy/pypy/objspace`_ contains a few other object spaces: the thunk_
+   one, the trace_ one, the flow_ one.  The latter is a relatively short piece
+   of  code that builds the control flow graphs when the interpreter runs in it.
 
 *  `dist-pypy/pypy/translator`_ contains the code analysis and generation stuff.
    Start reading from translator.py_, from which it should be easy to follow
@@ -366,6 +366,7 @@
 .. _Standard object space:  http://codespeak.net/pypy/index.cgi?doc/stdobjspace.html
 .. _objspace.py:            http://codespeak.net/svn/pypy/dist/pypy/objspace/std/objspace.py
 .. _dist-pypy/pypy/objspace:      http://codespeak.net/svn/pypy/dist/pypy/objspace/
+.. _thunk:                  http://codespeak.net/svn/pypy/dist/pypy/objspace/thunk.py
 .. _trace:                  http://codespeak.net/svn/pypy/dist/pypy/objspace/trace.py
 .. _flow:                   http://codespeak.net/svn/pypy/dist/pypy/objspace/flow/
 .. _dist-pypy/pypy/translator:    http://codespeak.net/svn/pypy/dist/pypy/translator/