blob: 06d304df1132416c78cbdcfa49e5c8750e8e8dcf [file] [log] [blame]
.TH WEB 1
.SH NAME
web, wmail \- handle web page, mail message for plumber
.SH SYNOPSIS
.B web
.I url
\&...
.br
.B wmail
.I address
.SH DESCRIPTION
.I Web
opens each of the named
.I urls
in a new web browser window.
Any of the
.I urls
may be relative paths to files in the file system;
they will be translated into
.B file://
URLs before being passed to the web browser.
.PP
.I Web
uses the
web browser's
.B -remote
option command-line option,
which requires an instance of the web browser
to be already running.
The choice of browser is determined by the
.B $BROWSER
environment variable, which should be the name of
the executable for your choice of web browser.
The default is
.BR firefox .
Since the various browsers all use different syntaxes
in their
.B -remote
options, the executable name is inspected to determine
the type of browser.
The supported browsers are Opera, Mozilla Firefox, Mozilla Firebird, and Mozilla.
When possible,
.I web
opens each URL in a new tab rather than a new window.
.PP
When run under Mac OS X,
.B $BROWSER
should be set to
.B camino ,
.B firefox ,
or
.BR safari .
.I Web
uses AppleScript to talk to the browser.
If
.B $BROWSER
is not set,
.I web
looks for Firefox in
.BR /Applications/Firefox.app
and uses it if found;
otherwise it uses Safari.
.PP
.I Wmail
starts the composition of a new mail message to
.IR address .
.PP
The choice of mailer is determined by the
.B $MAILER
environment variable.
The supported mailers are:
.TP
.B browser
invoke the mailer via a
.B mailto://
URL passed to
.I web
.PD
.PP
.I Web
and
.I wmail
are invoked as start commands in the
.IR plumber (4)'s
rules for opening web pages and writing mail messages.
.SH FILES
.TP
.B \*9/plumb/basic
plumbing rules using
.I web
and
.I wmail
.SH SOURCE
.B \*9/bin
.SH SEE ALSO
.IR plumber (4)