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