0alias.1

   1 .TH 0ALIAS 1 "2011" "Thomas Leonard" ""
   2 .SH NAME
   3 0alias \(em create quick scripts to run 0launch
   4
   5 .SH SYNOPSIS
   6
   7 .B 0alias
   8 \fBALIAS\fP [\fBINTERFACE\fP [\fBMAIN\fP]]
   9
  10 .SH DESCRIPTION
  11 .PP
  12 Having to keep typing the full URI for a program each time you want to run it
  13 with 0launch is annoying. 0alias will create a little script in your PATH to
  14 do it for you.
  15
  16 .SH EXAMPLES
  17
  18 .PP
  19 A program can be invoked using 0launch:
  20
  21 .B 0launch http://rox.sourceforge.net/2005/interfaces/Edit
  22
  23 .PP
  24 To avoid having to keep entering the URI, create an alias:
  25
  26 .B 0alias rox\-edit http://rox.sourceforge.net/2005/interfaces/Edit
  27
  28 .PP
  29 To run Edit now:
  30
  31 .B rox\-edit
  32
  33 .PP
  34 To select a different version, or check for updates:
  35
  36 .B 0alias rox\-edit
  37
  38 .PP
  39 If an interface provides more than one program, you can specify which
  40 one to use instead of the default. e.g.
  41
  42 .B 0alias svn http://example.com/subversion
  43
  44 .B 0alias svnadmin http://example.com/subversion svnadmin
  45
  46 .PP
  47 (this is for older programs that use MAIN; for newer programs you may need to
  48 use \-\-command instead)
  49
  50
  51 .SH COMMAND-LINE OPTIONS
  52
  53 .TP
  54 \fB\-c=COMMAND\fP, \fB\-\-command=COMMAND\fP
  55 The generated script will execute COMMAND rather than the default ("run").
  56
  57 .TP
  58 \fB\-d=DIR\fP, \fB\-\-dir=DIR\fP
  59 Install the script into directory DIR, rather than searching for a suitable
  60 directory in $PATH.
  61
  62 .TP
  63 \fB\-h\fP, \fB\-\-help\fP
  64 Show the built-in help text.
  65
  66 .TP
  67 \fB\-m\fP, \fB\-\-manpage\fP
  68 Display the manpage for the alias script given as the single argument. The
  69 alias can be an absolute pathname, or the name of a script in $PATH. If the
  70 argument isn't an alias script, or if multiple arguments are given, then all
  71 arguments are passed to the system 'man' command. This allows you to alias your
  72 man command like this:
  73
  74 alias man='0alias \-\-manpage'
  75
  76 .TP
  77 \fB\-r\fP, \fB\-\-resolve\fP
  78 Print the interface URI for the given alias script to stdout.
  79
  80 .TP
  81 \fB\-V\fP, \fB\-\-version\fP
  82 Display version information.
  83
  84 .SH LICENSE
  85 .PP
  86 Copyright (C) 2011 Thomas Leonard.
  87
  88 .PP
  89 You may redistribute copies of this program under the terms of the GNU Lesser General Public License.
  90 .SH BUGS
  91 .PP
  92 Please report bugs to the developer mailing list:
  93
  94 http://0install.net/support.html
  95
  96 .SH AUTHOR
  97 .PP
  98 The Zero Install Injector was created by Thomas Leonard.
  99
 100 .SH SEE ALSO
 101 0launch(1), 0desktop(1)
 102 .PP
 103 The Zero Install web-site:
 104
 105 .B http://0install.net