Permalink
Browse files

update README and INSTALL.txt

git-svn-id: https://pyjamas.svn.sourceforge.net/svnroot/pyjamas/trunk@895 7a2bd370-bda8-463c-979e-2900ccfb811e
  • Loading branch information...
1 parent 180b1d4 commit 85db82c09629fefab6b8cfa8496ccdf0b01ccd18 lkcl committed Jul 10, 2009
Showing with 42 additions and 22 deletions.
  1. +17 −16 INSTALL.txt
  2. +25 −6 README
View
33 INSTALL.txt
@@ -2,16 +2,27 @@
Installing Pyjamas
==================
+BEFORE PROCEEDING READ THE FOLLOWING WARNING.
+
+DO NOT install the pyjamas libraries into /usr/share/python-support,
+/usr/lib/python2.N/site-packages or ANY location where the "standard"
+python interpreter could possibly pick them up. The pyjamas libraries
+have nothing to do with python libraries when used by the compiler,
+and contain replacements for sys.py, time.py and other modules that
+are critical to pyjamas. It goes without saying that if you overwrite
+the standard python modules with the pyjamas equivalents, you will run into
+massive problems. Don't do it.
+
Developer Sandbox Setup
=======================
In this directory run:
python bootstrap.py
-The files ``./bin/pyjsbuild`` and ``./bin/pyjscompile`` will be created,
-custom-tailored with hard-coded paths specific to the exact absolute
-location that the bootstrap.py command is run from. In this way, you
+The files ``pyjd/__init__.py``, ``./bin/pyjsbuild`` and ``./bin/pyjscompile``
+will be created, custom-tailored with hard-coded paths specific to the exact
+absolute location that the bootstrap.py command is run from. In this way, you
will be able to install, test and use multiple versions of Pyjamas, without
cross-interference.
@@ -35,16 +46,16 @@ and ./bin/pyjscompile commands. For example:
python boostrap.py /usr/bin /usr/share/pyjamas
-After ./bin/pyjsbuild and ./bin/pyjscompile commands have been created,
-they can now be installed system-wide, along with the libraries.
+After ./pyjd/__init__.py, ./bin/pyjsbuild and ./bin/pyjscompile have been
+created, they can now be installed system-wide, along with the libraries.
python run_bootstrap_first_then_setup.py install
You *may* need to specify --install-data={pickasuitablelocation}
and you *may* need to specify the same location to the bootstrap.py
command (prior to running run_bootstrap_first_then_setup.py)
- python boostrap.py /usr/bin {pickasuitablelocation}
+ python bootstrap.py /usr/bin {pickasuitablelocation}
The commands pyjscompile and pyjsbuild will be installed;
the boilerplate web templates, the pyjamas "builtin" libraries
@@ -57,13 +68,3 @@ path is:
You can over-ride this default location with the PYJSPREFIX
environment variable.
-*** WARNING ***
-
-DO NOT install the pyjamas libraries into /usr/share/python-support,
-/usr/lib/python2.N/site-packages or ANY location where the "standard"
-python interpreter could possibly pick them up. The pyjamas libraries
-have nothing to do with python libraries, and if you ever install
-pyjamas-desktop, which DOES provide identical pyjamas libraries that
-have been altered to use pywebkitgtk (instead of being compiled to
-javascript), you will run into massive problems.
-
View
31 README
@@ -11,15 +11,34 @@ For more information, see:
Pyjamas-Desktop
---------------
-A parallel project is Pyjamas-Desktop: a port of Pyjamas to the
-desktop, using WebKit (http://webkit.org) or Hulahop
-(http://wiki.laptop.org/go/HulaHop)
-
-Both projects support exactly the same set of widgets; exactly the
-same API; provide exactly the same functionality.
Pyjamas runs your application in a Web Browser; Pyjamas-Desktop runs
exactly the same python application on the Desktop.
http://pyjd.org
+Release 0.6 of Pyjamas also incorporates Pyjamas-Desktop directly into
+the Pyjamas Distribution. To use Pyjamas-Desktop there are two choices,
+with more planned (MacOSX PyObjC; Windows python-win32com MSHTML; KDE's
+PyKHTML).
+
+1) - Gecko / XulRunner
+
+install hulahop and python-xpcom. hulahop is distributed with
+both Debian and Ubuntu; python-xpcom is part of XULRunner and is
+also distributed with both Debian and Ubuntu. Other users should
+investigate the installation instructions for python-xpcom and
+hulahop for the operating system of their choice on the appropriate
+web sites.
+
+2) - PyWebKitGtk
+
+you will need a patched version of pywebkitgtk:
+http://code.google.com/p/pywebkitgtk/issues/detail?id=13
+
+you will need a patched version of webkit:
+http://github.com/lkcl/webkit/16401.master
+
+Detailed build instructions are available on http://pyjd.org
+
+

0 comments on commit 85db82c

Please sign in to comment.