PageRenderTime 44ms CodeModel.GetById 18ms RepoModel.GetById 0ms app.codeStats 0ms

/pypy/doc/config/index.rst

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