Author: Maciej Fijalkowski <fij...@gmail.com> Branch: Changeset: r60911:d52661180965 Date: 2013-02-06 20:53 +0200 http://bitbucket.org/pypy/pypy/changeset/d52661180965/
Log: update docs to mention new dir layout diff --git a/pypy/doc/arm.rst b/pypy/doc/arm.rst --- a/pypy/doc/arm.rst +++ b/pypy/doc/arm.rst @@ -145,7 +145,7 @@ :: - pypy ~/path_to_pypy_checkout/pypy/translator/goal/translate.py -O1 --platform=arm target.py + pypy ~/path_to_pypy_checkout/rpython/translator/goal/translate.py -O1 --platform=arm target.py If everything worked correctly this should yield an ARM binary. Running this binary in the ARM chroot or on an ARM device should produce the output ``"Hello World"``. diff --git a/pypy/doc/cppyy.rst b/pypy/doc/cppyy.rst --- a/pypy/doc/cppyy.rst +++ b/pypy/doc/cppyy.rst @@ -86,10 +86,10 @@ $ hg clone https://bitbucket.org/pypy/pypy $ cd pypy $ hg up reflex-support # optional - $ cd pypy/translator/goal + $ cd pypy/goal # This example shows python, but using pypy-c is faster and uses less memory - $ python translate.py -O jit --gcrootfinder=shadowstack targetpypystandalone.py --withmod-cppyy + $ python ../../rpython/bin/rpython.py -O jit --gcrootfinder=shadowstack targetpypystandalone.py --withmod-cppyy This will build a ``pypy-c`` that includes the cppyy module, and through that, Reflex support. diff --git a/pypy/doc/ctypes-implementation.rst b/pypy/doc/ctypes-implementation.rst --- a/pypy/doc/ctypes-implementation.rst +++ b/pypy/doc/ctypes-implementation.rst @@ -113,7 +113,7 @@ The pypy-c translated to run the ctypes tests can be used to run the pyglet examples as well. They can be run like e.g.:: $ cd pyglet/ - $ PYTHONPATH=. ../ctypes-stable/pypy/translator/goal/pypy-c examples/opengl.py + $ PYTHONPATH=. ../ctypes-stable/pypy/goal/pypy-c examples/opengl.py they usually should be terminated with ctrl-c. Refer to the their doc strings for details about how they should behave. diff --git a/pypy/doc/getting-started-dev.rst b/pypy/doc/getting-started-dev.rst --- a/pypy/doc/getting-started-dev.rst +++ b/pypy/doc/getting-started-dev.rst @@ -24,7 +24,7 @@ python bin/translatorshell.py Test snippets of translatable code are provided in the file -``pypy/translator/test/snippet.py``, which is imported under the name +``rpython/translator/test/snippet.py``, which is imported under the name ``snippet``. For example:: >>> t = Translation(snippet.is_perfect_number, [int]) @@ -52,16 +52,18 @@ The graph can be turned into C code:: >>> t.rtype() - >>> f = t.compile_c() + >>> lib = t.compile_c() The first command replaces the operations with other low level versions that -only use low level types that are available in C (e.g. int). To try out the -compiled version:: +only use low level types that are available in C (e.g. int). The compiled +version is now in a ``.so`` library. You can run it say using ctypes: + >>> from ctypes import CDLL + >>> f = CDLL(lib) >>> f(5) - False + 0 >>> f(6) - True + 1 Translating the flow graph to CLI or JVM code +++++++++++++++++++++++++++++++++++++++++++++ @@ -108,7 +110,7 @@ There is a small-to-medium demo showing the translator and the annotator:: cd demo - ../pypy/translator/goal/translate.py --view --annotate bpnn.py + ../rpython/translator/goal/translate.py --view --annotate bpnn.py This causes ``bpnn.py`` to display itself as a call graph and class hierarchy. Clicking on functions shows the flow graph of the particular @@ -119,17 +121,17 @@ To turn this example to C code (compiled to the executable ``bpnn-c``), type simply:: - ../pypy/translator/goal/translate.py bpnn.py + ../rpython/translator/goal/translate.py bpnn.py Translating Full Programs +++++++++++++++++++++++++ To translate full RPython programs, there is the script ``translate.py`` in -``translator/goal``. Examples for this are a slightly changed version of +``rpython/translator/goal``. Examples for this are a slightly changed version of Pystone:: - cd pypy/translator/goal + cd rpython/translator/goal python translate.py targetrpystonedalone This will produce the executable "targetrpystonedalone-c". diff --git a/pypy/doc/index.rst b/pypy/doc/index.rst --- a/pypy/doc/index.rst +++ b/pypy/doc/index.rst @@ -220,9 +220,8 @@ ================================ =========================================== Directory explanation/links ================================ =========================================== -`pypy/annotation/`_ `type inferencing code`_ for `RPython`_ programs -`pypy/bin/`_ command-line scripts, mainly `py.py`_ and `translatorshell.py`_ +`pypy/bin/`_ command-line scripts, mainly `pyinteractive.py`_ `pypy/config/`_ handles the numerous options for building and running PyPy @@ -249,20 +248,8 @@ `pypy/objspace/`_ `object space`_ implementations -`pypy/objspace/flow/`_ the FlowObjSpace_ implementing `abstract interpretation`_ - `pypy/objspace/std/`_ the StdObjSpace_ implementing CPython's objects and types -`pypy/rlib/`_ a `"standard library"`_ for RPython_ programs - -`pypy/rpython/`_ the `RPython Typer`_ - -`pypy/rpython/lltypesystem/`_ the `low-level type system`_ for C-like backends - -`pypy/rpython/ootypesystem/`_ the `object-oriented type system`_ for OO backends - -`pypy/rpython/memory/`_ the `garbage collector`_ construction framework - `pypy/tool/`_ various utilities and hacks used from various places `pypy/tool/algo/`_ general-purpose algorithmic and mathematic @@ -270,20 +257,39 @@ `pypy/tool/pytest/`_ support code for our `testing methods`_ -`pypy/translator/`_ translation_ backends and support code -`pypy/translator/backendopt/`_ general optimizations that run before a backend generates code +`rpython/annotator/`_ `type inferencing code`_ for `RPython`_ programs -`pypy/translator/c/`_ the `GenC backend`_, producing C code from an +`rpython/config/`_ handles the numerous options for RPython + + +`rpython/flowspace/`_ the FlowObjSpace_ implementing `abstract interpretation`_ + + +`rpython/rlib/`_ a `"standard library"`_ for RPython_ programs + +`rpython/rtyper/`_ the `RPython Typer`_ + +`rpython/rtyper/lltypesystem/`_ the `low-level type system`_ for C-like backends + +`rpython/rtyper/ootypesystem/`_ the `object-oriented type system`_ for OO backends + +`rpython/rtyper/memory/`_ the `garbage collector`_ construction framework + +`rpython/translator/`_ translation_ backends and support code + +`rpython/translator/backendopt/`_ general optimizations that run before a backend generates code + +`rpython/translator/c/`_ the `GenC backend`_, producing C code from an RPython program (generally via the rtyper_) -`pypy/translator/cli/`_ the `CLI backend`_ for `.NET`_ (Microsoft CLR or Mono_) +`rpython/translator/cli/`_ the `CLI backend`_ for `.NET`_ (Microsoft CLR or Mono_) -`pypy/translator/goal/`_ our `main PyPy-translation scripts`_ live here +`pypy/goal/`_ our `main PyPy-translation scripts`_ live here -`pypy/translator/jvm/`_ the Java backend +`rpython/translator/jvm/`_ the Java backend -`pypy/translator/tool/`_ helper tools for translation, including the Pygame +`rpython/translator/tool/`_ helper tools for translation, including the Pygame `graph viewer`_ ``*/test/`` many directories have a test subdirectory containing test diff --git a/pypy/doc/sandbox.rst b/pypy/doc/sandbox.rst --- a/pypy/doc/sandbox.rst +++ b/pypy/doc/sandbox.rst @@ -87,15 +87,15 @@ ----- -In pypy/translator/goal:: +In pypy/goal:: - ./translate.py -O2 --sandbox targetpypystandalone.py + ../../rpython/bin/rpython -O2 --sandbox targetpypystandalone.py If you don't have a regular PyPy installed, you should, because it's faster to translate, but you can also run ``python translate.py`` instead. -To run it, use the tools in the pypy/translator/sandbox directory:: +To run it, use the tools in the pypy/sandbox directory:: ./pypy_interact.py /some/path/pypy-c-sandbox [args...] diff --git a/pypy/doc/whatsnew-head.rst b/pypy/doc/whatsnew-head.rst --- a/pypy/doc/whatsnew-head.rst +++ b/pypy/doc/whatsnew-head.rst @@ -51,3 +51,6 @@ .. branch: inline-virtualref-2 Better optimized certain types of frame accesses in the JIT, particularly around exceptions that escape the function they were raised in. + +.. branch: missing-ndarray-attributes +Some missing attributes from ndarrays _______________________________________________ pypy-commit mailing list pypy-commit@python.org http://mail.python.org/mailman/listinfo/pypy-commit