0alias.1

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