README: clarify/edit build, install, and test instructions

diff --git a/README b/README
index 40257a6d9cda138f596aefc3c3255f440bd445d3..62661cd01947cdcdd58d1af58f7ead7d81b1870a 100644 (file)
--- a/README
+++ b/README
@@ -143,7 +143,8 @@ BUILDING:
 
 INSTALLING:
 
-There are three ways to do it.  Choose one:
+There are three ways to do it: The Debian Way, The Python Way, and The
+Running-In-Place Way.  Choose one:
 
  The Debian Way:
 
@@ -163,7 +164,7 @@ There are three ways to do it.  Choose one:
 
  The Python Way:
 
-  Just run make install.
+  Just run make install.  (This works on cygwin and Windows, too.)
 
   In case you want to configure the location or other install options you can
   learn how it is done here:
@@ -185,17 +186,19 @@ There are three ways to do it.  Choose one:
 
   The Running-In-Place Way is to add a directory to your PYTHONPATH.
 
-  To run from a source tree (without installing first), type 'make', which
-  will put all the necessary libraries into a local directory named
-  "./instdir/lib", which you can then add to your PYTHONPATH .  (It will put
-  executables into "./instdir/bin".)
+  To run from a source tree (without installing first) just build it
+  (i.e. type 'make'), which will put all the necessary libraries into a local
+  directory named "./instdir/lib", which you can then add to your 
+  PYTHONPATH .  It will put executables into "./instdir/bin".
 
 
 TESTING THAT IT IS PROPERLY INSTALLED
 
- To test that all the modules got installed properly, start a python
- interpreter and import modules as follows.  If each one imports successfully
- instead of raising ImportError then it is correctly installed.
+ To test that all the modules got installed properly, cd to the root
+ directory of the tahoe source distribution (the directory which contains
+ this README file), start a python interpreter and import modules as follows.
+ If each one imports successfully instead of raising ImportError then it is
+ correctly installed.
 
    % python
    Python 2.4.4 (#2, Jan 13 2007, 17:50:26)