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 save\ back
  97 .TP
  98 .BI g " url
  99 Get the page with the given URL.
 100 .TP
 101 .B r
 102 Reload the current page.
 103 .TP
 104 .BI s " file
 105 Save the current page in the given
 106 .I file.
 107 .TP
 108 .BI W " file
 109 Capture a screenshot of the entire browser window in the given
 110 .I file.
 111 .TP
 112 .BI w " file
 113 Capture a screenshot of the content area in the given
 114 .I file.
 115 .TP
 116 .B q
 117 Quit.
 118 .PD
 119 .PP
 120 When
 121 .I mothra
 122 retrieves a file that is not an
 123 HTML document (for example a GIF or JPEG
 124 image), it will start up an appropriate viewer, for example
 125 .B fb/9v
 126 (see
 127 .IR 9v (9.1))
 128 for image files.
 129 .SH FILES
 130 .B $home/lib/mothra/hit.html
 131 the hit list
 132 .br
 133 .B $home/lib/mothra/mothra.url
 134 log of visited URLs
 135 .br
 136 .B $home/lib/mothra/mothra.err
 137 log of error messages, including HTML syntax errors
 138 .SH SOURCE
 139 .B /sys/src/cmd/mothra
 140 .SH "SEE ALSO"
 141 .IR webfs (4)
 142 .SH BUGS
 143 Files are saved in the form received,
 144 not in the form suggested by the name in an
 145 .B s
 146 command.
 147 .br
 148 .I Mothra
 149 is distributed in a preliminary state; it has more than its share of bugs.