[pypy-svn] pypy documentation-cleanup: more RPython toolchain

[lac]

Author: Laura Creighton <lac at openend.se>
Branch: documentation-cleanup
Changeset: r43772:1250ec028b7c
Date: 2011-04-29 15:46 +0200
http://bitbucket.org/pypy/pypy/changeset/1250ec028b7c/

Log:	more RPython toolchain

diff --git a/pypy/doc/getting-started.rst b/pypy/doc/getting-started.rst
--- a/pypy/doc/getting-started.rst
+++ b/pypy/doc/getting-started.rst
@@ -8,9 +8,20 @@
 
 What is PyPy ?
 ==============
+In common parlance, PyPy has been used to mean two things.  The first is the
+`RPython translation toolchain`_, which is a framework for generating
+dynamic programming language implementations.  And the second is one
+particular implementation that is so generated --
+an implementation of the Python_ programming language written in
+Python itself.  It is designed to be flexible and easy to experiment with.
 
-PyPy is an implementation of the Python_ programming language written in
-Python itself, flexible and easy to experiment with.
+This double usage has proven to be confusing, and we are trying to move
+away from using the word PyPy to mean both things.  From now on we will
+try to use PyPy to only mean the Python implementation, and say the
+`RPython translation toolchain`_ when we mean the framework.  Some older
+documents, presentations, papers and videos will still have the old
+usage.  You are hereby warned.
+
 We target a large variety of platforms, small and large, by providing a
 compiler toolsuite that can produce custom Python versions.  Platform, memory
 and threading models, as well as the JIT compiler itself, are aspects of the
@@ -18,6 +29,7 @@
 language implementation itself. `more...`_
 
 .. _Python: http://docs.python.org/reference/
+.. _`RPython translation toolchain`: translation.html
 .. _`more...`: architecture.html
 
 Just the facts 

diff --git a/pypy/doc/windows.rst b/pypy/doc/windows.rst
--- a/pypy/doc/windows.rst
+++ b/pypy/doc/windows.rst
@@ -122,4 +122,4 @@
     cp .libs/libffi-5.dll <somewhere on the PATH>
 
 .. _`libffi source files`: http://sourceware.org/libffi/
-.. _`RPython translation toolchain`: translation.rst
+.. _`RPython translation toolchain`: translation.html