Include full stack trace for unexpected errors during background updates
[zeroinstall/zeroinstall-rsl.git] / README
blob672a6522e5f533bfff883a3a489574f703a570fb
1 The Zero Install Injector
3 Copyright Thomas Leonard, 2008
6 INTRODUCTION
8 A program is made up of many different components, typically written by
9 different groups of people. Each component is available in multiple versions.
10 The injector is used when starting a program. Its job is to decide which
11 implementation of each required component to use.
13 An interface describes what a component does. The injector starts with the
14 interface for the program you want to run (like 'The Gimp') and chooses an
15 implementation (like 'The Gimp 2.2.0'). However, this implementation will in
16 turn depend on other interfaces, such as 'GTK' (which draws the menus and
17 buttons). Thus, the injector must choose implementations of each dependancy
18 (each of which may require further interfaces, and so on).
20 See http://0install.net/injector.html for details.
23 INSTALLATION
25 The injector uses the normal Python distutils method of installation. To
26 install, become root and run setup.py like this:
28   $ su
29   [ enter root password ]
30   # python setup.py install
31   # exit
32   $
35 USE
37 To run a program by its URI:
39 $ 0launch http://rox.sourceforge.net/2005/interfaces/Edit
41 To run create short-cut:
43 $ 0alias rox-edit http://rox.sourceforge.net/2005/interfaces/Edit
45 For more information, see the man-pages for 0launch, 0alias and 0store.
47 CONDITIONS
49 This library is free software; you can redistribute it and/or
50 modify it under the terms of the GNU Lesser General Public
51 License as published by the Free Software Foundation; either
52 version 2.1 of the License, or (at your option) any later version.
54 This library is distributed in the hope that it will be useful,
55 but WITHOUT ANY WARRANTY; without even the implied warranty of
56 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
57 Lesser General Public License for more details.
59 You should have received a copy of the GNU Lesser General Public
60 License along with this library; if not, write to the Free Software
61 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
64 BUG REPORTS
66 Please report any bugs to the mailing list:
68         http://0install.net/support.html