# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1188155152 -7200
# Node ID b9ac6a3d4aae47b56fc80d048aae925b574e7563
# Parent  2c6c87afd5aed89d39dbfcb984d3a4d541bec98b
Added user-path.
Tidied user-path usage in the documentation and added installed package usage
notes.

diff -r 2c6c87afd5ae -r b9ac6a3d4aae README.txt
--- a/README.txt	Sun Aug 26 20:45:41 2007 +0200
+++ b/README.txt	Sun Aug 26 21:05:52 2007 +0200
@@ -66,22 +66,22 @@
 ----------------------------------------
 
 To get access to sources of packages beyond those provided by the basic
-distribution, edit the etc/apt/sources.list file inside the repository. The
+distribution, edit the /etc/apt/sources.list file inside the repository. The
 user-path script can help you find the exact location of the file:
 
-user-path etc/apt/sources.list
+user-path /etc/apt/sources.list
 
 Or with local defaults:
 
-./user-path etc/apt/sources.list
+./user-path /etc/apt/sources.list
 
 And you can edit the file directly with a text editor (such as vi) as follows:
 
-vi `user-path etc/apt/sources.list`
+vi `user-path /etc/apt/sources.list`
 
 Or with local defaults:
 
-vi `./user-path etc/apt/sources.list`
+vi `./user-path /etc/apt/sources.list`
 
 Installing Packages
 -------------------
@@ -106,3 +106,29 @@
 
 This script will copy the file into the repository environment and run dpkg
 with the -i (install) option.
+
+Using Packages
+--------------
+
+Unlike most packages installed in the usual way by the root user, the installed
+packages will not reside within a directory hierarchy rooted at / - the top of
+the filesystem. Instead, they will reside in a location such as the following:
+
+/home/me/.userinstall
+/tmp/packages
+
+(The precise location may be found by running the user-path script.)
+
+Consequently, to make use of the installed software, it may be necessary to
+edit your environment in a number of ways so that it may be located and
+correctly loaded, initialised and executed.
+
+Using Python Packages
+---------------------
+
+Installed Python packages may be made available to Python by defining the
+PYTHONPATH to include the directories usually searched by Python, but which
+are actually located within the repository. For example, with the Python 2.5
+site-packages directory:
+
+PYTHONPATH=`user-path /usr/lib/python2.5/site-packages/` python
diff -r 2c6c87afd5ae -r b9ac6a3d4aae user-path
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/user-path	Sun Aug 26 21:05:52 2007 +0200
@@ -0,0 +1,14 @@
+#!/bin/bash
+# Usage: user-dirpath <path-inside-package-root>
+
+# Configuration:
+if [ -e userinstall-defaults ]; then
+        source userinstall-defaults
+elif [ -e /etc/defaults/userinstall ]; then
+        source /etc/defaults/userinstall
+else
+        echo "No defaults found for userinstall."
+        exit 1
+fi
+
+echo $PACKAGEROOT/$1