# HG changeset patch # User Paul Boddie # Date 1188168969 -7200 # Node ID c42c5a534f78c771d68b60ffadcfd439933eff2b # Parent 499fcccef7917e7aee3eeb200f1190a9bf5bd3f6 Changed terminology, avoiding the term "repository" when it could be confused with places serving package content. diff -r 499fcccef791 -r c42c5a534f78 README.txt --- a/README.txt Mon Aug 27 00:08:15 2007 +0200 +++ b/README.txt Mon Aug 27 00:56:09 2007 +0200 @@ -3,10 +3,11 @@ The userinstall distribution consists of a number of scripts, together with a short configuration file, which allows non-root users to set up and use their -own package repository and to download and install Debian packages without -having to obtain root privileges. The software within installed packages may -then be used, subject to certain constraints such as program environments, -library paths, and so on. +own package and dependency management facilities and to download and install +Debian packages without having to obtain root privileges. The software within +installed packages may then be used, subject to certain constraints such as +program environments, library paths, and so on. In effect, userinstall +provides a personal package manager. Contact, Copyright and Licence Information ------------------------------------------ @@ -28,50 +29,53 @@ Configuration ------------- -If the system defaults are not to be used, or if the software is not installed +If the system defaults are not to be used, or if userinstall is not installed as a system package, the userinstall-defaults file supplied with the -distribution may be edited to specify the nature and location of the -repository. The following settings can be edited: +distribution may be edited to specify the nature and location of the personal +package manager. The following settings can be edited: DISTNAME This should reflect the distribution being used and need only be altered in special situations. -PACKAGEROOT The location of the repository in the filesystem. +PACKAGEROOT The location of the personal package manager in the + filesystem. If a completely new userinstall-defaults file is created, it is essential that the above variables be defined so that the scripts know where to create or to -find the repository. +find the personal package manager. -Creating a Repository ---------------------- +Creating a Personal Package Manager +----------------------------------- In order to install packages as a non-root user, first invoke the user-setup script; this will create and initialise a basic Debian system with a basic set of packages installed. For example, with userinstall installed as a system -package: +package, using the system defaults: user-setup -Or with local defaults: +Or with defaults in the current directory: ./user-setup -It is possible to override the "template" for the repository by specifying a +It is possible to override the "template" for the system by specifying a "mirror" location. This is useful if you have the CD or DVD image for the -distribution locally mounted. For example: +distribution already mounted in the filesystem. For example: user-setup file:///cdrom user-setup file:///home/me/downloads/kubuntu-7.04-alternate-i386.iso -Adding Package Sources to the Repository ----------------------------------------- +An URI must be specified as the "mirror" location, not a normal filename. -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 +Adding Package Repositories to the Package Manager +-------------------------------------------------- + +To get access to repositories of packages beyond those provided by the basic +distribution, edit the /etc/apt/sources.list file inside the system. The user-path script can help you find the exact location of the file: user-path /etc/apt/sources.list -Or with local defaults: +Or with defaults in the current directory: ./user-path /etc/apt/sources.list @@ -79,7 +83,7 @@ vi `user-path /etc/apt/sources.list` -Or with local defaults: +Or with defaults in the current directory: vi `./user-path /etc/apt/sources.list` @@ -94,7 +98,7 @@ user-apt-get install python-cmdsyntax Provided that the specified packages are known and their dependencies can be -met, they will be installed into the repository. +met, they will be installed into the system. Installing Single Packages -------------------------- @@ -104,8 +108,8 @@ user-dpkg-i /home/me/downloads/python-cmdsyntax_0.91-0ubuntu2_all.deb -This script will copy the file into the repository environment and run dpkg -with the -i (install) option. +This script will copy the file into the personal package management +environment and run dpkg with the -i (install) option. Using Packages -------------- @@ -128,8 +132,8 @@ 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: +are actually located within the personal package management environment. For +example, with the Python 2.5 site-packages directory: PYTHONPATH=`user-path /usr/lib/python2.5/site-packages/` python2.5 diff -r 499fcccef791 -r c42c5a534f78 userinstall-defaults --- a/userinstall-defaults Mon Aug 27 00:08:15 2007 +0200 +++ b/userinstall-defaults Mon Aug 27 00:56:09 2007 +0200 @@ -2,7 +2,7 @@ source /etc/lsb-release -# Configuration details for building and using a private package repository. +# Configuration details for building and using a personal package manager. export DISTNAME=$DISTRIB_CODENAME export PACKAGEROOT=$HOME/.userinstall