plan9fox/sys/man/1/mothra

.TH MOTHRA 1
.SH NAME
mothra \- retrieve and display World-Wide Web files
.SH SYNOPSIS
.B mothra
[
.B -m
.I mtpt
] [
.I url
]
.SH DESCRIPTION
.I Mothra
retrieves and displays files from the World-Wide Web,
by name or through hypertext links.
Web names, called URLs, have a peculiar syntax:
.IP
.EX
http://netlib.att.com/netlib/1127/www/1127.html
http://akebono.stanford.edu:80/yahoo/
http://www.teleport.com/~crowell/
ftp://ftp.gmd.de/music/scores/harrington/Harrington.readme
.EE
.PP
The part up to the first colon gives the protocol for
retrieving the file.
.BR http: ,
Hyper-Text Transfer
Protocol, is the usual way of accessing web files.
.B ftp:
and
.B gopher:
are standard Internet services.
.PD
.PP
.B //
begins the Internet address of the server where the file resides.
The address may contain a colon and a TCP port
number, which overrides the 
default port number for the service.  Next comes a
file name.  Finally, the file name may be followed by
.B #
and a string giving a label within the file where the
display should begin.
.PP
.I Mothra
starts with the
.I url
given on the command line, defaulting to
the environment variable
.BR $url .
.PP
There are a number of options:
.TP
.B  -d
Debug mode.
.TP
.B -v
Verbose mode. Causes HTML errors to appear in
.B $home/lib/mothra/mothra.err
.PP
Mothra uses
.IR webfs (4)
to retrive the URL data. The mountpoint, default is
.B /mnt/web,
can be changed with the
.BR -b
.I mtpt .
.PP
The display contains the last message from
.I mothra,
a box where typed commands appear,
a scrollable list of previously visited files,
the title and URL of the current file,
and the scrollable text of the current file.
.PP
Button 1 selects and displays a file, either from the list
of previously visited pages or from a link (indicated
by underlined text or a boxed image) in the
current file.  Button 2 shows the URL of a file,
but does not retrieve or display it.
Button 3 pops up a menu of commands:
.TF alt\ display
.TP
.B alt display
Collapse or expand the navigation boxes at the top of the browser window.
.TP
.B snarf url
Copy the current URL to the snarf buffer.
.TP
.B paste
Paste the current snarf buffer at the current cursor position.
.TP
.B save url
Save the currently selected URL as a file. Directory indexes are saved in a file named
.I index.
.TP
.B save hit
Save the current URL to the hit list.
.TP
.B hit list
Retrieve and display the hit list.
.TP
.B exit
Ask for confirmation and quit.
.PD
.PP
The typed commands are:
.TF typed\ commands
.TP
.B a
Collapse or expand the navigation boxes at the top of the browser window.
.TP
.BI g " url
Get the page with the given URL.
.TP
.BI j " n
Jump to page
.I n
from the list of previously viewed pages.
.TP
.B r
Reload the current page.
.TP
.BI s " file
Save the current page in the given
.I file.
.TP
.BI W " file
Capture a screenshot of the entire browser window in the given
.I file.
.TP
.BI w " file
Capture a screenshot of the content area in the given
.I file.
.TP
.B q
Quit.
.PD
.PP
When
.I mothra
retrieves a file that is not an
HTML document (for example a GIF or JPEG
image), it will start up an appropriate viewer, for example
.B page
(see
.IR page (1))
for most image files.
.SH FILES
.B $home/lib/mothra/hit.html 
the hit list
.br
.B $home/lib/mothra/mothra.url
log of visited URLs
.br
.B $home/lib/mothra/mothra.err
log of error messages, including HTML syntax errors
.SH SOURCE
.B /sys/src/cmd/mothra
.SH "SEE ALSO"
.IR webfs (4)
.SH BUGS
Files are saved in the form received,
not in the form suggested by the name in an
.B s
command.
.br
.I Mothra
is distributed in a preliminary state; it has more than its share of bugs.