# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1333400267 -7200
# Node ID 23d8f07c9537384ce269e8bd39a7fb5d34ef4e9c
# Parent  270c81893a6159e127d86757104e79ed7d126d58
Added a table describing the different modes of operation.
Removed a somewhat irrelevant changelog note given the scale of the subsequent
modifications.

diff -r 270c81893a61 -r 23d8f07c9537 README.txt
--- a/README.txt	Mon Mar 12 23:46:50 2012 +0100
+++ b/README.txt	Mon Apr 02 22:57:47 2012 +0200
@@ -15,6 +15,23 @@
 the host system's distribution that the non-root approach no longer works,
 due to system library or kernel incompatibilities.
 
+The following table summarises the capabilities and limitations of the
+different modes of the software:
+
+  Programs              Unprivileged usage  Same distribution  Other versions
+  --------              ------------------  -----------------  --------------
+
+  user-*                Yes                 Yes                Probably not
+                                                               (sensitive to core
+                                                               library versions)
+
+  user-*                No                  Yes                Yes (subject to
+  (with --root option)                                         kernel suitability)
+
+  uml-*                 Yes (although       Yes                Yes
+                        networking must be
+                        set up by root)
+
 Contact, Copyright and Licence Information
 ------------------------------------------
 
@@ -40,7 +57,6 @@
 New in userinstall 0.2 (Changes since userinstall 0.1)
 ------------------------------------------------------
 
-  * Fixed an argument parsing error in the user-setup script.
   * Adopted lsb-release environment variables instead of new ones like
     DISTNAME, exposing derivatives of these variables by default.
   * Added explicit keyring package installation.