1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
==============================
Configuration Options for PyPy
==============================
This directory contains documentation for the many `configuration`_
options that can be used to affect PyPy's behaviour. There are two
main classes of option, `object space options`_ and `translation
options`_.
There are two main entry points that accept options: ``py.py``, which
implements Python on top of another Python interpreter and accepts all
the `object space options`_:
.. parsed-literal::
./py.py <`objspace options`_>
and the ``rpython/bin/rpython`` translation entry
point which takes arguments of this form:
.. parsed-literal::
./rpython/bin/rpython <`translation options`_> <target>
For the common case of ``<target>`` being ``targetpypystandalone.py``,
you can then pass the `object space options`_ after
``targetpypystandalone.py``, i.e. like this:
.. parsed-literal::
./rpython/bin/rpython <`translation options`_> targetpypystandalone.py <`objspace options`_>
There is an `overview`_ of all command line arguments that can be
passed in either position.
Many of the more interesting object space options enable optimizations,
which are described in `Standard Interpreter Optimizations`_, or allow
the creation of objects that can barely be imagined in CPython, which
are documented in `What PyPy can do for your objects`_.
The following diagram gives some hints about which PyPy features work together
with which other PyPy features:
.. image:: ../image/compat-matrix.png
.. _`configuration`: ../configuration.html
.. _`objspace options`: commandline.html#objspace
.. _`object space options`: commandline.html#objspace
.. _`translation options`: commandline.html#translation
.. _`overview`: commandline.html
.. _`Standard Interpreter Optimizations`: ../interpreter-optimizations.html
.. _`What PyPy can do for your objects`: ../objspace-proxies.html
.. toctree::
:maxdepth: 2
commandline
translation
objspace
opt
|
