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
49 .B camino ,
50 .B firefox ,
51 or
52 .BR safari .
53 .I Web
54 uses AppleScript to talk to the browser.
55 If 
56 .B $BROWSER
57 is not set,
58 .I web
59 looks for Firefox in
60 .BR /Applications/Firefox.app
61 and uses it if found;
62 otherwise it uses Safari.
63 .PP
64 .I Wmail
65 starts the composition of a new mail message to
66 .IR address .
67 .PP
68 The choice of mailer is determined by the 
69 .B $MAILER
70 environment variable.
71 The supported mailers are:
72 .TP
73 .B browser
74 invoke the mailer via a
75 .B mailto://
76 URL passed to
77 .I web
78 .PD
79 .PP
80 .I Web
81 and
82 .I wmail
83 are invoked as start commands in the
84 .MR plumber (4) 's
85 rules for opening web pages and writing mail messages.
86 .SH FILES
87 .TP
88 .B \*9/plumb/basic
89 plumbing rules using
90 .I web
91 and
92 .I wmail
93 .SH SOURCE
94 .B \*9/bin
95 .SH SEE ALSO
96 .MR plumber (4)