1 .TH WEB 1
2 .SH NAME
3 web, wmail \- handle web page, mail message for plumber
4 .SH SYNOPSIS
5 .B web
6 .I url
7 \&...
8 .br
9 .B wmail
10 .I address
11 .SH DESCRIPTION
12 .I Web
13 opens each of the named
14 .I urls
15 in a new web browser window.
16 Any of the
17 .I urls
18 may be relative paths to files in the file system;
19 they will be translated into
20 .B file://
21 URLs before being passed to the web browser.
22 .PP
23 .I Web
24 uses the
25 web browser's
26 .B -remote
27 option command-line option,
28 which requires an instance of the web browser
29 to be already running.
30 The choice of browser is determined by the
31 .B $BROWSER
32 environment variable, which should be the name of
33 the executable for your choice of web browser.
34 Since the various browsers all use different syntaxes
35 in their
36 .B -remote
37 options, the executable name is inspected to determine
38 the type of browser.
39 The supported browsers are Opera, Mozilla Firefox, Mozilla Firebird, and Mozilla.
40 When possible,
41 .I web
42 opens each URL in a new tab rather than a new window.
43 .PP
44 .I Wmail
45 starts the composition of a new mail message to
46 .IR address .
47 .PP
48 The choice of mailer is determined by the 
49 .B $MAILER
50 environment variable.
51 The supported mailers are:
52 .TP browser
53 invoke the mailer via a
54 .B mailto://
55 URL passed to
56 .I web
57 .PD
58 .PP
59 .I Web
60 and
61 .I wmail
62 are invoked as start commands in the
63 .IR plumber (4)'s
64 rules for opening web pages and writing mail messages.
65 .SH FILES
66 .TP
67 .B /usr/local/plan9/plumb/basic
68 plumbing rules using
69 .I web
70 and
71 .I wmail
72 .SH SOURCE
73 .B /usr/local/plan9/bin
74 .SH SEE ALSO
75 .IR plumber (4)