| rsc | 058b011 | 2005-01-03 06:40:20 +0000 | [diff] [blame] | 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. |
| rsc | c8b6342 | 2005-01-13 04:49:19 +0000 | [diff] [blame] | 34 | The default is |
| 35 | .BR firefox . |
| rsc | 058b011 | 2005-01-03 06:40:20 +0000 | [diff] [blame] | 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 |
| rsc | c8b6342 | 2005-01-13 04:49:19 +0000 | [diff] [blame] | 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 |
| rsc | 058b011 | 2005-01-03 06:40:20 +0000 | [diff] [blame] | 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: |
| rsc | c8b6342 | 2005-01-13 04:49:19 +0000 | [diff] [blame] | 71 | .TP |
| 72 | .B browser |
| rsc | 058b011 | 2005-01-03 06:40:20 +0000 | [diff] [blame] | 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 |
| rsc | c3674de | 2005-01-11 17:37:33 +0000 | [diff] [blame] | 87 | .B \*9/plumb/basic |
| rsc | 058b011 | 2005-01-03 06:40:20 +0000 | [diff] [blame] | 88 | plumbing rules using |
| 89 | .I web |
| 90 | and |
| 91 | .I wmail |
| 92 | .SH SOURCE |
| rsc | c3674de | 2005-01-11 17:37:33 +0000 | [diff] [blame] | 93 | .B \*9/bin |
| rsc | 058b011 | 2005-01-03 06:40:20 +0000 | [diff] [blame] | 94 | .SH SEE ALSO |
| 95 | .IR plumber (4) |
