Author: Matti Picus <[email protected]> Branch: Changeset: r92016:54cc281fb04e Date: 2017-08-01 16:16 +0300 http://bitbucket.org/pypy/pypy/changeset/54cc281fb04e/
Log: improve cross-referencing in documentation diff --git a/pypy/doc/build.rst b/pypy/doc/build.rst --- a/pypy/doc/build.rst +++ b/pypy/doc/build.rst @@ -10,6 +10,18 @@ minutes on a fast machine -- and RAM-hungry. You will need **at least** 2 GB of memory on a 32-bit machine and 4GB on a 64-bit machine. +Before you start +---------------- + +Our normal development workflow avoids a full translation by using test-driven +development. You can read more about how to develop PyPy here_, and latest +translated (hopefully functional) binary packages are available on our +buildbot's `nightly builds`_ + +.. _here: getting-started-dev.html +.. _`nightly builds`: http://buildbot.pypy.org/nightly + +You will need the build dependencies below to run the tests. Clone the repository -------------------- 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 @@ -35,8 +35,8 @@ * Edit things. Use ``hg diff`` to see what you changed. Use ``hg add`` to make Mercurial aware of new files you added, e.g. new test files. - Use ``hg status`` to see if there are such files. Run tests! (See - the rest of this page.) + Use ``hg status`` to see if there are such files. Write and run tests! + (See the rest of this page.) * Commit regularly with ``hg commit``. A one-line commit message is fine. We love to have tons of commits; make one as soon as you have @@ -113,6 +113,10 @@ make sure you have the correct version installed which you can find out with the ``--version`` switch. +You will need the `build requirements`_ to run tests successfully, since many of +them compile little pieces of PyPy and then run the tests inside that minimal +interpreter + Now on to running some tests. PyPy has many different test directories and you can use shell completion to point at directories or files:: @@ -141,7 +145,7 @@ .. _py.test testing tool: http://pytest.org .. _py.test usage and invocations: http://pytest.org/latest/usage.html#usage - +.. _`build requirements`: build.html#install-build-time-dependencies Special Introspection Features of the Untranslated Python Interpreter --------------------------------------------------------------------- _______________________________________________ pypy-commit mailing list [email protected] https://mail.python.org/mailman/listinfo/pypy-commit
