1.1 --- a/README.txt Mon Aug 27 00:08:15 2007 +0200
1.2 +++ b/README.txt Mon Aug 27 00:56:09 2007 +0200
1.3 @@ -3,10 +3,11 @@
1.4
1.5 The userinstall distribution consists of a number of scripts, together with a
1.6 short configuration file, which allows non-root users to set up and use their
1.7 -own package repository and to download and install Debian packages without
1.8 -having to obtain root privileges. The software within installed packages may
1.9 -then be used, subject to certain constraints such as program environments,
1.10 -library paths, and so on.
1.11 +own package and dependency management facilities and to download and install
1.12 +Debian packages without having to obtain root privileges. The software within
1.13 +installed packages may then be used, subject to certain constraints such as
1.14 +program environments, library paths, and so on. In effect, userinstall
1.15 +provides a personal package manager.
1.16
1.17 Contact, Copyright and Licence Information
1.18 ------------------------------------------
1.19 @@ -28,50 +29,53 @@
1.20 Configuration
1.21 -------------
1.22
1.23 -If the system defaults are not to be used, or if the software is not installed
1.24 +If the system defaults are not to be used, or if userinstall is not installed
1.25 as a system package, the userinstall-defaults file supplied with the
1.26 -distribution may be edited to specify the nature and location of the
1.27 -repository. The following settings can be edited:
1.28 +distribution may be edited to specify the nature and location of the personal
1.29 +package manager. The following settings can be edited:
1.30
1.31 DISTNAME This should reflect the distribution being used and need only
1.32 be altered in special situations.
1.33 -PACKAGEROOT The location of the repository in the filesystem.
1.34 +PACKAGEROOT The location of the personal package manager in the
1.35 + filesystem.
1.36
1.37 If a completely new userinstall-defaults file is created, it is essential that
1.38 the above variables be defined so that the scripts know where to create or to
1.39 -find the repository.
1.40 +find the personal package manager.
1.41
1.42 -Creating a Repository
1.43 ----------------------
1.44 +Creating a Personal Package Manager
1.45 +-----------------------------------
1.46
1.47 In order to install packages as a non-root user, first invoke the user-setup
1.48 script; this will create and initialise a basic Debian system with a basic set
1.49 of packages installed. For example, with userinstall installed as a system
1.50 -package:
1.51 +package, using the system defaults:
1.52
1.53 user-setup
1.54
1.55 -Or with local defaults:
1.56 +Or with defaults in the current directory:
1.57
1.58 ./user-setup
1.59
1.60 -It is possible to override the "template" for the repository by specifying a
1.61 +It is possible to override the "template" for the system by specifying a
1.62 "mirror" location. This is useful if you have the CD or DVD image for the
1.63 -distribution locally mounted. For example:
1.64 +distribution already mounted in the filesystem. For example:
1.65
1.66 user-setup file:///cdrom
1.67 user-setup file:///home/me/downloads/kubuntu-7.04-alternate-i386.iso
1.68
1.69 -Adding Package Sources to the Repository
1.70 -----------------------------------------
1.71 +An URI must be specified as the "mirror" location, not a normal filename.
1.72
1.73 -To get access to sources of packages beyond those provided by the basic
1.74 -distribution, edit the /etc/apt/sources.list file inside the repository. The
1.75 +Adding Package Repositories to the Package Manager
1.76 +--------------------------------------------------
1.77 +
1.78 +To get access to repositories of packages beyond those provided by the basic
1.79 +distribution, edit the /etc/apt/sources.list file inside the system. The
1.80 user-path script can help you find the exact location of the file:
1.81
1.82 user-path /etc/apt/sources.list
1.83
1.84 -Or with local defaults:
1.85 +Or with defaults in the current directory:
1.86
1.87 ./user-path /etc/apt/sources.list
1.88
1.89 @@ -79,7 +83,7 @@
1.90
1.91 vi `user-path /etc/apt/sources.list`
1.92
1.93 -Or with local defaults:
1.94 +Or with defaults in the current directory:
1.95
1.96 vi `./user-path /etc/apt/sources.list`
1.97
1.98 @@ -94,7 +98,7 @@
1.99 user-apt-get install python-cmdsyntax
1.100
1.101 Provided that the specified packages are known and their dependencies can be
1.102 -met, they will be installed into the repository.
1.103 +met, they will be installed into the system.
1.104
1.105 Installing Single Packages
1.106 --------------------------
1.107 @@ -104,8 +108,8 @@
1.108
1.109 user-dpkg-i /home/me/downloads/python-cmdsyntax_0.91-0ubuntu2_all.deb
1.110
1.111 -This script will copy the file into the repository environment and run dpkg
1.112 -with the -i (install) option.
1.113 +This script will copy the file into the personal package management
1.114 +environment and run dpkg with the -i (install) option.
1.115
1.116 Using Packages
1.117 --------------
1.118 @@ -128,8 +132,8 @@
1.119
1.120 Installed Python packages may be made available to Python by defining the
1.121 PYTHONPATH to include the directories usually searched by Python, but which
1.122 -are actually located within the repository. For example, with the Python 2.5
1.123 -site-packages directory:
1.124 +are actually located within the personal package management environment. For
1.125 +example, with the Python 2.5 site-packages directory:
1.126
1.127 PYTHONPATH=`user-path /usr/lib/python2.5/site-packages/` python2.5
1.128
2.1 --- a/userinstall-defaults Mon Aug 27 00:08:15 2007 +0200
2.2 +++ b/userinstall-defaults Mon Aug 27 00:56:09 2007 +0200
2.3 @@ -2,7 +2,7 @@
2.4
2.5 source /etc/lsb-release
2.6
2.7 -# Configuration details for building and using a private package repository.
2.8 +# Configuration details for building and using a personal package manager.
2.9
2.10 export DISTNAME=$DISTRIB_CODENAME
2.11 export PACKAGEROOT=$HOME/.userinstall