Author: Manuel Jacob <m...@manueljacob.de>
Branch:
Changeset: r72674:78d5d873a260
Date: 2014-08-03 21:40 +0200
http://bitbucket.org/pypy/pypy/changeset/78d5d873a260/
Log: Redo some recent changes from the improve-docs branch.
Original pull request by Martin Matusiak.
diff --git a/pypy/doc/cpython_differences.rst b/pypy/doc/cpython_differences.rst
--- a/pypy/doc/cpython_differences.rst
+++ b/pypy/doc/cpython_differences.rst
@@ -74,9 +74,6 @@
zipimport
zlib
- When translated to Java or .NET, the list is smaller; see
- `pypy/config/pypyoption.py`_ for details.
-
When translated on Windows, a few Unix-only modules are skipped,
and the following module is built instead:
diff --git a/pypy/doc/getting-started-python.rst
b/pypy/doc/getting-started-python.rst
--- a/pypy/doc/getting-started-python.rst
+++ b/pypy/doc/getting-started-python.rst
@@ -50,6 +50,8 @@
libz-dev libbz2-dev libncurses-dev libexpat1-dev \
libssl-dev libgc-dev python-sphinx python-greenlet
+ For the optional lzma module on PyPy3 you will also need ``liblzma-dev``.
+
On a Fedora-16 box these are::
[user@fedora-or-rh-box ~]$ sudo yum install \
@@ -57,6 +59,8 @@
zlib-devel bzip2-devel ncurses-devel expat-devel \
openssl-devel gc-devel python-sphinx python-greenlet
+ For the optional lzma module on PyPy3 you will also need ``xz-devel``.
+
On SLES11:
$ sudo zypper install gcc make python-devel pkg-config \
@@ -74,6 +78,7 @@
* ``pkg-config`` (to help us locate libffi files)
* ``libz-dev`` (for the optional ``zlib`` module)
* ``libbz2-dev`` (for the optional ``bz2`` module)
+ * ``liblzma`` (for the optional ``lzma`` module, PyPy3 only)
* ``libsqlite3-dev`` (for the optional ``sqlite3`` module via cffi)
* ``libncurses-dev`` (for the optional ``_minimal_curses`` module)
* ``libexpat1-dev`` (for the optional ``pyexpat`` module)
diff --git a/pypy/doc/index.rst b/pypy/doc/index.rst
--- a/pypy/doc/index.rst
+++ b/pypy/doc/index.rst
@@ -102,7 +102,7 @@
.. _Python: http://docs.python.org/index.html
.. _`more...`: architecture.html#mission-statement
.. _`PyPy blog`: http://morepypy.blogspot.com/
-.. _`development bug/feature tracker`: https://bugs.pypy.org
+.. _`development bug/feature tracker`: https://bitbucket.org/pypy/pypy/issues
.. _here: http://www.tismer.com/pypy/irc-logs/pypy/
.. _`Mercurial commit mailing list`:
http://mail.python.org/mailman/listinfo/pypy-commit
.. _`development mailing list`:
http://mail.python.org/mailman/listinfo/pypy-dev
diff --git a/pypy/doc/you-want-to-help.rst b/pypy/doc/you-want-to-help.rst
--- a/pypy/doc/you-want-to-help.rst
+++ b/pypy/doc/you-want-to-help.rst
@@ -15,14 +15,14 @@
* Because of the above, we are very serious about Test Driven Development.
It's not only what we believe in, but also that PyPy's architecture is
working very well with TDD in mind and not so well without it. Often
- the development means progressing in an unrelated corner, one unittest
+ development means progressing in an unrelated corner, one unittest
at a time; and then flipping a giant switch, bringing it all together.
(It generally works out of the box. If it doesn't, then we didn't
- write enough unit tests.) It's worth repeating - PyPy
- approach is great if you do TDD, not so great otherwise.
+ write enough unit tests.) It's worth repeating - PyPy's
+ approach is great if you do TDD, and not so great otherwise.
* PyPy uses an entirely different set of tools - most of them included
- in the PyPy repository. There is no Makefile, nor autoconf. More below
+ in the PyPy repository. There is no Makefile, nor autoconf. More below.
Architecture
============
@@ -32,7 +32,7 @@
* `RPython`_ is the language in which we write interpreters. Not the entire
PyPy project is written in RPython, only the parts that are compiled in
the translation process. The interesting point is that RPython has no parser,
- it's compiled from the live python objects, which make it possible to do
+ it's compiled from the live python objects, which makes it possible to do
all kinds of metaprogramming during import time. In short, Python is a meta
programming language for RPython.
@@ -40,7 +40,7 @@
.. _`RPython`: coding-guide.html#RPython
-* The translation toolchain - this is the part that takes care about
translating
+* The translation toolchain - this is the part that takes care of translating
RPython to flow graphs and then to C. There is more in the `architecture`_
document written about it.
@@ -73,7 +73,7 @@
.. _`we have a tracing JIT`: jit/index.html
-* Garbage Collectors (GC): as you can notice if you are used to CPython's
+* Garbage Collectors (GC): as you may notice if you are used to CPython's
C code, there are no ``Py_INCREF/Py_DECREF`` equivalents in RPython code.
`Garbage collection in PyPy`_ is inserted
during translation. Moreover, this is not reference counting; it is a real
_______________________________________________
pypy-commit mailing list
pypy-commit@python.org
https://mail.python.org/mailman/listinfo/pypy-commit
