sys/man/1/mothra

   1 .TH MOTHRA 1
   2 .SH NAME
   3 mothra \- retrieve World-Wide Web files
   4 .SH SYNOPSIS
   5 .B mothra
   6 [
   7 .B -m
   8 .I mtpt
   9 ] [
  10 .I url
  11 ]
  12 .SH DESCRIPTION
  13 .I Mothra
  14 retrieves and displays files from the World-Wide Web,
  15 by name or through hypertext links.
  16 Web names, called URLs, have a peculiar syntax:
  17 .IP
  18 .EX
  19 http://netlib.att.com/netlib/1127/www/1127.html
  20 http://akebono.stanford.edu:80/yahoo/
  21 http://www.teleport.com/~crowell/
  22 ftp://ftp.gmd.de/music/scores/harrington/Harrington.readme
  23 .EE
  24 .PP
  25 The part up to the first colon gives the protocol for
  26 retrieving the file.
  27 .BR http: ,
  28 Hyper-Text Transfer
  29 Protocol, is the usual way of accessing web files.
  30 .B ftp:
  31 and
  32 .B gopher:
  33 are standard Internet services.
  34 .PD
  35 .PP
  36 .B //
  37 begins the Internet address of the server where the file resides.
  38 The address may contain a colon and a TCP port
  39 number, which overrides the
  40 default port number for the service.  Next comes a
  41 file name.  Finally, the file name may be followed by
  42 .B #
  43 and a string giving a label within the file where the
  44 display should begin.
  45 .PP
  46 .I Mothra
  47 starts with the
  48 .I url
  49 given on the command line, defaulting to
  50 the environment variable
  51 .BR $url .
  52 .PP
  53 Mothra uses
  54 .IR webfs (4)
  55 to retrive the url data. The mountpoint, default is
  56 .B /mnt/web,
  57 can be changed with the
  58 .BR -b
  59 .I mtpt .
  60 .PP
  61 The display contains the last message from
  62 .I mothra,
  63 a box where typed commands appear,
  64 a scrollable list of previously visited files,
  65 the title and URL of the current file,
  66 and the scrollable text of the current file.
  67 .PP
  68 Button 1 selects and displays a file, either from the list
  69 of previously visited pages or from a link (indicated
  70 by underlined text or a boxed image) in the
  71 current file.  Button 2 shows the URL of a file,
  72 but does not retrieve or display it.
  73 Button 3 pops up a menu of commands:
  74 .TF alt\ display
  75 .TP
  76 .B alt display
  77 Collapse or expand the navigation boxes at the top of the browser window.
  78 .TP
  79 .B snarf url
  80 Copy the current URL to the snarf buffer.
  81 .TP
  82 .B paste
  83 Paste the current snarf buffer at the current cursor position.
  84 .TP
  85 .B save hit
  86 Save the current URL to the hit list.
  87 .TP
  88 .B hit list
  89 Retrieve and display the hit list.
  90 .TP
  91 .B exit
  92 Ask for confirmation and quit.
  93 .PD
  94 .PP
  95 The typed commands are:
  96 .TF typed\ commands
  97 .TP
  98 .B a
  99 Collapse or expand the navigation boxes at the top of the browser window.
 100 .TP
 101 .BI g " url
 102 Get the page with the given URL.
 103 .TP
 104 .B r
 105 Reload the current page.
 106 .TP
 107 .BI s " file
 108 Save the current page in the given
 109 .I file.
 110 .TP
 111 .BI W " file
 112 Capture a screenshot of the entire browser window in the given
 113 .I file.
 114 .TP
 115 .BI w " file
 116 Capture a screenshot of the content area in the given
 117 .I file.
 118 .TP
 119 .B q
 120 Quit.
 121 .PD
 122 .PP
 123 When
 124 .I mothra
 125 retrieves a file that is not an
 126 HTML document (for example a GIF or JPEG
 127 image), it will start up an appropriate viewer, for example
 128 .B fb/9v
 129 (see
 130 .IR 9v (9.1))
 131 for image files.
 132 .SH FILES
 133 .B $home/lib/mothra/hit.html
 134 the hit list
 135 .br
 136 .B $home/lib/mothra/mothra.url
 137 log of visited URLs
 138 .br
 139 .B $home/lib/mothra/mothra.err
 140 log of error messages, including HTML syntax errors
 141 .SH SOURCE
 142 .B /sys/src/cmd/mothra
 143 .SH "SEE ALSO"
 144 .IR webfs (4)
 145 .SH BUGS
 146 Files are saved in the form received,
 147 not in the form suggested by the name in an
 148 .B s
 149 command.
 150 .br
 151 .I Mothra
 152 is distributed in a preliminary state; it has more than its share of bugs.