0launch.1

   1 .TH 0LAUNCH 1 "2011" "Thomas Leonard" ""
   2 .SH NAME
   3 0launch \(em download and run programs by URL
   4
   5 .SH SYNOPSIS
   6
   7 .B 0launch
   8 [\fBOPTION\fP]... \fBPROGRAM\fP [\fBARG\fP]...
   9
  10 .SH DESCRIPTION
  11 .PP
  12 0launch runs the given program. PROGRAM is either a URL in the form
  13 `http://site/program.xml' or a local path name like `/path/to/program.xml'.
  14
  15 .PP
  16 If the program is not already on your computer, 0launch downloads information about
  17 which versions are available, and lets you choose one to download. It will also
  18 (automatically) do the same for any libraries the program needs.
  19
  20 .PP
  21 Note that much of the functionality that was originally in 0launch has now moved to
  22 0install(1).
  23
  24 .B 0launch PROGRAM ARGS
  25
  26 .PP
  27 is roughly equivalent to
  28
  29 .B 0install run PROGRAM ARGS
  30
  31 See the 0install(1) man-page for more information.
  32
  33 .SH EXAMPLES
  34
  35 .PP
  36 When a program is available using 0launch, it will have an associated URL. To
  37 run the program, simply invoke 0launch with this as an argument:
  38
  39 .B 0launch http://rox.sourceforge.net/2005/interfaces/Edit
  40
  41 .PP
  42 The first time you do this, details about the program are downloaded and
  43 cached, and you will be prompted to confirm the versions to use. In future,
  44 the program will run directly from the cache without confirmation.
  45
  46 .PP
  47 To check for new versions:
  48
  49 .B 0launch \-\-refresh http://rox.sourceforge.net/2005/interfaces/Edit
  50
  51 .PP
  52 To avoid having to keep typing the full URI, use the 0alias(1) command
  53 to create shortcuts to run your programs.
  54
  55 .SH COMMAND-LINE OPTIONS
  56
  57 .TP
  58 0launch takes many of the same options as "0install run". This page just lists the differences:
  59
  60 .TP
  61 \fB\-d\fP, \fB\-\-download\-only\fP
  62 Deprecated. Use "0install download" instead.
  63
  64 .TP
  65 \fB\-f\fP, \fB\-\-feed\fP
  66 Deprecated. Use "0install add-feed" or "0install remove-feed" instead.
  67
  68 .TP
  69 \fB\-\-get\-selections\fP
  70 Deprecated. Use "0install select" instead.
  71
  72 .TP
  73 \fB\-i\fP, \fB\-\-import\fP
  74 Deprecated. Use "0install import" instead.
  75
  76 .TP
  77 \fB\-l\fP, \fB\-\-list\fP
  78 Deprecated. Use "0install list" instead.
  79
  80 .TP
  81 \fB\-\-select\-only\fP
  82 Deprecated. Use "0install select" instead.
  83
  84 .TP
  85 \fB\-\-set\-selections=FILE\fP
  86 Deprecated. Just give FILE as the PROGRAM.
  87
  88 .TP
  89 \fB\-\-show\fP
  90 Deprecated. Use "0install select" instead.
  91
  92 .SH DEBUGGING TIPS
  93
  94 .PP
  95 To debug 0launch itself, use the \-\-verbose and \-\-console options. For example:
  96
  97 .B $ 0launch \-vvc http://myprog
  98
  99 .PP
 100 To trace or debug programs run by 0launch, use the \-\-wrapper option.
 101 For example, to run \fBmyprog \-\-help\fP, displaying all calls to open(2):
 102
 103 .B $ 0launch \-\-wrapper="strace \-e open" http://myprog \-\-help
 104
 105 If your program is interpreted (e.g. a Python program), and you wish to debug
 106 the interpreter running it, you can do it like this:
 107
 108 .B $ 0launch \-\-wrapper="gdb \-\-args python" http://myprog \-\-help
 109
 110 .SH FILES
 111
 112 Configuration files (see freedesktop.org basedir spec):
 113
 114 .IP "~/.config/0install.net/injector/global"
 115 Global configuration settings.
 116
 117 .IP "~/.config/0install.net/injector/trustdb.xml"
 118 List of trusted keys.
 119
 120 .IP "~/.config/0install.net/injector/interfaces"
 121 Per-interface settings, and extra feeds.
 122
 123 .PP
 124 Cached data (can be re-downloaded if lost):
 125
 126 .IP "~/.cache/0install.net/interfaces"
 127 Downloaded cached feed files.
 128
 129 .IP "~/.cache/0install.net/implementations"
 130 Downloaded cached implementations, indexed by manifest digest.
 131
 132 .PP
 133 See the 0store(1) man page for more information.
 134
 135 .SH LICENSE
 136 .PP
 137 Copyright (C) 2011 Thomas Leonard.
 138
 139 .PP
 140 You may redistribute copies of this program under the terms of the GNU Lesser General Public License.
 141 .SH BUGS
 142 .PP
 143 Please report bugs to the developer mailing list:
 144
 145 http://0install.net/support.html
 146
 147 .SH AUTHOR
 148 .PP
 149 Zero Install was created by Thomas Leonard.
 150
 151 .SH SEE ALSO
 152 0install(1), 0alias(1), 0store(1)
 153 .PP
 154 The Zero Install web-site:
 155
 156 .B http://0install.net