0alias.1

   1 .TH 0ALIAS 1 "2007" "Thomas Leonard" ""
   2 .SH NAME
   3 0alias \- create quick scripts to run 0launch
   4
   5 .SH SYNOPSIS
   6
   7 .B 0alias
   8 \fBALIAS\fP [\fBINTERFACE\fP [\fBCOMMAND\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 specifiy which
  40 one to use instead of the default. Eg:
  41
  42 .B 0alias svn http://example.com/subversion
  43
  44 .B 0alias svnadmin http://example.com/subversion svnadmin
  45
  46
  47 .SH COMMAND-LINE OPTIONS
  48
  49 .TP
  50 \fB-d=DIR\fP, \fB--dir=DIR\fP
  51 Install the script into directory DIR, rather than searching for a suitable
  52 directory in $PATH.
  53
  54 .TP
  55 \fB-h\fP, \fB--help\fP
  56 Show the built-in help text.
  57
  58 .TP
  59 \fB-m\fP, \fB--manpage\fP
  60 Display the manpage for the alias script given as the single argument. The
  61 alias can be an absolute pathname, or the name of a script in $PATH. If the
  62 argument isn't an alias script, or if multiple arguments are given, then all
  63 arguments are passed to the system 'man' command. This allows you to alias your
  64 man command like this:
  65
  66 alias man='0alias --manpage'
  67
  68 .TP
  69 \fB-r\fP, \fB--resolve\fP
  70 Print the interface URI for the given alias script to stdout.
  71
  72 .TP
  73 \fB-V\fP, \fB--version\fP
  74 Display version information.
  75
  76 .SH LICENSE
  77 .PP
  78 Copyright (C) 2007 Thomas Leonard.
  79
  80 .PP
  81 You may redistribute copies of this program under the terms of the GNU Lesser General Public License.
  82 .SH BUGS
  83 .PP
  84 Please report bugs to the developer mailing list:
  85
  86 http://0install.net/support.html
  87
  88 .SH AUTHOR
  89 .PP
  90 The Zero Install Injector was created by Thomas Leonard.
  91
  92 .SH SEE ALSO
  93 0launch(1), 0desktop(1)
  94 .PP
  95 The Zero Install web-site:
  96
  97 .B http://0install.net