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 The default is
35 .BR firefox .
36 Since the various browsers all use different syntaxes
37 in their
38 .B -remote
39 options, the executable name is inspected to determine
40 the type of browser.
41 The supported browsers are Opera, Mozilla Firefox, Mozilla Firebird, and Mozilla.
42 When possible,
43 .I web
44 opens each URL in a new tab rather than a new window.
45 .PP
46 When run under Mac OS X,
47 .B $BROWSER
48 should be set to the string
49 .B safari
50 or
51 .BR firefox .
52 .I Web
53 uses AppleScript to talk to the browser.
54 If 
55 .B $BROWSER
56 is not set,
57 .I web
58 looks for Firefox in
59 .BR /Applications/Firefox.app
60 and uses it if found;
61 otherwise it uses Safari.
62 .PP
63 .I Wmail
64 starts the composition of a new mail message to
65 .IR address .
66 .PP
67 The choice of mailer is determined by the 
68 .B $MAILER
69 environment variable.
70 The supported mailers are:
71 .TP
72 .B browser
73 invoke the mailer via a
74 .B mailto://
75 URL passed to
76 .I web
77 .PD
78 .PP
79 .I Web
80 and
81 .I wmail
82 are invoked as start commands in the
83 .IR plumber (4)'s
84 rules for opening web pages and writing mail messages.
85 .SH FILES
86 .TP
87 .B \*9/plumb/basic
88 plumbing rules using
89 .I web
90 and
91 .I wmail
92 .SH SOURCE
93 .B \*9/bin
94 .SH SEE ALSO
95 .IR plumber (4)