0launch.1

   1 .TH 0LAUNCH 1 "2005" "Thomas Leonard" ""
   2 .SH NAME
   3 0launch \- download and run programs by URL
   4
   5 .SH SYNOPSIS
   6
   7 .B 0launch
   8 [\fBOPTION\fP]... \fBINTERFACE\fP [\fBARG\fP]...
   9
  10 .B 0launch
  11 --list [\fBSEARCH-TERM\fP]
  12
  13 .B 0launch
  14 --import [\fBINTERFACE-FILES\fP]
  15
  16 .SH DESCRIPTION
  17 .PP
  18 A program is made up of many different components, typically written by
  19 different groups of people. Each component is available in multiple versions.
  20 The injector is used when starting a program. Its job is to decide which
  21 implementation of each required component to use.
  22
  23 .PP
  24 An interface describes what a component does. The injector starts with the
  25 interface for the program you want to run (like 'The Gimp') and chooses an
  26 implementation (like 'The Gimp 2.2.0'). However, this implementation will in
  27 turn depend on other interfaces, such as 'GTK' (which draws the menus and
  28 buttons). Thus, the injector must choose implementations of each dependancy
  29 (each of which may require further interfaces, and so on).
  30
  31 .SH EXAMPLES
  32
  33 .PP
  34 When a program is available using 0launch, it will have an associated URL. To
  35 run the program, simply invoke 0launch with this as an argument:
  36
  37 .B 0launch http://rox.sourceforge.net/2005/interfaces/Edit
  38
  39 .PP
  40 The first time you do this, details about the program are downloaded and
  41 cached, and you will be prompted to confirm the versions to use. In future,
  42 the program will run directly from the cache without confirmation.
  43
  44 .PP
  45 To check for new versions:
  46
  47 .B 0launch --refresh http://rox.sourceforge.net/2005/interfaces/Edit
  48
  49 .PP
  50 To search the list of cached URLs:
  51
  52 .B 0launch --list Edit
  53
  54 .SH COMMAND-LINE OPTIONS
  55
  56 .TP
  57 \fB-c\fP, \fB--console\fP
  58 Never use the GUI. Normally, 0launch switches to graphical mode if it needs to
  59 download anything from the network (unless DISPLAY is not set).
  60
  61 .TP
  62 \fB-d\fP, \fB--download-only\fP
  63 Download any needed files, but stop before actually running the program.
  64
  65 .TP
  66 \fB-D\fP, \fB--dry-run\fP
  67 Just print what actions would be taken.
  68
  69 .TP
  70 \fB-g\fP, \fB--gui\fP
  71 Show the graphical policy editor. This allows you to select which version of
  72 a program or library to use.
  73
  74 .TP
  75 \fB-h\fP, \fB--help\fP
  76 Show the built-in help text.
  77
  78 .TP
  79 \fB-i\fP, \fB--import\fP
  80 Import from files, not from the network. This is useful when testing an
  81 interface file, to avoid uploading it to a remote server in order to download
  82 it again. It might also be useful when installing from a CD or similar.
  83
  84 .TP
  85 \fB-l\fP, \fB--list\fP
  86 List all known interface (program) URIs. If a search term is given, only
  87 URIs containing that string are shown (case insensitive).
  88
  89 .TP
  90 \fB-r\fP, \fB--refresh\fP
  91 Fetch a fresh copy of all used interfaces. This will normally switch to GUI
  92 mode, unless --console is also given.
  93
  94 .TP
  95 \fB-v\fP, \fB--verbose\fP
  96 More verbose output. Use twice for even more verbose output.
  97
  98 .TP
  99 \fB-V\fP, \fB--version\fP
 100 Display version information.
 101
 102 .SH FILES
 103
 104 Configuration files (see freedesktop.org basedir spec):
 105
 106 .IP "~/.config/0install.net/injector/global"
 107 Global configuration settings.
 108
 109 .IP "~/.config/0install.net/injector/trust"
 110 List of trusted keys.
 111
 112 .IP "~/.config/0install.net/injector/user_overrides"
 113 Per-interface settings.
 114
 115 .IP "~/.config/0install.net/injector/local_interfaces"
 116 Extra implementations to add to the upstream list.
 117
 118 .PP
 119 Cached data (can be re-downloaded if lost):
 120
 121 .IP "~/.cache/0install.net/interfaces"
 122 Downloaded cached interface files.
 123
 124 .IP "~/.cache/0install.net/implementations"
 125 Downloaded cached implementations, indexed by manifest digest.
 126
 127 .SH LICENSE
 128 .PP
 129 Copyright (C) 2005 Thomas Leonard.
 130
 131 .PP
 132 You may redistribute copies of this program under the terms of the GNU General Public License.
 133 .SH BUGS
 134 .PP
 135 Please report bugs to the developer mailing list:
 136
 137 http://0install.net/support.html
 138
 139 .SH AUTHOR
 140 .PP
 141 The Zero Install Injector was created by Thomas Leonard.
 142
 143 .SH SEE ALSO
 144 0alias(1), 0store(1)
 145 .PP
 146 The Zero Install web-site:
 147
 148 .B http://0install.net