Author: Manuel Jacob
Branch: improve-docs
Changeset: r63902:95a26751e3e3
Date: 2013-05-07 20:21 +0200
http://bitbucket.org/pypy/pypy/changeset/95a26751e3e3/
Log: Fix some internal links.
diff --git a/rpython/doc/faq.rst b/rpython/doc/faq.rst
--- a/rpython/doc/faq.rst
+++ b/rpython/doc/faq.rst
@@ -56,9 +56,7 @@
exceptions are
some functions in ``os``, ``math`` and ``time`` that have native support.
-To read more about the RPython limitations read the `RPython description`_.
-
-.. _`RPython description`: coding-guide.html#restricted-python
+To read more about the RPython limitations read the :doc:`RPython description
<rpython>`.
---------------------------------------------------------------
Does RPython have anything to do with Zope's Restricted Python?
diff --git a/rpython/doc/rlib.rst b/rpython/doc/rlib.rst
--- a/rpython/doc/rlib.rst
+++ b/rpython/doc/rlib.rst
@@ -96,9 +96,7 @@
The :source:`rpython/rlib/rarithmetic.py` module contains functionality to
handle the small differences
in the behaviour of arithmetic code in regular Python and RPython code. Most of
-them are already described in the `coding guide`_
-
-.. _`coding guide`: coding-guide.html
+them are already described in the :doc:`RPython description <rpython>`.
rbigint
diff --git a/rpython/doc/translation.rst b/rpython/doc/translation.rst
--- a/rpython/doc/translation.rst
+++ b/rpython/doc/translation.rst
@@ -6,11 +6,9 @@
This document describes the toolchain that we have developed to analyze
-and "compile" RPython_ programs (like PyPy itself) to various target
+and "compile" RPython programs (like PyPy itself) to various target
platforms.
-.. _RPython: coding-guide.html#restricted-python
-
It consists of three broad sections: a slightly simplified overview, a
brief introduction to each of the major components of our toolchain and
then a more comprehensive section describing how the pieces fit together.
@@ -21,21 +19,18 @@
Overview
========
-The job of the translation toolchain is to translate RPython_ programs into an
+The job of the translation toolchain is to translate RPython programs into an
efficient version of that program for one of various target platforms,
generally one that is considerably lower-level than Python. It divides
this task into several steps, and the purpose of this document is to
introduce them.
-As of the 1.2 release, RPython_ programs can be translated into the following
+As of the 1.2 release, RPython programs can be translated into the following
languages/platforms: C/POSIX, CLI/.NET
and Java/JVM.
-.. _`application-level`: coding-guide.html#application-level
-.. _`interpreter-level`: coding-guide.html#interpreter-level
-
The choice of the target platform affects the process somewhat, but to
-start with we describe the process of translating an RPython_ program into
+start with we describe the process of translating an RPython program into
C (which is the default and original target).
.. _`initialization time`:
@@ -56,7 +51,7 @@
1. The complete program is imported, at which time arbitrary run-time
initialization can be performed. Once this is done, the program must
be present in memory as a form that is "static enough" in the sense of
- RPython_.
+ :doc:`RPython <rpython>`.
2. The Annotator_ performs a global analysis starting from an specified
entry point to deduce type and other information about what each
@@ -90,7 +85,7 @@
(although these steps are not quite as distinct as you might think from
this presentation).
-There is an `interactive interface`_ called
:source:`rpython/bin/translatorshell.py` to the
+There is an :ref:`interactive interface <try out the translator>` called
:source:`rpython/bin/translatorshell.py` to the
translation process which allows you to interactively work through these
stages.
_______________________________________________
pypy-commit mailing list
pypy-commit@python.org
http://mail.python.org/mailman/listinfo/pypy-commit
