[pypy-commit] pypy default: Add a "Packaging" section and mention it's needed to run it

[arigo]

Author: Armin Rigo <arigo at tunes.org>
Branch: 
Changeset: r76682:72b016aec157
Date: 2015-04-01 17:24 +0200
http://bitbucket.org/pypy/pypy/changeset/72b016aec157/

Log:	Add a "Packaging" section and mention it's needed to run it

diff --git a/pypy/doc/build.rst b/pypy/doc/build.rst
--- a/pypy/doc/build.rst
+++ b/pypy/doc/build.rst
@@ -146,6 +146,26 @@
 :doc:`objspace proxies <objspace-proxies>` document.
 
 
+Packaging (preparing for installation)
+--------------------------------------
+
+Packaging is required if you want to install PyPy system-wide, even to
+install on the same machine.  The reason is that doing so prepares a
+number of extra features that cannot be done lazily on a root-installed
+PyPy, because the normal users don't have write access.  This concerns
+mostly libraries that would normally be compiled if and when they are
+imported the first time.
+
+::
+    
+    cd pypy/tool/release
+    ./package.py pypy-VER-PLATFORM
+
+This creates a clean and prepared hierarchy, as well as a ``.tar.bz2``
+with the same content; both are found by default in
+``/tmp/usession-YOURNAME/build/``.  You can then either move the file
+hierarchy or unpack the ``.tar.bz2`` at the correct place.
+
 
 Installation
 ------------