From 5006fda226a3fa6afda231df8aa733477bd4e420 Mon Sep 17 00:00:00 2001
From: kali <kali@leap.se>
Date: Fri, 7 Sep 2012 05:20:41 +0900
Subject: update README with tox info and PyQt annoyances

---
 README.txt | 36 ++++++++++++++++++++----------------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/README.txt b/README.txt
index a7c03f80..28971255 100644
--- a/README.txt
+++ b/README.txt
@@ -23,27 +23,31 @@ apt-get install python-qt4 python-qt4-doc pyqt4-dev-tools python-setuptools pyth
 Install
 ---------------
 
-If not using virtualenv:
+Global install:
 sudo python setup.py install
 
 If using virtualenv:
 python setup.py install
 
+Install PyQt
+------------
+pip install PyQt will fail because PyQt4 does not use the standard setup.py mechanism.
+Instead, they use configure.py which generates a Makefile.
 
-Running the App
------------------
+python configure.py
+make && make install
 
-You need to set up a provider in your eip.cfg file:
+You can:
 
-cd ~/.config/leap
-vim eip.cfg
+* install PyQt globally and make a virtualenv with --site-packages
+* run pkg/install_pyqt.sh inside your virtualenv (with --no-site-packages)
+* run pkg/postmkvenv.sh after creating your virtualenv, for making symlinks to your global PyQt installation.
 
-[provider]
-remote_ip = XXX.XXX.XXX.XXX
 
-and then run:
+Running the App
+-----------------
 
-leap --debug
+leap --debug --logfile /tmp/leap.log
 
 (or python app.py --debug if you run it from the src/leap folder).
 
@@ -66,6 +70,11 @@ or
 
 nosetests leap.util.test_leap_argparse
 
+Tox
+---
+For running testsuite against all the supported python versions (currently 2.6 and 2.7), run:
+
+tox -v
 
 Test-deps
 ---------
@@ -78,14 +87,9 @@ Hack
 (recommended)
 virtualenv .  # ensure your .gitignore knows about it
 bin/activate
-
-# you should probably simlink sip.so and PyQt4 to your system-wide
-# install, there are some issues with it.
-
+pkg/postmkvenv.sh
 python setup.py develop  
 
-# ... TBD: finish develop howto.
-# ... and explain how is python setup develop useful.
 
 Compiling resource/ui files
 -----------------------------
-- 
cgit v1.2.3