plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

web.1 (1802B)

      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)